Unglue all the things! (DPC 2016)

Bundles. Packages. Modules. Plugins. So much code is locked up in framework-specific packages. Integration packages are not bad, but losing the ability to reuse code that has nothing to do with a specific framework's implementation is! Don't let reusable code get locked into framework-specific glue packages! Come see practical strategies for writing framework agnostic code and walk away having a better idea how you, too, can unglue all the things!

Transcript

1. Unglue All The Things! joind.in/talk/e7bb0 Beau Simensen • beau.io • @beausimensen
2. Framework Agnostic PHP Packages
3. Domain-Driven Design
4. Exploring Domain-Driven Design led me to pursuing Tactical Purity (No non-domain model junk in my domain model!)
5. Tactical Purity is Hard. (especially in PHP)
6. I've got this. — Me
7. hubris [(h)yo͞obris] noun Excessive pride or self-confidence.
8. Reality
9. Active Record is the worst
10. Doctrine is just as bad
11. Lesson Learned ORM framework agnostic models are hard to get right
12. Lesson Learned ORM framework agnostic models may require compromises
14. Symfony 2
15. One catch...
16. Bundles.
17. "Modern PHP Packages"
18. Yuck.
19. Too many conventions
20. Too complicated
21. Too "Symfony"
22. Too much noise around my Business Logic
23. "Framework Agnostic"
25. Silex + Doctrine
26. Silex Service Providers Fancy classes that wire up Pimple
27. dflydev/doctrine-orm-service-provider
28. My models were already not ORM framework agnostic But annotations were just too much for me to accept
29. Most Doctrine integration packages required knowing exact path to mappings
30. Symfony handled this by convention (this is one reason why so many projects ship everything as a bundle)
31. Won't work if the mappings live in a project other than a bundle* * Nasty __DIR__ hacks don't count.
32. This was problem.
33. Do we already have the tools to solve this problem?
34. PSR-0 (with a little help from Composer)
35. "autoload": { "psr-0": { "Monii\\Deal\\": "src" } }
36. "autoload": { "psr-0": { "Monii\\Deal\\": "src" } } Monii\Deal\DealRepository => src/Monii/Deal/DealRepository.php
37. "autoload": { "psr-0": { "Monii\\Deal\\": "src" } } Monii\Deal\DealRepository => src/Monii/Deal/DealRepository.php Monii\Deal\DealRepository => vendor/monii/deal/src/Monii/Deal/DealRepository.php
38. What if we used PSR-0 mappings and rules to locate other types of files than just classes?
39. "autoload": { "psr-0": { "Monii\\Deal\\": "src" } } Monii\Deal\DealRepository => src/Monii/Deal/DealRepository.php
40. "autoload": { "psr-0": { "Monii\\Deal\\": "src" } } Monii\Deal\DealRepository => src/Monii/Deal/DealRepository.php classpath:Monii/Deal/resources/mapping.yml => src/Monii/Deal/resources/mapping.yml
41. "autoload": { "psr-0": { "Monii\\Deal\\": "src" } } Monii\Deal\DealRepository => src/Monii/Deal/DealRepository.php classpath:Monii/Deal/resources/mapping.yml => src/Monii/Deal/resources/mapping.yml classpath:Monii/Deal/resources/mapping.yml => vendor/monii/deal/src/Monii/Deal/resources/mapping.yml
42. dflydev/psr0-resource-locator
43. $container["orm.em.options"] = [ "mappings" => [ [ "type" => "xml", "namespace" => "Monii\Deal", "resources_namespace" => "Monii\Deal\mappings", ], ], ];
44. $container["orm.em.options"] = [ "mappings" => [ [ "type" => "xml", "namespace" => "Monii\Deal", "resources_namespace" => "Monii\Deal\mappings", ], ], ]; Monii\Deal\Deal
45. $container["orm.em.options"] = [ "mappings" => [ [ "type" => "xml", "namespace" => "Monii\Deal", "resources_namespace" => "Monii\Deal\mappings", ], ], ]; Monii\Deal\Deal => classpath:Monii/Deal/mappings/Deal.xml
46. $container["orm.em.options"] = [ "mappings" => [ [ "type" => "xml", "namespace" => "Monii\Deal", "resources_namespace" => "Monii\Deal\mappings", ], ], ]; Monii\Deal\Deal => classpath:Monii/Deal/mappings/Deal.xml => vendor/monii/deal/src/Monii/Deal/mappings/Deal.xml
47. Updating the Symfony Bundle would have required a lot of work (and buy-in from the Doctrine team...)
48. No More Time :(
49. Amy Stephen
50. PSR-4
51. Shorter paths please! — Everyone, apparently
52. "autoload": { "psr-0": { "Monii\\Deal\\": "src" } }
53. "autoload": { "psr-4": { "Monii\\Deal\\": "src" } }
54. "autoload": { "psr-4": { "Monii\\Deal\\": "src" } } Monii\Deal\DealRepository => src/DealRepository.php
55. "autoload": { "psr-4": { "Monii\\Deal\\": "src" } } Monii\Deal\DealRepository => src/DealRepository.php Monii\Deal\DealRepository => vendor/monii/deal/src/DealRepository.php
56. "autoload": { "psr-4": { "Monii\\Deal\\": "src" } }
57. "autoload": { "psr-4": { "Monii\\Deal\\": "src", "Monii\\Deal\\resources": "resources" } }
58. "autoload": { "psr-4": { "Monii\\Deal\\": "src", "Monii\\Deal\\resources": "resources" } } classpath:Monii/Deal/resources/mapping.yml => resources/mapping.yml
59. "autoload": { "psr-4": { "Monii\\Deal\\": "src", "Monii\\Deal\\resources": "resources" } } classpath:Monii/Deal/resources/mapping.yml => resources/mapping.yml classpath:Monii/Deal/resources/mapping.yml => vendor/monii/deal/resources/mapping.yml
60. Proposed to PHP-FIG
61. [Crickets.] — PHP-FIG
64. End results?
65. PSR-4 only cares about classes
66. Puli the future of PHP package development
67. Puli allows packages can expose resources without knowing how they will be consumed
69. Controllers
70. Translates between HTTP messages and your business logic. — Me, on controllers, actions, whatever
71. Traditionally, controllers have been trapped in the glue layer
72. Controllers as services can make controllers more portable
73. Symfony controllers as services can be used as-is in Silex, Drupal, Laravel, and Symfony full stack
75. #silex-php (many of my favorite things started as irc conversations)
76. Stack
77. Stack is a convention for composing HttpKernelInterface middleware
78. Stack is a convention for composing HttpKernelInterface middleware
79. Stack is NOT a library
80. Stack is NOT a framework
81. Stack's Goal: Being able to write framework agnostic code at the HTTP layer
82. :)
83. :(
84. Limited to the Symfony Ecosystem
85. Truly "Framework Agnostic" HTTP would have to wait a few years...
86. (just over two years, to be precise...)
87. PSR-7 HTTP Message Interfaces
88. Glide On-demand image manipulation library with an HTTP based API.
89. Glide is a self-contained HTTP application
90. I've used it. It's beautiful.
91. It was glued to Symfony
92. Why?
93. Hey! I'm trying to decide if Glide should use PSR-7 for it's next release. — Jonathan Reinink, June 2015
94. Because let's be honest. That's the future. — Jonathan Reinink, two days later
96. Problem: No standard way to write PSR-7 middleware.
97. PSR-15 HTTP Middleware
98. PSR-7 + PSR-15 = Stack's Vision. Realized.
99. Problem: In many cases it is hard to write PSR-7 code that is not tied to an implementation.
100. PSR-17 HTTP Factories
101. With PSR-7, PSR-15 and PSR-17 combined we can truly start writing Framework Agnostic HTTP applications.
103. Purist vs Pragmatist
104. Closed Source
105. Will you actually reuse it?
106. Will you ever actually change frameworks?
107. Open Source
108. A lot of potential users from many potential frameworks
110. parting thoughts
111. Consider your goals
112. Start simple Move business logic out of the glue's namespace
113. Try Puli Especially if you have non-code resources that need to be referenced
114. Think about the code you write directly into a glue package (It can lead to better design)
115. Your model may always be influenced by your ORM Accept it
116. Container configuration is hard Expect some duplication across glue packages
117. If you must use Service Locator Consider using Container Interop (PSR-11)
118. Keep an eye on Container Interop...
119. Create separate packages for business logic and glue layers
120. suggest + require-dev is WEAK
121. Consider subtree splits for easier management of one repository containing multiple packages
122. splitsh https://github.com/splitsh/lite
123. EXPERIMENT
124. GET INVOLVED
125. Thanks! beau.io • @beausimensen monii.io • @moniidev thatpodcast.io • @thatpodcast joind.in/talk/e7bb0
127. Engaging PHP-FIG was AWESOME (but very very very very exhausting)
128. PSR-0 Resource Locator (my experiment)
129. PSR-4 (getting involved)
130. Puli (something awesome)
131. Stack (my experiment)
132. PSR-7 (getting involved AND something awesome!)
133. I'm nobody
134. I'm just like you
135. Get involved :)