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

ドメイン駆動設計やユースケース駆動開発などの文脈でレイヤードアーキテクチャやクリーンアーキテクチャといった言葉をよく聞くようになりました。
「名前は聞いたことあるけど、敷居が高そう......」「本は読んだけど実際に実装するイメージがつかない......」そんなことを感じている方もいらっしゃるのではないでしょうか？
本トークではそんな方に向けて、簡単なアプリケーションの実装例とともに、クリーンアーキテクチャの考え方や実装する上での Laravel の機能についてお話します！

2018/06/29 開催の PHP カンファレンス福岡2019 (https://phpcon.fukuoka.jp/2019/) の発表資料です。

Transcript

1. Laravel Ͱ΍ͬͯΈΔ ΫϦʔϯΞʔΩςΫνϟ PHP Conference Fukuoka 2019 @okashoi WILLGATE, Inc.
2. ͸͡Ίʹ • εϥΠυ͸ެ։ࡁΈͰ͢ • ࣸਅ౳΋׻ܴͰ͢ 🙆 • ײ૝ɾϑΟʔυόοΫ౳͓଴͍ͪͯ͠·͢ʂ • ϋογϡλά #phpconfuk #hall_fu 2
3. ໨࣍ • ͜ͷτʔΫͷΊ͟͢ͱ͜Ζʢ2 ෼ʣ • ΫϦʔϯΞʔΩςΫνϟͷ֓ཁʢ3 ෼ʣ • ίΞͱͳΔߟ͑ํʢ5 ෼ʣ • ۩ମతͳίʔυྫʢ10 ෼ʣ • ·ͱΊʢ3 ෼ʣ • ࣗݾ঺հʢ2 ෼ʣ 3
4. ໨࣍ • ͜ͷτʔΫͷΊ͟͢ͱ͜Ζʢ2 ෼ʣ • ΫϦʔϯΞʔΩςΫνϟͷ֓ཁʢ3 ෼ʣ • ίΞͱͳΔߟ͑ํʢ5 ෼ʣ • ۩ମతͳίʔυྫʢ10 ෼ʣ • ·ͱΊʢ3 ෼ʣ • ࣗݾ঺հʢ2 ෼ʣ 4
5. ͜ͷτʔΫͷΊ͟͢ͱ͜Ζ🏁 • ΫϦʔϯΞʔΩςΫνϟͷίΞͱͳΔߟ͑ํ • ͦΕΛ࣮ݱ͢ΔͨΊͷ۩ମతͳίʔσΟϯά • ͦΕΒΛ࣮ફ͢Δ্Ͱͷ Laravel ͱͷ෇͖߹͍ํ ͜ΕΒΛ஌ͬͯ΋Β͍ɺͦͷҰ෦෼͚ͩͰ΋
 ͜Ε͔Βͷ։ൃʹ׆͔ͯ͠΋Β͏ 5
6. ͜ͷτʔΫͰ࿩͞ͳ͍͜ͱ🙅 • Laravel ͷػೳͷղઆ • ʰΫϦʔϯΞʔΩςΫνϟʱʹग़ͯ͘Δ֓೦ ͷৄࡉͳղઆ 6
7. ໨࣍ • ͜ͷτʔΫͷΊ͟͢ͱ͜Ζʢ2 ෼ʣ • ΫϦʔϯΞʔΩςΫνϟͷ֓ཁʢ3 ෼ʣ • ίΞͱͳΔߟ͑ํʢ5 ෼ʣ • ۩ମతͳίʔυྫʢ10 ෼ʣ • ·ͱΊʢ3 ෼ʣ • ࣗݾ঺հʢ2 ෼ʣ 7
8. ݪయ 8 2017 ೥ॳ൛ൃߦ 2018 ೥ॳ൛ൃߦ
9. ΫϦʔϯΞʔΩςΫνϟͷਤ ग़యɿ”The Clean Architecture - The Clean Code Blog”, https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html 9
10. ΫϦʔϯΞʔΩςΫνϟͷਤ • ΫϦʔϯΞʔΩςΫνϟʹ͍ͭͯௐ΂Δͱ
 ·ͣ໨ʹ͢Δਤ • ຊτʔΫͰ͸֤૚ͷৄࡉͳղઆ͸͠ͳ͍ • ͜ͷਤʹ஧࣮ʹ࣮૷͑͢͞Ε͹Α͍ɺͱ͍͏ Θ͚Ͱ͸ͳ͍ 10
11. ԿΛ໨తͱ͍ͯ͠Δ͔ʁ • ಠཱ։ൃՄೳ • ಠཱσϓϩΠՄೳʢ˞ʣ • ςετՄೳ ※ PHP ։ൃʹ͓͍ͯ͸Πϝʔδ͠ʹ͍͔͘΋ 11
12. “ιϑτ΢ΣΞΞʔΩςΫνϟͷ໨త͸ɺ
 ٻΊΒΕΔγεςϜΛߏஙɾอक͢ΔͨΊʹ ඞཁͳਓࡐΛ࠷খݶʹ཈͑Δ͜ͱͰ͋Δɻ” 12
13. ໨࣍ • ͜ͷτʔΫͷΊ͟͢ͱ͜Ζʢ2 ෼ʣ • ΫϦʔϯΞʔΩςΫνϟͷ֓ཁʢ3 ෼ʣ • ίΞͱͳΔߟ͑ํʢ5 ෼ʣ • ۩ମతͳίʔυྫʢ10 ෼ʣ • ·ͱΊʢ3 ෼ʣ • ࣗݾ঺հʢ2 ෼ʣ 13
14. ίΞͱͳΔߟ͑ํ ʮॏཁͳ΋ͷʯΛʮࠣࡉͳ΋ͷʯʹґଘͤ͞ͳ͍ 14
15. ॏཁͳ΋ͷʁ 15 σʔλϕʔε ϑϨʔϜϫʔΫ ςετ 6* 8FC 03.
16. ॏཁͳ΋ͷʁ 16 σʔλϕʔε ϑϨʔϜϫʔΫ ςετ 6* 8FC 03. 🙅 ⾠͋͘·ͰΫϦʔϯΞʔΩςΫνϟͷจ຺ͷ࿩
17. ॏཁͳ΋ͷʁ ॏཁͳ΋ͷ͸ʮϏδωεϧʔϧʯ 17
18. ΫϦʔϯΞʔΩςΫνϟͷਤ 18
19. ॏཁͳ΋ͷʁ ॏཁͳ΋ͷ͸ʮϏδωεϧʔϧʯ • ΤϯςΟςΟ • ࠷ॏཁϏδωεϧʔϧ • Ϣʔεέʔε • ΞϓϦέʔγϣϯݻ༗ͷϏδωεϧʔϧ 19
20. ίΞͱͳΔߟ͑ํ ʮॏཁͳ΋ͷʯΛʮࠣࡉͳ΋ͷʯʹґଘͤ͞ͳ͍ 20
21. ίΞͱͳΔߟ͑ํ ʮॏཁͳ΋ͷʯΛʮࠣࡉͳ΋ͷʯʹґଘͤ͞ͳ͍ 21 ɹɹ ↑ Ͳ͏΍ͬͯʁ
22. ґଘؔ܎ٯస 22
23. యܕతͳґଘؔ܎ͷίʔυ package foo; import bar; class Foo { bar.Bar x; function doFoo() { x.process(); } } 23 package bar; class Bar { function process() { // do something... } }
24. యܕతͳґଘؔ܎ͷίʔυ package foo; import bar; class Foo { bar.Bar x; function doFoo() { x.process(); } } 24 package bar; class Bar { function process() { // do something... } } foo ͔Β bar ͷॲཧΛݺͼग़͢ = ॲཧͷํ޲ foo → bar
25. యܕతͳґଘؔ܎ͷίʔυ package foo; import bar; class Foo { bar.Bar x; function doFoo() { x.process(); } } 25 package bar; class Bar { function process() { // do something... } } foo ͕ bar ͷ͜ͱΛ஌͍ͬͯΔ = ґଘͷํ޲ foo → bar
26. యܕతͳґଘؔ܎ͷίʔυ package foo; import bar; class Foo { bar.Bar x; function doFoo() { x.process(); } } 26 package bar; class Bar { function process() { // do something... } } ॲཧͷํ޲ foo → bar ґଘͷํ޲ foo → bar
27. ґଘؔ܎ٯసͨ͠ίʔυ package foo; class Foo { Buz x; function doFoo() { x.process(); } } interface Buz { function process(); } 27 package bar; import foo; class Bar implements foo.Buz { function process() { // do something... } }
28. ґଘؔ܎ٯసͨ͠ίʔυ package foo; class Foo { Buz x; function doFoo() { x.process(); } } interface Buz { function process(); } 28 package bar; import foo; class Bar implements foo.Buz { function process() { // do something... } }
29. ґଘؔ܎ٯసͨ͠ίʔυ package foo; class Foo { Buz x; function doFoo() { x.process(); } } interface Buz { function process(); } 29 package bar; import foo; class Bar implements foo.Buz { function process() { // do something... } } foo ͔Β bar ͷॲཧΛݺͼग़͢ = ॲཧͷํ޲ foo → bar
30. ґଘؔ܎ٯసͨ͠ίʔυ package foo; class Foo { Buz x; function doFoo() { x.process(); } } interface Buz { function process(); } 30 package bar; import foo; class Bar implements foo.Buz { function process() { // do something... } } bar ͕ foo ͷ͜ͱΛ஌͍ͬͯΔ = ґଘͷํ޲ foo ← bar
31. ґଘؔ܎ٯసͨ͠ίʔυ package foo; class Foo { Buz x; function doFoo() { x.process(); } } interface Buz { function process(); } 31 package bar; import foo; class Bar implements foo.Buz { function process() { // do something... } } ॲཧͷํ޲ foo → bar ґଘͷํ޲ foo ← bar
32. “ιϑτ΢ΣΞΞʔΩςΫτ͸ɺ
 γεςϜʹ͋Δ͢΂ͯͷιʔείʔυͷ
 ґଘؔ܎ͷํ޲Λઈରతʹ੍ޚͰ͖Δ” 32
33. Կ͕خ͍͠ͷ͔ʁ • Ұൠ࿦ͱͯ͠ɺԿ͔Λมߋͨ͠ͱ͖
 ͦΕʹґଘ͍ͯ͠Δ΋ͷશͯʹӨڹ͕ٴͿ ➡ มߋ͞Εʹ͍͘΋ͷʹґଘ͢ΔΑ͏ʹ
 ઃܭ͢Δ͜ͱͰӨڹΛখ͘͞ཹΊΒΕΔ 33
34. ίΞͱͳΔߟ͑ํ ʮॏཁͳ΋ͷʯΛʮࠣࡉͳ΋ͷʯʹґଘͤ͞ͳ͍ 34 σʔλϕʔεɾ UIɾϑϨʔϜϫʔΫͳͲ ༰қʹมߋͰ͖Δ Ϗδωεϧʔϧ มߋ͕ى͜Γʹ͍͘
35. ໨࣍ • ͜ͷτʔΫͷΊ͟͢ͱ͜Ζʢ2 ෼ʣ • ΫϦʔϯΞʔΩςΫνϟͷ֓ཁʢ3 ෼ʣ • ίΞͱͳΔߟ͑ํʢ5 ෼ʣ • ۩ମతͳίʔυྫʢ10 ෼ʣ • ·ͱΊʢ3 ෼ʣ • ࣗݾ঺հʢ2 ෼ʣ 35
36. CleanArchitecture ΋͏ͻͱͭͷਤ ग़యɿʰClean Architecture ୡਓʹֶͿιϑτ΢ΣΞͷߏ଄ͱઃܭʱ ʢKindle ൛ɺ ҐஔNo. 3228/6016ʣ 36
37. αϯϓϧɿλεΫ؅ཧπʔϧ • ԼهϦϙδτϦͰ։ൃத • https://github.com/okashoi/laravel-clean- architecture • ͋͘·ͰʮҰྫʯͰ͋Δ͜ͱʹཹҙ • ͜ͷܗ͕ઈରతͳ౴͑Ͱ͸ͳ͍ 37
38. ΤϯςΟςΟ 38
39. ·ͣ͸ϏδωεϧʔϧΛநग़ • ʮ࢖͍ํʯʹґΒͳ͍ϧʔϧΛݟग़͢ • ػೳҰཡͰ͸ͳ͍ ʮλεΫΛ࡞੒Ͱ͖ΔʯʮλεΫ໊ΛมߋͰ͖Δʯ ʮλεΫ͸ඞͣλεΫIDͱλεΫ໊Λ࣋ͭʯ
 ɹʮணख೔ʹաڈͷ೔෇ΛೳಈతʹઃఆͰ͖ͳ͍ʯ 39
40. ࣗવݴޠʹىͯ͜͠ readme ʹॻ͍ͨ 40
41. ΤϯςΟςΟͷ࣮૷ • நग़ͨ͠ϏδωεϧʔϧΛ࣮૷Ͱදݱ͢Δ • ϑϨʔϜϫʔΫ΍σʔλϕʔε౳ʹґଘͤ͞ͳ͍ • POPOʢPlain Old PHP ObjectʣͰॻ͘ ➡ ґଘ͢Δ΋ͷ͕ແ͍ͷͰಠཱͯ͠։ൃՄೳ 41
42. ϑϨʔϜϫʔΫʹґଘͤ͞ͳ͍ • ґଘͤ͞Δͷ͸ PHP ૊ΈࠐΈͷΫϥεఔ౓ 42 <?php namespace MyApp\Components\Tasks\Entities; use DatetimeImmutable; /** * Class Inbox * @package MyApp\Components\Tasks\Entities */ final class Inbox extends Task { /** * @var EstimatedTime|null */ private $estimatedTime;
43. Ϣχοτςετ • ґଘͷແ͍७ਮͳϩδοΫͳͷͰॻ͖΍͍͢ • நग़ͨ͠Ϗδωεϧʔϧͷจݴ͕ͦͷ··ς ετέʔεʹͳΔ 43 /** * @test * @expectedException \MyApp\Components\Tasks\Entities\EstimatedTimeNotSet */ 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); }
44. Ϣʔεέʔε 44
45. Ϣʔεέʔε 45
46. Ϣʔεέʔεͷ࣮૷ • ΞϓϦέʔγϣϯݻ༗ͷϏδωεϧʔϧ • ೖग़ྗͱΤϯςΟςΟΛഔհ͢Δ
 ʮૢ࡞ʯͷΠϝʔδ • ೖग़ྗͷσʔλ͸ഔମ΍σʔλϕʔεʹ
 ґଘ͠ͳ͍ܗʹ͢Δ 46
47. InputBoundary / OutputBoundary • ೖྗʢग़ྗʣσʔλΛҾ਺ʹऔΔ
 ݺͼग़͠ՄೳͳΠϯλʔϑΣʔε 47 <?php namespace MyApp\Components\Tasks\UseCases\CreateInbox; /** * Interface InputBoundary * @package MyApp\Components\Tasks\UseCases\CreateInbox */ interface InputBoundary { /** * @param InputData $input */ public function __invoke(InputData $input): void; }
48. InputBoundary / OutputBoundary • ೖྗʢग़ྗʣσʔλΛҾ਺ʹऔΔ
 ݺͼग़͠ՄೳͳΠϯλʔϑΣʔε 48 <?php namespace MyApp\Components\Tasks\UseCases\CreateInbox; /** * Interface NormalOutputBoundary * @package MyApp\Components\Tasks\UseCases\CreateInbox */ interface NormalOutputBoundary { /** * @param NormalOutputData $output */ public function __invoke(NormalOutputData $output): void; }
49. Interactor 49 <?php namespace MyApp\Components\Tasks\UseCases\CreateInbox; use MyApp\Components\Tasks\Entities\{Inbox, Task, Name, Note}; use MyApp\Components\Tasks\UseCases\{IdProvider, TaskRepository}; /** * Class Interactor * @package MyApp\Components\Tasks\UseCases\CreateInbox */ 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; } /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); } /** * @param InputData $input * @return Task
50. Interactor 50 <?php namespace MyApp\Components\Tasks\UseCases\CreateInbox; use MyApp\Components\Tasks\Entities\{Inbox, Task, Name, Note}; use MyApp\Components\Tasks\UseCases\{IdProvider, TaskRepository}; /** * Class Interactor * @package MyApp\Components\Tasks\UseCases\CreateInbox */ 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; } /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); } /** * @param InputData $input * @return Task InputBoundary ͷ࣮૷
51. Interactor 51 <?php namespace MyApp\Components\Tasks\UseCases\CreateInbox; use MyApp\Components\Tasks\Entities\{Inbox, Task, Name, Note}; use MyApp\Components\Tasks\UseCases\{IdProvider, TaskRepository}; /** * Class Interactor * @package MyApp\Components\Tasks\UseCases\CreateInbox */ 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; } /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); } /** * @param InputData $input * @return Task ґଘੑ͸֎෦͔Β஫ೖʢDIʣ ※ґଘͯ͠Δ΋ͷΛϞοΫԽͯ͠
 ɹςετ͕ॻ͖΍͍͢
52. Interactor 52 <?php namespace MyApp\Components\Tasks\UseCases\CreateInbox; use MyApp\Components\Tasks\Entities\{Inbox, Task, Name, Note}; use MyApp\Components\Tasks\UseCases\{IdProvider, TaskRepository}; /** * Class Interactor * @package MyApp\Components\Tasks\UseCases\CreateInbox */ 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; } /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); } /** * @param InputData $input * @return Task ॲཧຊମ
 ʢ࣍εϥΠυʹղઆଓ͘ʣ
53. Interactor::__invoke() ೖྗσʔλ͔Β
 λεΫΛੜ੒ 53 /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); }
54. Interactor::__invoke() ੜ੒ͨ͠λεΫΛ
 ӬଓԽ 54 /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); }
55. Interactor::__invoke() ॲཧ݁Ռ͔Β
 ग़ྗσʔλΛੜ੒ 55 /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); }
56. Interactor::__invoke() OutputBoundary Λ
 ݺͼग़͠ 56 /** * @param InputData $input */ public function __invoke(InputData $input): void { $inbox = $this->produceEntity($input); $this->taskRepository->save($inbox); $normalOutput = $this->produceNormalOutputData($inbox); ($this->normalOutputBoundary)($normalOutput); }
57. σʔλϕʔε 57
58. σʔλϕʔε • ϢʔεέʔεͰఆٛͨ͠ΠϯλʔϑΣʔεΛ࣮૷ • Repository ύλʔϯΛ࢖͏ͷΛΑ͘ݟΔ • ͜ͷ͋ͨΓ͸ϑϨʔϜϫʔΫʹґଘͤͯ͞΋🙆 • Eloquent Λ࢖͏ͳΒ͜͜Ͱ࢖͏ 58
59. WebʗUI 59
60. WebʗUI • ϢʔεέʔεͰఆٛͨ͠ΠϯλʔϑΣʔεΛ࣮૷ • ਤʹ஧࣮ʹ΍ΔͳΒ Controller ϝιουͷ
 ໭Γ஋͸ void • ͕ɺ͜ͷܗʹ͸ͦ͜·Ͱͩ͜ΘΒͳͯ͘Α͍
 ʢมଇతͳΧελϚΠζ͕ඞཁʹͳΔʣ 60
61. Controller 61 <?php namespace MyApp\Web\Controllers; use Illuminate\Http\Request; use MyApp\Components\Tasks\UseCases\CreateInbox\InputData; use MyApp\Components\Tasks\UseCases\CreateInbox\InputBoundary; /** * Class CreateInbox * @package MyApp\Web\Controllers */ 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); } }
62. Controller 62 <?php namespace MyApp\Web\Controllers; use Illuminate\Http\Request; use MyApp\Components\Tasks\UseCases\CreateInbox\InputData; use MyApp\Components\Tasks\UseCases\CreateInbox\InputBoundary; /** * Class CreateInbox * @package MyApp\Web\Controllers */ 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); } } Laravel ͷ Http\Controllers ͱಉ͡Α͏ʹॻ͚Δ
63. Controller 63 <?php namespace MyApp\Web\Controllers; use Illuminate\Http\Request; use MyApp\Components\Tasks\UseCases\CreateInbox\InputData; use MyApp\Components\Tasks\UseCases\CreateInbox\InputBoundary; /** * Class CreateInbox * @package MyApp\Web\Controllers */ 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); } } HTTPϦΫΤετˠ७ਮͳೖྗσʔλʹม׵
64. Controller 64 <?php namespace MyApp\Web\Controllers; use Illuminate\Http\Request; use MyApp\Components\Tasks\UseCases\CreateInbox\InputData; use MyApp\Components\Tasks\UseCases\CreateInbox\InputBoundary; /** * Class CreateInbox * @package MyApp\Web\Controllers */ 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); } } InputBoundaryʢ࣮ମ͸ InteractorʣΛݺͼग़͢
65. Controller 65 <?php namespace MyApp\Web\Controllers; use Illuminate\Http\Request; use MyApp\Components\Tasks\UseCases\CreateInbox\InputData; use MyApp\Components\Tasks\UseCases\CreateInbox\InputBoundary; /** * Class CreateInbox * @package MyApp\Web\Controllers */ 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); } }
66. Presenter • આ໌ 66 <?php namespace MyApp\Web\Presenters\CreateInbox; use Illuminate\View\Factory; use MyApp\Web\Presenters\Presenter as BasePresenter; use MyApp\Components\Tasks\UseCases\CreateInbox\NormalOutputData; use MyApp\Components\Tasks\UseCases\CreateInbox\NormalOutputBoundary; /** * Class CreateInboxPresenter * @package MyApp\Web\Presenters */ final class Presenter extends BasePresenter implements NormalOutputBoundary { // 中略 /** * @param NormalOutputData $output */ 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']))); } }
67. Presenter • આ໌ 67 <?php namespace MyApp\Web\Presenters\CreateInbox; use Illuminate\View\Factory; use MyApp\Web\Presenters\Presenter as BasePresenter; use MyApp\Components\Tasks\UseCases\CreateInbox\NormalOutputData; use MyApp\Components\Tasks\UseCases\CreateInbox\NormalOutputBoundary; /** * Class CreateInboxPresenter * @package MyApp\Web\Presenters */ final class Presenter extends BasePresenter implements NormalOutputBoundary { // 中略 /** * @param NormalOutputData $output */ 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']))); } } Interactor Ͱੜ੒͞Εͨग़ྗσʔλΛ ViewModel ʹม׵
68. Presenter • આ໌ 68 <?php namespace MyApp\Web\Presenters\CreateInbox; use Illuminate\View\Factory; use MyApp\Web\Presenters\Presenter as BasePresenter; use MyApp\Components\Tasks\UseCases\CreateInbox\NormalOutputData; use MyApp\Components\Tasks\UseCases\CreateInbox\NormalOutputBoundary; /** * Class CreateInboxPresenter * @package MyApp\Web\Presenters */ final class Presenter extends BasePresenter implements NormalOutputBoundary { // 中略 /** * @param NormalOutputData $output */ 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']))); } } View Λੜ੒ͯ͠ϨεϙϯεΛฦ͢ ※มͳ͜ͱ΍ͬͯΔͷ͸ Controllerͷ໭Γ஋Λ
 void ʹ͢ΔͨΊͳͷͰؾʹ͠ͳ͍Ͱ……🙇
69. ࢓্͛ • ΠϯλʔϑΣʔεͱ࣮૷ͷΫϥεΛ݁ͼ͚ͭΔ • ServiceProvider Ͱ΍Δ 69
70. 70 <?php namespace App\Providers; use Illuminate\Support\ServiceProvider; use MyApp\Components\Tasks\UseCases\CreateInbox\InputBoundary; use MyApp\Components\Tasks\UseCases\CreateInbox\Interactor; use MyApp\Components\Tasks\UseCases\CreateInbox\NormalOutputBoundary; use MyApp\Components\Tasks\UseCases\IdProvider; use MyApp\Components\Tasks\UseCases\TaskRepository as TaskRepositoryInterface; use MyApp\Database\Repositories\AutoIncrementTaskIdProvider; use MyApp\Database\Repositories\TaskRepository; use MyApp\Web\Presenters\CreateInbox\Presenter; 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() { // } }
71. Laravel ͱͷ෇͖߹͍ํ • Laravel ͷػೳΛ࢖͏ͳΒ֎ଆͷ૚Ͱ࢖͏ • ڧྗͳ DI ͷ࢓૊Έʹ৐͔ͬΔʢServiceContainerʣ • ύοέʔδʹ෼͚ͯ։ൃͯ͠
 ServiceProvider ͰͦΕΒΛ౷߹͢Δ • ී௨ʹॻ͘Ҏ্ʹґଘؔ܎Λҙࣝ͢ΔͷͰ
 ૬ੑ͕͍͍ؾ͕͍ͯ͠Δ 71
72. ࢀߟεϥΠυ@Laravel JP Conference 2019 https://speakerdeck.com/mikakane/laravel-package- development 72
73. σΟϨΫτϦߏ੒ 73
74. σΟϨΫτϦߏ੒ 74 packages ҎԼʹ
 ύοέʔδΛ࡞ͬͯΏ͘
75. σΟϨΫτϦߏ੒ 75 ؔ৺ࣄ୯ҐͰσΟϨΫτϦΛ੾Γ
 ϏδωεϧʔϧΛ࣮૷
76. σΟϨΫτϦߏ੒ 76 σʔλͷѻ͏ॲཧ͚ͩͰͳ͘
 ϚΠάϨʔγϣϯ΋
 ಉҰͷύοέʔδʹೖΕΔ
77. σΟϨΫτϦߏ੒ 77 web ͱ͍͏ׅΓͰ routes ΍
 views ΋ಉҰύοέʔδʹ
78. ໨࣍ • ͜ͷτʔΫͷΊ͟͢ͱ͜Ζʢ2 ෼ʣ • ΫϦʔϯΞʔΩςΫνϟͷ֓ཁʢ3 ෼ʣ • ίΞͱͳΔߟ͑ํʢ5 ෼ʣ • ۩ମతͳίʔυྫʢ10 ෼ʣ • ·ͱΊʢ3 ෼ʣ • ࣗݾ঺հʢ2 ෼ʣ 78
79. ίΞͱͳΔߟ͑ํ ʮॏཁͳ΋ͷʯΛʮࠣࡉͳ΋ͷʯʹґଘͤ͞ͳ͍ 79 σʔλϕʔεɾ UIɾϑϨʔϜϫʔΫͳͲ ༰қʹมߋͰ͖Δ Ϗδωεϧʔϧ มߋ͕ى͜Γʹ͍͘
80. ґଘؔ܎ٯసͨ͠ίʔυ package foo; class Foo { Buz x; function doFoo() { x.process(); } } interface Buz { function process(); } 80 package bar; import foo; class Bar implements foo.Buz { function process() { // do something... } }
81. ͜ͷτʔΫͷΊ͟͢ͱ͜Ζ🏁 • ΫϦʔϯΞʔΩςΫνϟͷίΞͱͳΔߟ͑ํ • ͦΕΛ࣮ݱ͢ΔͨΊͷ۩ମతͳίʔσΟϯά • ͦΕΒΛ࣮ફ͢Δ্Ͱͷ Laravel ͱͷ෇͖߹͍ํ ͜ΕΒΛ஌ͬͯ΋Β͍ɺͦͷҰ෦෼͚ͩͰ΋
 ͜Ε͔Βͷ։ൃʹ׆͔ͯ͠΋Β͏ 81
82. ໨࣍ • ͜ͷτʔΫͷΊ͟͢ͱ͜Ζʢ2 ෼ʣ • ΫϦʔϯΞʔΩςΫνϟͷ֓ཁʢ3 ෼ʣ • ίΞͱͳΔߟ͑ํʢ5 ෼ʣ • ۩ମతͳίʔυྫʢ10 ෼ʣ • ·ͱΊʢ3 ෼ʣ • ࣗݾ঺հʢ2 ෼ʣ 82
83. ࣗݾ঺հ Ԭా ਖ਼ฏ / ͓͔͠ΐ͍ @okashoi @okashoi ΞʔΩςΫτ ݉ ٕज़޿ใ 83
84. ࣗݾ঺հ ίϛϡχςΟ׆ಈ • Hacker’s GATE ӡӦ 84
85. ࣗݾ঺հ ίϛϡχςΟ׆ಈ • एख΋ͷͮ͘Γूஂ Oysters ϝϯόʔ 85
86. ࣗݾ঺հ ίϛϡχςΟ׆ಈ • Laravel JP Conference 2020 ίΞελοϑ 86 https://conference2020.laravel.jp/
87. ࣗݾ঺հ Ask the Speaker ΍ ࠙਌ձͰ
 ͓࿩͕Ͱ͖ͨΒخ͍͠Ͱ͢ 😂 87