Symfony3 Best Practices from the trenches

As done at PHP.FRL meetup in Heerenveen

2. About me » PHPBenelux » PFZ » PHPAmersfoort/PHP.FRL » Ingewikkeld » phpBB, Zend Framework, Symfony and many more
3. Once upon a time...
5. Dependency Injection
6. Dependency Injection » No hardcoded dependencies » Easily manage and update specific classes » Program to contracts, not implementations » Minimize bootstrap code » More testable code
7. Dependency Injection class Foo { public function bar() { $coffee = new Coffee(); $coffee->init(); return $coffee->drink(); } }
8. Dependency Injection $coffee = new Coffee();
9. Dependency Injection $coffee->init();
10. Dependency Injection class Coffee implements Roastable {} class Foo { private $coffee; public function __construct(Roastable $coffee) { $this->coffee = $coffee; } }
11. Dependency Injection public function bar() { return $this->coffee->drink(); }
12. Dependency Injection parameters: coffee.class: "Coffee" foo.class: "Foo" services: coffee: class: "%coffee.class%" foo: class: "%foo.class%" arguments: - "@coffee"
13. Dependency Injection class DefaultController { public function fooAction() { $foo = $this->container->get('foo'); $foo->bar(); } }
14. Dependency Injection class DefaultController { private $foo; public function __construct(Foo $foo) { $this->foo = $foo; } public function fooAction() { $this->foo->bar(); } }
15. Service layer Or: How Symfony is only implementation
16. Service layer » Seperation of concerns » Business logic should not be bound to the application » Service layer can be accessed through the service container
17. Service layer public function showAction($productId) { $product = $this->getDoctrine() ->getRepository('AppBundle:Product') ->find($productId); if (!$product) { throw $this->createNotFoundException( 'No product found for id '.$productId ); } // ... do something, like pass the $product object into a template }
20. Service Layer Hexagonal architecture » http://php-and-symfony.matthiasnoback.nl/tags/ hexagonal%20architecture/ » http://protalk.me/the-framework-as-an- implementation-detail
22. Documentation
23. Documentation » The best starting point for your search » Not the ultimate source for information
24. Documentation » Google » Stack Overflow » Blogs » IRC
25. Documentation » Something missing? Add it yourself! » https://github.com/symfony/symfony-docs
26. Documentation » Symfony Rainbow Series by Joshua Thijssen » https://leanpub.com/b/symfonyrainbowseries
27. Project Configuration
28. Project Configuration Everything in its right place » config*.yml » routing*.yml » security.yml » parameters.yml
30. Project Configuration XML vs yaml » http://gowat.ch/xmlyml » http://converter.rosstuck.com/
31. Choose and Standardize
32. Choose » You can do things in multiple ways » THIS IS GREAT! » Clarity, readability, maintainability
33. Standardize » Configuration: yml, xml, annotations » Controller extends or not? » Naming of services, parameters, bundles
34. Ready for action?
35. Ready for action? » Use bundles correctly » Maximize external library usage » Avoid |raw » .gitignore your parameters.yml » Translate! » Log all the things! » Stay up-to-date
36. Up-to-date » 2.7 - support until 05/2018, EOL 05/2019 » 2.8 - support until 11/2018, EOL 11/2019 » 3.0 - support until 07/2016, EOL 01/2017 » Next LTS: 3.4: support until 11/2020, EOL 11/2021
37. Questions?
38. I Salute You
39. I Salute You @skoop leftontheweb.com php.ingewikkeld.net