Laravel でやってみるクリーンアーキテクチャ #phpconfuk

Laravel
PHP Conference Fukuoka 2019
@okashoi WILLGATE, Inc.

•
• 🙆
•
• #phpconfuk #hall_fu
2

• 2
• 3
• 5
• 10
• 3
• 2
3

• 2
• 3
• 5
• 10
• 3
• 2
4

🏁
•
•
• Laravel
 
5

• 2
• 3
• 5
• 10
• 3
• 2
7

”The Clean Architecture - The Clean Code Blog”,
https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html
9

• 2
• 3
• 5
• 10
• 3
• 2
13

package foo;
import bar;
class Foo {
bar.Bar x;
function doFoo() {
x.process();
}
}
23
package bar;
class Bar {
function process() {
// do something...
}
}

package foo;
import bar;
class Foo {
bar.Bar x;
function doFoo() {
x.process();
}
}
24
package bar;
class Bar {
// do something...
}
}
foo bar = foo → bar

package foo;
import bar;
class Foo {
bar.Bar x;
function doFoo() {
x.process();
}
}
25
package bar;
class Bar {
// do something...
}
}

package foo;
import bar;
class Foo {
bar.Bar x;
function doFoo() {
x.process();
}
}
26
package bar;
class Bar {
// do something...
}
}
foo → bar
foo → bar

package foo;
class Foo {
Buz x;
function doFoo() {
x.process();
}
}
interface Buz {
function process();
}
27
package bar;
import foo;
class Bar implements foo.Buz {
// do something...
}
}

package foo;
class Foo {
Buz x;
function doFoo() {
x.process();
}
}
interface Buz {
function process();
}
28
package bar;
import foo;
// do something...
}
}

package foo;
class Foo {
Buz x;
function doFoo() {
x.process();
}
}
interface Buz {
function process();
}
29
package bar;
import foo;
// do something...
}
}

package foo;
class Foo {
Buz x;
function doFoo() {
x.process();
}
}
interface Buz {
function process();
}
30
package bar;
import foo;
// do something...
}
}
bar foo = foo ← bar

package foo;
class Foo {
Buz x;
function doFoo() {
x.process();
}
}
interface Buz {
function process();
}
31
package bar;
import foo;
// do something...
}
}
foo → bar
foo ← bar

• 2
• 3
• 5
• 10
• 3
• 2
35

CleanArchitecture
Clean Architecture
Kindle No. 3228/6016 36

•
• https://github.com/okashoi/laravel-clean-
architecture
•
•
37

•
•
• POPO Plain Old PHP Object
➡
41

• PHP
42
<?php
namespace MyAppComponentsTasksEntities;
use DatetimeImmutable;
/**
* Class Inbox
* @package MyAppComponentsTasksEntities
*/
final class Inbox extends Task
{
/**
* @var EstimatedTime|null
*/
private $estimatedTime;

•
•
43
/**
* @test
* @expectedException MyAppComponentsTasksEntitiesEstimatedTimeNotSet
*/
public function 「Inbox」に対して「見積もり時間」が未設定のまま「着手日」を設定できないこと()
{
$id = Mockery::mock(Id::class);
$name = new Name('test');
$inbox = new Inbox($id, $name);
$startDate = new StartDate(new DateTimeImmutable('tomorrow'));
$inbox->convertToScheduled($startDate);
}

InputBoundary / OutputBoundary
•  
47
<?php
namespace MyAppComponentsTasksUseCasesCreateInbox;
/**
* Interface InputBoundary
* @package MyAppComponentsTasksUseCasesCreateInbox
*/
interface InputBoundary
{
/**
* @param InputData $input
*/
public function __invoke(InputData $input): void;
}

InputBoundary / OutputBoundary
•  
48
<?php
/**
* Interface NormalOutputBoundary
*/
interface NormalOutputBoundary
{
/**
* @param NormalOutputData $output
*/
public function __invoke(NormalOutputData $output): void;
}

Interactor
49
<?php
use MyAppComponentsTasksEntities{Inbox, Task, Name, Note};
use MyAppComponentsTasksUseCases{IdProvider, TaskRepository};
/**
* Class Interactor
*/
final class Interactor implements InputBoundary
{
/**
* @var IdProvider
*/
private $idProvider;
/**
* @var TaskRepository
*/
private $taskRepository;
/**
* @var NormalOutputBoundary
*/
private $normalOutputBoundary;
/**
* Interactor constructor.
* @param IdProvider $idProvider
* @param TaskRepository $taskRepository
* @param NormalOutputBoundary $normalOutputBoundary
*/
public function __construct(IdProvider $idProvider, TaskRepository $t
{
$this->idProvider = $idProvider;
$this->taskRepository = $taskRepository;
$this->normalOutputBoundary = $normalOutputBoundary;
}
/**
*/
public function __invoke(InputData $input): void
{
$inbox = $this->produceEntity($input);
$this->taskRepository->save($inbox);
$normalOutput = $this->produceNormalOutputData($inbox);
($this->normalOutputBoundary)($normalOutput);
}
/**
* @return Task

Interactor
50
<?php
/**
* Class Interactor
*/
{
/**
* @var IdProvider
*/
/**
*/
/**
*/
/**
*/
{
}
/**
*/
{
}
/**
* @return Task
InputBoundary

Interactor
51
<?php
/**
* Class Interactor
*/
{
/**
* @var IdProvider
*/
/**
*/
/**
*/
/**
*/
{
}
/**
*/
{
}
/**
* @return Task
DI
※

Interactor
52
<?php
/**
* Class Interactor
*/
{
/**
* @var IdProvider
*/
/**
*/
/**
*/
/**
*/
{
}
/**
*/
{
}
/**
* @return Task

Interactor::__invoke()
 
53
/**
*/
{
}

 
54
/**
*/
{
}

 
55
/**
*/
{
}

OutputBoundary  
56
/**
*/
{
}

•
• Repository
• 🙆
• Eloquent
58

Web UI
•
• Controller  
void
•  
60

Controller
61
<?php
namespace MyAppWebControllers;
use IlluminateHttpRequest;
use MyAppComponentsTasksUseCasesCreateInboxInputData;
use MyAppComponentsTasksUseCasesCreateInboxInputBoundary;
/**
* Class CreateInbox
* @package MyAppWebControllers
*/
final class CreateInbox extends Controller
{
/**
* @param Request $request
* @param InputBoundary $interactor
*/
public function __invoke(Request $request, InputBoundary $interactor)
{
$validated = $this->validate($request, [
'name' => 'required|string|max:255',
'note' => 'string|nullable',
]);
$input = new InputData($validated['name'], $validated['note'] ?? '');
$interactor($input);
}
}

Controller
62
<?php
/**
* Class CreateInbox
*/
{
/**
*/
{
]);
}
}
Laravel HttpControllers

Controller
63
<?php
/**
* Class CreateInbox
*/
{
/**
*/
{
]);
}
}
HTTP

Controller
64
<?php
/**
* Class CreateInbox
*/
{
/**
*/
{
]);
}
}
InputBoundary Interactor

Controller
65
<?php
/**
* Class CreateInbox
*/
{
/**
*/
{
]);
}
}

Presenter
•
66
<?php
namespace MyAppWebPresentersCreateInbox;
use IlluminateViewFactory;
use MyAppWebPresentersPresenter as BasePresenter;
use MyAppComponentsTasksUseCasesCreateInboxNormalOutputData;
use MyAppComponentsTasksUseCasesCreateInboxNormalOutputBoundary;
/**
* Class CreateInboxPresenter
* @package MyAppWebPresenters
*/
final class Presenter extends BasePresenter implements NormalOutputBoundary
{
// 中略
/**
*/
public function __invoke(NormalOutputData $output): void
{
$viewModel = new ViewModel(
$output->taskId(),
$output->taskName(),
$output->taskNote(),
);
$this->respond($this->view->make('web::tasks.create', compact(['viewModel'])));
}
}

Presenter
•
67
<?php
/**
*/
{
// 中略
/**
*/
{
$output->taskId(),
);
}
}
Interactor ViewModel

Presenter
•
68
<?php
/**
*/
{
// 中略
/**
*/
{
$output->taskId(),
);
}
}
View
※ Controller  
void ……🙇

70
<?php
namespace AppProviders;
use IlluminateSupportServiceProvider;
use MyAppComponentsTasksUseCasesCreateInboxInteractor;
use MyAppComponentsTasksUseCasesIdProvider;
use MyAppComponentsTasksUseCasesTaskRepository as TaskRepositoryInterface;
use MyAppDatabaseRepositoriesAutoIncrementTaskIdProvider;
use MyAppDatabaseRepositoriesTaskRepository;
use MyAppWebPresentersCreateInboxPresenter;
class AppServiceProvider extends ServiceProvider
{
/**
* Register any application services.
*
* @return void
*/
public function register()
{
$this->app->bind(IdProvider::class, AutoIncrementTaskIdProvider::class);
$this->app->bind(TaskRepositoryInterface::class, TaskRepository::class);
$this->app->bind(InputBoundary::class, Interactor::class);
$this->app->bind(NormalOutputBoundary::class, Presenter::class);
}
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
//
}
}

Laravel
• Laravel
• DI ServiceContainer
•  
ServiceProvider
•  
71

@Laravel JP Conference 2019
https://speakerdeck.com/mikakane/laravel-package-
development 72

• 2
• 3
• 5
• 10
• 3
• 2
78

package foo;
class Foo {
Buz x;
function doFoo() {
x.process();
}
}
interface Buz {
function process();
}
80
package bar;
import foo;
// do something...
}
}

🏁
•
•
• Laravel
 
81

• 2
• 3
• 5
• 10
• 3
• 2
82

• Laravel JP Conference 2020
86https://conference2020.laravel.jp/

Laravel でやってみるクリーンアーキテクチャ #phpconfuk

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Laravel でやってみるクリーンアーキテクチャ #phpconfuk

Similar to Laravel でやってみるクリーンアーキテクチャ #phpconfuk (20)

More from Shohei Okada

More from Shohei Okada (20)

Recently uploaded

Recently uploaded (20)

Laravel でやってみるクリーンアーキテクチャ #phpconfuk