Symfony 4 : une nouvelle expérience de développement

Transcript

1. Symfony 4 Une nouvelle expérience de développement Octobre 2018 Forum PHP
2. Titouan Galopin Product Manager SymfonyInsight 2
3. 3 Agenda 1. Symfony 4 2. Symfony Flex 3. Le maker bundle 4. Webpack Encore 5. L’intégration dans les infrastructures modernes 6. L’injection de dépendances
4. Symfony 4
5. Symfony 4 Versionnement sémantique 5
6. Symfony 4 PHP 7.1+ Migration 3 => 4 simplifiée par le système de dépréciations 6
7. Symfony 4 Symfony 4 = Symfony 3.4 sans la couche de compatibilité … 7
8. Symfony 4 Symfony 4 = Symfony 3.4 sans la couche de compatibilité … … mais aussi bien plus que ca ! 8
9. Symfony 4 Réévaluation de toutes les idées de Symfony pour les adapter au développement en 2018 9
10. Symfony 4 Réévaluation de toutes les idées de Symfony pour les adapter au développement en 2018 Plus facile à apprendre / configurer / utiliser / déployer Framework PHP le plus rapide du marché 10 phpbenchmarks.com
11. Symfony Flex
12. Symfony Flex composer create-project symfony/skeleton mydir 12
13. 13 ├── bin/console ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test/framework.yaml │ ├── routes.yaml │ └── services.yaml ├── public/index.php └── src ├── Controller └── Kernel.php Nouvelle structure Projet minimal : - 13 fichiers - 4 dépendances directes
14. 14 ~ composer create-project symfony/skeleton mydir Installing symfony/skeleton (v4.1.5.3) - Installing symfony/skeleton (v4.1.5.3) Created project in mydir - Installing symfony/flex (v1.1.1) - ... Generating autoload files Symfony operations: 4 recipes (a4070919102626e6a1736d4d1896e8d8) - Configuring symfony/flex (>=1.0): From github.com/symfony/recipes:master - Configuring symfony/framework-bundle (>=3.3): From github.com/symfony/recipes:master - Configuring symfony/console (>=3.3): From github.com/symfony/recipes:master - Configuring symfony/routing (>=4.0): From github.com/symfony/recipes:master Executing script cache:clear [OK] Executing script assets:install public [OK] Some files may have been created or updated to configure your new packages. Please review, edit and commit them: these files are yours.
15. Symfony Flex Plugin Composer Au moment de l’installation d’un package, Symfony Flex le configure automatiquement 15
16. Sans Flex - composer require bundle - Ajouter une ligne dans app/AppKernel.php - Créer la configuration dans app/config/config.yml - Importer le routing dans app/config/routing.yml Installation d’un bundle Avec Flex - composer require bundle 16
17. Symfony Flex composer require symfony/monolog-bundle 17
18. 18 ~/mydir composer require symfony/monolog-bundle Restricting packages listed in "symfony/symfony" to "4.1.*" Using version ^3.3 for symfony/monolog-bundle Restricting packages listed in "symfony/symfony" to "4.1.*" Package operations: 3 installs, 0 updates, 0 removals - Installing monolog/monolog (1.23.0) - Installing symfony/monolog-bridge (v4.1.6) - Installing symfony/monolog-bundle (v3.3.0) Writing lock file Generating autoload files Symfony operations: 1 recipe (3ccbdff84ac79218c4bcf54d45c68b02) - Configuring symfony/monolog-bundle (>=3.1): From github.com/symfony/recipes:master Executing script cache:clear [OK] Executing script assets:install public [OK] Some files may have been created or updated to configure your new packages. Please review, edit and commit them: these files are yours.
19. 19 ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/monolog.yaml │ │ ├── prod/monolog.yaml │ │ └── test/monolog.yaml │ ├── routes.yaml │ └── services.yaml └── public/index.php
20. 20 // config/bundles.php return [ Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true], Symfony\Bundle\MonologBundle\MonologBundle::class => ['all' => true], ]; ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/monolog.yaml │ │ ├── prod/monolog.yaml │ │ └── test/monolog.yaml │ ├── routes.yaml │ └── services.yaml └── public/index.php
21. Symfony Flex Définit un écosystème à partir d’alias officiels 21
22. Symfony Flex composer req logger 22
23. 23 ~/mydir composer req logger Restricting packages listed in "symfony/symfony" to "4.1.*" Using version ^3.3 for symfony/monolog-bundle Restricting packages listed in "symfony/symfony" to "4.1.*" Package operations: 3 installs, 0 updates, 0 removals - Installing monolog/monolog (1.23.0) - Installing symfony/monolog-bridge (v4.1.6) - Installing symfony/monolog-bundle (v3.3.0) Writing lock file Generating autoload files Symfony operations: 1 recipe (3ccbdff84ac79218c4bcf54d45c68b02) - Configuring symfony/monolog-bundle (>=3.1): From github.com/symfony/recipes:master Executing script cache:clear [OK] Executing script assets:install public [OK] Some files may have been created or updated to configure your new packages. Please review, edit and commit them: these files are yours.
24. Symfony Flex Besoin d’un ORM ? composer req orm Besoin de Twig ? composer req twig 24
25. Symfony Flex Besoin d’une API ? composer req api Besoin d’une interface d’admin ? composer req admin 25
26. “ Mais comment ca marche ? 26
27. Symfony Flex Système de “recettes” : une recette par package 27 Un recette peut : - ajouter des variables d’env - ajouter des paramètres de container - ajouter des fichiers/dossiers au gitignore - créer des fichiers de configuration - enregistrer des bundles
28. Symfony Flex Composition over Inheritance, pour votre projet complet ! 28
29. Symfony Flex Le kernel découvre la configuration 29
30. 30 ├── bin/console ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test/framework.yaml │ ├── routes.yaml │ └── services.yaml ├── public/index.php └── src ├── Controller └── Kernel.php
31. 31 ├── bin/console ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test/framework.yaml │ ├── routes.yaml │ └── services.yaml ├── public/index.php └── src ├── Controller └── Kernel.php Simple tableau associatif listant les bundles
32. 32 ├── bin/console ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test/framework.yaml │ ├── routes.yaml │ └── services.yaml ├── public/index.php └── src ├── Controller └── Kernel.php Simple tableau associatif listant les bundles Equivalent de AppKernel, charge les bons fichiers de configuration / services / routing
33. 33 ├── bin/console ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test/framework.yaml │ ├── routes.yaml │ └── services.yaml ├── public/index.php └── src ├── Controller └── Kernel.php Découverte automatique du contenu du dossier packages par le Kernel Simple tableau associatif listant les bundles Equivalent de AppKernel, charge les bons fichiers de configuration / services / routing
34. 34 ├── bin/console ├── config │ ├── bundles.php │ ├── packages │ │ ├── dev/routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test/framework.yaml │ ├── routes.yaml │ └── services.yaml ├── public/index.php └── src ├── Controller └── Kernel.php Découverte automatique du contenu du dossier packages par le Kernel Simple tableau associatif listant les bundles Equivalent de AppKernel, charge les bons fichiers de configuration / services / routing Chaque environnement peut avoir son sous-dossier dédié
35. 35 protected function configureContainer($container, loader) { $container->addResource( new FileResource($this->getProjectDir().'/config/bundles.php') ); // ... $loader->load( $confDir.'/{packages}/*'.self::CONFIG_EXTS, 'glob' ); $loader->load( $confDir.'/{packages}/'.$this->environment.'/**/*'.self::CONFIG_EXTS, 'glob' ); $loader->load( $confDir.'/{services}'.self::CONFIG_EXTS, 'glob' ); $loader->load( $confDir.'/{services}_'.$this->environment.self::CONFIG_EXTS, 'glob' ); }
36. Symfony Flex https://flex.symfony.com 2 types de recettes : officielles et contrib 36
37. Le maker bundle
38. Le maker bundle composer require --dev maker 38
39. Le maker bundle Un générateur qui fait bien les choses 39 make:auth make:command make:controller make:crud make:entity make:fixtures make:form make:functional-test make:migration make:serializer:encoder make:subscriber make:twig-extension make:unit-test make:user make:validator make:voter
40. 40 ~/mydir composer req annotations ~/mydir composer req --dev maker ~/mydir bin/console make:controller Choose a name for your controller class (e.g. OrangeJellybeanController): > HomeController created: src/Controller/HomeController.php _Success!_ Next: Open your new controller class and add some pages! Nécessaire pour maker:controller
41. Le maker bundle Le code généré vous appartient : Modifiez-le, adaptez-le, commitez-le ! 41
42. Webpack Encore
43. Webpack Regroupe des imports SASS/JS/TS/… pour créer un seul fichier 43 // app.js const ApiClient = require('./api/client');
44. Webpack Encore Symfony Webpack Encore Librairie Javascript pour utiliser Webpack facilement 44
45. Webpack Encore composer require --dev webpack 45
46. 46 ├── assets │ ├── css/app.css │ └── js/app.js ├── config/… ├── public │ ├── build/app.min.css │ ├── build/app.min.js │ └── index.php ├── src/... ├── package.json ├── webpack.config.js └── ... Dossier de source des assets
47. 47 ├── assets │ ├── css/app.css │ └── js/app.js ├── config/… ├── public │ ├── build/app.min.css │ ├── build/app.min.js │ └── index.php ├── src/... ├── package.json ├── webpack.config.js └── ... Dossier des assets minifiés Dossier de source des assets
48. 48 ├── assets │ ├── css/app.css │ └── js/app.js ├── config/… ├── public │ ├── build/app.min.css │ ├── build/app.min.js │ └── index.php ├── src/... ├── package.json ├── webpack.config.js └── ... Dossier des assets minifiés Dossier de source des assets “composer.json pour Javascript”
49. 49 ├── assets │ ├── css/app.css │ └── js/app.js ├── config/… ├── public │ ├── build/app.min.css │ ├── build/app.min.js │ └── index.php ├── src/... ├── package.json ├── webpack.config.js └── ... Dossier des assets minifiés Dossier de source des assets Configuration de Webpack “composer.json pour Javascript”
50. 50 var Encore = require('@symfony/webpack-encore'); Encore .setOutputPath('public/build/') .setPublicPath('/build') .addEntry('app', './assets/js/app.js') .cleanupOutputBeforeBuild() .enableBuildNotifications() .enableSourceMaps(!Encore.isProduction()) .enableVersioning(Encore.isProduction()) // enables Sass/SCSS support //.enableSassLoader() // uncomment if you use TypeScript //.enableTypeScriptLoader() // uncomment if you're having problems with a jQuery plugin //.autoProvidejQuery()
51. L’intégration dans les infrastructures modernes
52. L’intégration dans les infrastructures modernes Deux types de caches 52
53. Deux types de cache 53 Cache système : - Container compilé - Templates Twig compilés - Metadata Doctrine ... Cache applicatif : Vos données à mettre en cache
54. Deux types de cache 54 Cache système : Ne change pas au cours de la vie de l’application (read-only) Cache applicatif : Change au cours de la vie de l’application
55. Deux types de cache 55 Cache système : N’a pas besoin d’être synchronisé entre plusieurs instances frontales Cache applicatif : Doit être synchronisé entre plusieurs instances frontales
56. Deux types de cache 56 Cache système : Filesystem Cache applicatif : Votre backend (Redis, PDO, …)
57. Deux types de cache 57 framework: cache: app: cache.adapter.redis default_redis_provider: 'redis://%env(REDIS_HOST)%'
58. L’intégration dans les infrastructures modernes Les variables d’environnement 58
59. Les variables d’environnement .env Intégré dans les recettes Référençable dans la configuration / les services 59
60. 60 .env ###> symfony/framework-bundle ### APP_ENV=dev APP_SECRET=95b679e8ee0683314cece8ea8126795d #TRUSTED_PROXIES=127.0.0.1,127.0.0.2 #TRUSTED_HOSTS=localhost,example.com ###< symfony/framework-bundle ### config/packages/framework.yaml framework: secret: '%env(APP_SECRET)%'
61. L’injection de dépendances
62. L’injection de dépendances Probablement le composant qui a le plus changé en 3.4/4.0 62 - Autodiscovery - Autowiring - Autoconfiguration - Defaults - Bindings - Services taggués - Controllers as services
63. Comment fonctionne le composant DependencyInjection ? 63 class Persister {/* ... */} class Mailer {/* ... */} class RegistrationManager { private $persister; private $mailer; public function __construct( Persister $persister, Mailer $mailer ) { /* ... */ } public function register() {} } Objectif : $manager = new RegistrationManager( new Persister($doctrine), new Mailer($twig, $swiftmailer) );
64. Comment fonctionne le composant DependencyInjection ? 64 Mailer Persister RegistrationManager Swiftmailer Twig Doctrine
65. L’injection de dépendances Configuration => Graphe => Container compilé 65
66. L’injection de dépendances En Symfony 3, pour configurer ce graphe : app/config/services.yml 66
67. L’injection de dépendances Symfony 4 introduit différentes automatisations pour créer ce graphe plus simplement 67
68. L’injection de dépendances Identifiant de service = Nom complet de la classe 68
69. Identifiant de service = nom complet de la classe 69 Symfony 3 app.mailer: class: AppBundle\Mailer\Mailer arguments: ['@twig', '@mailer'] app.persister: class: AppBundle\Doctrine\Persister arguments: ['@doctrine'] app.registration_manager: class: AppBundle\Registration\RegistrationManager arguments: ['@app.persister', '@app.mailer']
70. Identifiant de service = nom complet de la classe 70 Symfony 4 App\Mailer\Mailer: arguments: ['@twig', '@mailer'] App\Doctrine\Persister: arguments: ['@doctrine'] App\Registration\RegistrationManager: arguments: ['@App\Doctrine\Persister', '@App\Mailer\Mailer']
71. Identifiant de service = nom complet de la classe 71 Symfony 4 App\Mailer\Mailer: arguments: ['@twig', '@mailer'] App\Doctrine\Persister: arguments: ['@doctrine'] App\Registration\RegistrationManager: arguments: ['@App\Doctrine\Persister', '@App\Mailer\Mailer'] Permet $container->get(Mailer::class) !
72. L’injection de dépendances Autodiscovery + Autowiring 72
73. Autodiscovery + Autowiring 73 App\Mailer\Mailer: arguments: ['@twig', '@mailer'] App\Doctrine\Persister: arguments: ['@doctrine'] App\Registration\RegistrationManager: arguments: ['@App\Doctrine\Persister', '@App\Mailer\Mailer'] App\: resource: '../src/*'
74. Comment fonctionne le composant DependencyInjection ? 74 Mailer Persister RegistrationManager Swiftmailer Twig Doctrine Autodiscovery Autowiring
75. “ L’autowiring n’a rien de magique Il est basé uniquement sur les noms de classes et des typehints 75
76. Comment fonctionne le composant DependencyInjection ? 76 class Persister {/* ... */} class Mailer {/* ... */} class RegistrationManager { private $persister; private $mailer; public function __construct(Persister $persister, Mailer $mailer) { /* ... */ } public function register() {} } Nom des services à injecter = typehints
77. L’injection de dépendances Defaults + Autoconfiguration 77
78. Defaults + Autoconfiguration 78 services: _defaults: autowire: true autoconfigure: true public: false App\: resource: '../src/*' Defaults (par fichier) : Les nouvelles fonctionnalités sont opt-in Services privés par défaut
79. Defaults + Autoconfiguration 79 services: _defaults: autowire: true autoconfigure: true public: false App\: resource: '../src/*' Defaults (par fichier) : Autoconfiguration : Configure automatiquement les services en fonctions de leurs interfaces (extensions Twig, listeners, etc.)
80. L’injection de dépendances Bindings : et les paramètres ? 80
81. Bindings 81 services: # pour un service précis App\Registration\RegistrationManager: arguments: $projectDir: '%kernel.project_dir%' # pour tous les services du fichier _defaults: bind: $projectDir: '%kernel.project_dir%' Automatise l’injection des paramètres
82. L’injection de dépendances Les contrôleurs sont des services 82
83. Controllers as services 83 services: App\Controller\: resource: '../src/Controller' tags: ['controller.service_arguments'] public function contact( Request $request, Mailer $mailer ) { // … } Le tag permet d’injecter les services en paramètres de l’action
84. Comment fonctionne le composant DependencyInjection ? 84 Mailer Persister RegistrationManager Swiftmailer Twig Doctrine RegistrationController
85. 85 Contribuez ! symfony.com/support => Slack Pinguez Nicolas Grekas
86. 86 Merci ! Venez me voir au stand Symfony ! ▪ Twitter : @titouangalopin ▪ Github : @tgalopin ▪ titouan.galopin@symfony.com