Migrer vers Symfony Flex

Coucou, je suis Loïck Piera

• Expert Trottinette et développeur Web chez
• Bidouilleur d'ascenseur
• pyrech
• pyrech

Symfony Flex, kezako ?

• Nouvelle façon de créer une application Symfony
• Plugin Composer
• Automatise l'installation de package / bundle
• Requiert PHP 7.1 et la structure de Symfony 4
• Disponible dès Symfony 3.3

Nouvelle directory structure de Sf 4

• app/AppKernel.php => src/Kernel.php
• app/config/parameters.yml => .env
• app/config/* => config/*
• app/resources/{assets, translations}/ => {assets, translations}/
• app/resources/views/ => templates/
• src/{App, …}Bundle/ => src/
• web/ => public/
• web/app_*.php => public/index.php

Objectifs de Flex

• Faciliter l'ajout/la suppression de dépendances
• Avoir une configuration par défaut qui fonctionne immédiatement

Installation d'un bundle : sans Flex

• composer require mon-package
• Instancier le(s) bundle(s) dans le Kernel
• 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 mon-package
• Instancier le(s) bundle(s) dans le Kernel
• Créer la configuration dans app/config/config.yml
• Importer le routing dans app/config/routing.yml

Une recipe Flex

• Définit une configuration par défaut
  • Bundle(s) à instancier
  • Fichiers (config, routing ou autre) à créer
  • Paramètre à rajouter dans le DIC
  • Entrées à rajouter dans .gitignore, .env, Makefile, etc
  • Tâche(s) à lancer après l'install
• Système d'alias et de "pack" : composer req orm

Recipe pour doctrine/doctrine-bundle

:'(

• Pas d'outil de migration vers la nouvelle structure
• composer require symfony/flex ne suffit pas
  

Procédure - étape 1

• Démarrer une nouvelle application
  composer create-project symfony/skeleton
• Réimporter vos "require" et "require-dev" dans le composer.json du nouveau projet
• composer install pour générer la config

Procédure - étape 2 (boring)

• Checker les fichiers générés dans config/packages/
• Réintégrer la conf de app/config/config_*.yml
• Déplacer les parameters de app/config/parameters.yml vers config/services.yaml ou .env

Procédure - étape 3

• Réimporter le code PHP (plus de AppBundle !) : namespace à modifier
• Réimporter les templates, traductions, etc.
• Réappliquer les autres modifs requises par votre application (app_dev.php par exemple)

Nouveautés du DIC dans SF 3.3

• Cf. le talk "Les nouveautés dans l'injection de dépendances avec Symfony 3.3" de Christophe Coevoet

C'est un peu magique..?

• Plus besoin de configurer ses dépendances
• Plus besoin de déclarer soi-même ses services
• On s'y fait très vite :D #faignants

Flex n'est pas encore stable ¯\_(ツ)_/¯

Flex n'est pas encore stable ¯\_(ツ)_/¯

• public/ s'appelait web/
• config/ s'appelait etc/

Flex n'est pas encore stable ¯\_(ツ)_/¯

Release stable avec Symfony 3.4 / 4.0

• Aucune obligation de migrer tout de suite
• Aucune obligation d'utiliser Symfony Flex

Protips

• Ne pas supprimer un fichier de config généré : sera recréé au prochain run de Flex
• Surcharge des templates => src/Resources/views
• Traductions YAML : utiliser l'extension .yml

Un exemple : Slack Secret Santa

• https://slack-secret-santa.herokuapp.com/
• PRs de migration vers Flex

Ressources

• https://symfony.com/doc/current/setup/flex.html