The document discusses clean architecture principles and their application to Laravel PHP framework development. It describes how to separate an application into independent layers including entities, use cases, interfaces, and data access objects. It provides code examples of implementing repositories and dependency injection using Laravel service providers to adhere to clean architecture and dependency rules. The goal is to build maintainable and testable applications by decoupling layers and controlling dependencies between them.

1. Laravel
PHP Conference Hokkaido 2019
@okashoi WILLGATE, Inc.

2. •
• 🙆
•
• #phpcondo
2

3. • 2
• 3
• 5
• Laravel 10
• 3
• 2
3

4. • 2
• 3
• 5
• Laravel 10
• 3
• 2
4

5. • 2
• 3
• 5
• Laravel 10
• 3
• 2
5

6. • 2
• 3
• 5
• Laravel 10
• 3
• 2
6

7. • 2
• 3
• 5
• Laravel 10
• 3
• 2
7

8. • 2
• 3
• 5
• Laravel 10
• 3
• 2
8

9. 🏁
•
• Laravel
9

10. 🙅
•
• Laravel
•
10

11. • 2
• 3
• 5
• Laravel 10
• 3
• 2
11

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

13. 13
2017 2018

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

15. •
•
•
15

16. •
•
•
※ PHP
16

17. “
”
17

18. • 2
• 3
• 5
• Laravel 10
• 3
• 2
18

19. 19

20. 20

21. 21
🙅

22. 22

23. 23

24. • Enterprise Business Rules
•
•
• Application Business Rules
•
24

25. https://little-hands.hatenablog.com/entry/2019/07/26/
domain-knowledge 25

26. 26

27. 27
↑

28. 28

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

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

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

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

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

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

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

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

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

38. =
38

39. “
”
39

40. •
➡
40

41. 41
UI

42. • 2
• 3
• 5
• Laravel 10
• 3
• 2
42

43. Laravel
• DI
• Eloquent
43

44. Laravel
•
Service Provider
• Laravel
44

45. Laravel
•
Service Provider
• Laravel
45

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

47. 47
packages

48. Service Provider
•
•
• =
• =
48

49. Service Provider
49
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);
}

50. Service Container
50
/**
* Interactor constructor.
* @param IdProvider $idProvider
* @param TaskRepository $taskRepository
* @param NormalOutputBoundary $normalOutputBoundary
*/
public function __construct(IdProvider $idProvider, TaskRepository $taskRepository, …
{
$this->idProvider = $idProvider;
$this->taskRepository = $taskRepository;
$this->normalOutputBoundary = $normalOutputBoundary;
}

51. Laravel
•
Service Provider
• Laravel
51

52. Clean Architecture
Clean Architecture
Kindle No. 3228/6016 52

53. 53

54. 54

55. •
•
ID
55

56. •
•
• POPO Plain Old PHP Object
➡
56

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

58. 58

59. 59

60. •
•
•
60

61. 61
<?php
namespace MyAppComponentsCreateInboxUseCase;
use MyAppEntitiesTask{Task, Id};
/**
* Interface TaskRepository
* @package MyAppComponentsCreateInboxUseCase
*/
interface TaskRepository
{
/**
* 与えられたタスクを永続化する
*
* @param Task $task
*/
public function save(Task $task): void;

62. 62

63. Web UI
63

64. Web UI
64

65. Web UI
•
• 🙆
• Eloquent
65

66. <?php
namespace MyAppComponentsCreateInboxDataAccessDatabaseRepositories;
// 略
/**
* Class TaskRepository
* @package MyAppComponentsCreateInboxDataAccessDatabaseRepositories
*/
class TaskRepository implements TaskRepositoryInterface
{
/**
* 与えられたタスクを永続化する
*
* @param Task $task
*/
public function save(Task $task): void
{
$taskRecord = EloquentsTask::create([
'name' => $task->name()->value(),
'note' => $task->note()->value(),
]);
66

67. <?php
namespace MyAppComponentsCreateInboxDataAccessDatabaseRepositories;
// 略
/**
* Class TaskRepository
* @package MyAppComponentsCreateInboxDataAccessDatabaseRepositories
*/
class TaskRepository implements TaskRepositoryInterface
{
/**
* 与えられたタスクを永続化する
*
* @param Task $task
*/
public function save(Task $task): void
{
$taskRecord = EloquentsTask::create([
'name' => $task->name()->value(),
'note' => $task->note()->value(),
]);
Eloquent
67

68. “
”
68

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

70. • 2
• 3
• 5
• Laravel 10
• 3
• 2
70

71. 71
UI

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

73. Laravel
•
Service Provider
• Laravel
73

74. • 2
• 3
• 5
• 10
• 3
• 2
74

75. /
@okashoi
@okashoi
75

76. • Hacker’s GATE
76

77. • Oysters
77

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

79. /
@okashoi
@okashoi
79
😄