Symfony Components in the Wild Drupal Jungle

The talk seeks to provide a clear view on how Drupal is using Symfony Components. The focus would be on the state of things and how Symfony is providing a Backwards compatibility promise for other projects to ensure Drupal uses it rightly and follow upgrades of these components closely and keeping robust because of BC.

I am part of the symfony community and have been working with Symfony in industry and in the Open Source arena. I am also the maintainer of a tool called Gush which plans to revolutionize the speed in which we develop today, a game changer as someone says.

I will provide ways in which Drupal can reutilize further Symfony Components yet keeping the codebase well decoupled.

Everyone is invited to benefit from clear examples on how to help develop a clean Drupal codebase and understanding more the Symfony alien phenomena.

I am submitting because someone invited me to submit. :)

Transcript

1. http://www.dailymail.co.uk/travel/article-2225903/Machu-Picchu-holiday-Luxury-convents-ceviche-discovering-Lost-City-Perus-Inca-heartland.html
3. Welcome to my talk “I praise you, for I am fearfully and wonderfully made. Wonderful are your works; my soul knows it very well.” ! - Proverbs 139:14
4. @ cordoval
5. http://iquitostravel.com/images/jaguar-exotic-animals.jpg
6. here to help you solve your problems with software that is - portable - upgradable
7. let’s first see some numbers …
12. http://symfony.com/doc/current/_images/release-process.jpg
14. semantic versioning means … it means something σημαντικός
15. image from https://igor.io/2013/10/21/git-branching-model.html
16. symfony/symfony
17. symfony/class-loader
18. symfony/class-loader
19. image from https://igor.io/2013/10/21/git-branching-model.html "symfony/class-loader": "2.4.*", "symfony/dependency-injection": “2.4.*”, ... "symfony/class-loader": “~2.4.1”, "symfony/dependency-injection": “~2.4.1”, ... composer.json
21. Even though … !
22. symfony/filesystem Even though … ! In reality …
23. clean /o/ \o\
24. Decoupled Packages
25. Upgrading Legacy
26. "## symfony $ "## class-loader $ "## debug $ "## dependency-injection $ "## event-dispatcher $ "## http-foundation $ "## http-kernel $ "## process $ "## property-access $ "## routing $ "## serializer $ "## translation $ "## validator $ &## yaml cd 8.x/core/vendor; tree -L 2 config? filesystem? expression- language?
27. Taming Inwards … ! ehem Extension Points
28. Pick an example: ! say Yaml
29. // austin.yml food: [tacos, burritos, fajitas] ! ! // menu.php use Symfony\Component\Yaml\Yaml; ! $options = Yaml::parse(‘austin.yml’); ! ... !
30. Feature: Support Object Map ! Inline::parse( $value, // input false, // invalid exception false, // object support true // map to stdClass );
31. [{ foo: {bar: foo} }] ! [ (object) [ ‘foo’ => (object) [ ‘bar’ => ‘foo’ ] ] ]
33. class Inline ... { public function $b( $arg1 ); }
34. class Inline ... { public function $b( $arg1, $arg2 = false ); }
35. This PR did not break BC: ! - did not have an interface - did affect signature but mildly - is going to go in 2.6 - is not a bugfix (not in 2.5.1) - if you were extending via extra arguments then is going to break your app
36. Let me unpack ! the implications of ! how we get new feats
37. class MyDomain extends BaseDomain implements DomainInterface { private $a; public function $b(); private function $c(); }
38. class WithoutContract { private $a; public function $b(); private function $c(); }
39. class MyDomain extends BaseDomain { public function $b($arg1, $arg2); } ! class BaseDomain ... { public function $b($arg1) { // ... } }
40. class MyDomain implements DomainInterface { public function $b($arg1, $arg2); } ! interface DomainInterface ... { public function $b($arg1); } !
41. Rules for package design:
42. namespace Symfony\... ! interface ImplementWithCare { // can grow careful! } !
43. namespace Symfony\... ! /** * @internal (aka non-public api) */ interface ImplementAtYourOwnRisk { // will grow or shrink or worse } !
44. namespace Symfony\... ! /** * @api (aka external) */ interface SafeToImplement { // set on stone } !
45. class AjaxResponse extends JsonResponse Not so good
46. class ConfigCollectionInfo extends Event { protected $collections = array(); ! public function addCollection( $collection, ConfigFactoryOverrideInterface ... ); ! public function getCollectionNames(...); ! public function getOverrideService(...); } Not so good
47. class Container extends SymfonyContainer { public function get($id, ...); public function __sleep(); } Good
48. What if it is hard … ! Deal with it ! but how?
49. YamlFileLoader
52. -> track features via tests
54. -> create your own contracts (interface on the boundaries) or wrappers ! outward —>
55. ! -> propose new interfaces (think of smaller parents) ! ! inward <—
56. Taming Outwards … ! ehem Extension Points
57. class Yaml implements SerializationInterface { public static function encode($data) { return Symfony::dump($data, ...); } ! public static function decode($raw) { return Symfony::parse($raw, true); }
58. \Drupal::x the axe of all evil ... Parallax?
59. mind all things: ! - respect encapsulation - respect api’s - respect your code - use deprecation
60. sdboyer - assetic github.com / sdboyer / drupal / compare / e74a757...assets-1762204
61. sdboyer - frozone
62. sdboyer - frozone (new Counter()) // count = 0 ->isFrozen() // false ->increment() // count = 1 ->freeze() ! ->isFrozen() // true ->increment() // exception ;
63. We are taming wild code including symfony/components and Drupal
64. Decoupled Drupal 8.1: drupal/assets drupal/cmi drupal/ajax drupal/plugger drupal/you_name_it!
65. Series of 7 blog posts!
66. Ever wanted to use phing or ant but in yaml and have your own functions? bldr.io my friend ! Aaron Scherer
67. Ever wanted to be fast! maintaining or contributing to a repository on GitHub? gushphp.org @sstok @dantleech all contributors
68. http://www.southernexplorations.com/img/peru/amazon-river-cruises/aria/photos/01.jpg Thank to my parents. To Keith/Dawn, and Drupal Association, Keith Kirk and all at UndergroundElephant for your support.
69. ! ! ! http://bit.ly/ symfony-drupal Thank you!