Symfony (WR319D / WRA319D)
David Annebicque // Patrice Gommery
Organisation de la ressource
- 10 séances
Intervenants
- David Annebicque (AB)
- Patrice Gommery (CD)
Evaluation de la ressource WR319D / WRA319D
- 1 évaluation TP Noté de 1.5h
- La SAE301
Pré-requis
- PHP (tableaux, boucles, tests, variables ...)
- Programmation Orientée Objet (WR313a/WR313e)
- Structure MVC (dès demain !)
- Base de données
Support
Le support est disponible ici : https://cours.davidannebicque.fr/symfony
CM N°1
- Qu'est ce que Symfony
- Les grands concepts d'un framework
Déroulé des TD et TP
Lien fort entre WR313 et WR319, objectif découvrir par Symfony les usages de la POO, et appréhender le framewrok pour constuire vos premiers sites.
La suite du programme en S3
- Contrôleurs, Routes
- Templates et Vues (Twig)
- Base de données (ORM)
- Formulaires
- Mails
Démonstration...
Vous ne comprendrez pas tout aujourd'hui et c'est normal ! Mais vous allez voir que c'est très simple et que vous allez pouvoir créer des sites web très rapidement.
Démonstration...
Recréons DUTAF avec Symfony en moins de 15 minutes (hors téléchargement... et intégration)
Préambule
On va nécessairement faire des impasses sur les concepts se cachant derrières certaines parties du cours. Nous y reviendrons soit au travers de la POO (WR313a/WR313e), soit au travers de la SAE301, soit dans les prochains semestres (S4->S6), ou encore dans vos entreprises pour les alternants.
Préambule 2
Nous utiliserons le terminal et le maker qui va générer du code et des fichiers pour nous. C'est un outil très pratique pour démarrer rapidement. Mais il est important de comprendre ce qu'il fait derrière.
Définition générale
En programmation informatique, un framework ou structure logicielle est un ensemble cohérent de composants logiciels structurels, qui sert à créer les fondations ainsi que les grandes lignes de tout ou d’une partie d’un logiciel (architecture). Un framework se distingue d’une simple bibliothèque logicielle principalement par :
- son caractère générique,
- faiblement spécialisé,
- contrairement à certaines bibliothèques ;
Définition générale
Un framework peut à ce titre être constitué de plusieurs bibliothèques chacune spécialisée dans un domaine. Un framework peut néanmoins être spécialisé, sur un langage particulier, une plateforme spécifique, un domaine particulier : reporting, mapping, etc. ;
Le cadre de travail (traduction littérale de l’anglais : framework) qu’il impose de par sa construction même, guidant l’architecture logicielle voire conduisant le développeur à respecter certains patterns (modèle de conception) ; les bibliothèques le constituant sont alors organisées selon le même paradigme.
Avantages
- Pour éviter des erreurs dans l’organisation des appels
- Éviter les appels directs aux commandes PHP
- Préférer les versions des Frameworks qui apportent leur lot de contrôles.
- Plus grand portabilité du code
- Ne pas réinventer la roue
- La gestion des formulaire, des utilisateurs, ...
Inconvénients
- Apprentissage d’une couche supplémentaire
- La majorité des fonctionnalités PHP sont redéfinies
- Généralement apprentissage d’un moteur de template
- Apprentissage de l’utilisation du framework choisit : ses classes, ses objets, sa logique !
Les frameworks populaire en PHP
Symfony
Symfony
- Framework MVC en PHP 5 (V2), PHP 7 (V3, V4 et V5 ), PHP8 (V6) libre
- Développé en 2005 par la société Sensio pour répondre à ses besoins
- Division de la société Sensio en deux entités l’agence Web et l’entreprise qui soutient et maintient Symfony : SensioLabs, dirigée par Fabien Potencier, l’auteur de Symfony
- Framework français !, De renommée mondiale
- Premier framework en France et en Europe
Symfony : Avantages
- Connectable à presque tous les SGBD
- De nombreux Bundles, contributeurs, utilisateurs
- Moteur de template puissant et simple
Symfony : Des bundles "natifs"
- Pour gérer la sécurité
- Pour les formulaires et leurs validations
- Pour envoyer des mails (Mailer)
- Pour manipuler du texte (String)
- Pour gérer les fichiers (Filesystem)
- Pour faire du JS (Webpack-Encore / Stimulus / Symfony UX)
- ...toute la liste ici ...
Symfony : Des bundles "de la communauté"
- Pour créer un backoffice
- Pour gérer l'upload de fichiers
- Pour gérer des fichiers word, excel, PDF...
- ...toute la liste ici ...
Releases Process
Symfony évolution...
- Symfony 4
- Skeleton et Flex
- Symfony 5
- Standardisation et simplification
- Symfony 6
- PHP 8
- Symfony 6.1
- PHP 8.1
Principe de fonctionnement
Symfony - Eco-système
Symfony nécessite tout un environnement pour fonctionner. Symfony implique aussi différents "langages" et utilise un vocabulaire spécifique (souvent repris dans d'autres frameworks).
Composer
Composer est un logiciel gestionnaire de dépendances libre écrit en PHP. Il permet à ses utilisateurs de déclarer et d'installer les bibliothèques dont le projet principal a besoin. Développé, depuis 2011, par Nils Adermann et Jordi Boggiano (qui continuent encore aujourd'hui à le maintenir), il est aujourd'hui en version 2.
Le logiciel Composer trouve son équivalent pour le front avec npm ou Yarn
ENTITÉ (EQ. DU MODÈLE)
Une entité est une classe PHP ! Elle peut faire le lien avec une base de données, on y déclare les différentes propriétés accessibles; Symfony utilise par défaut un outil de persistence de données : Doctrine pour lier une entité à une table de base de données.
ORM : OBJECT RELATIONNAL MAPPING
Système permettant de se libérer des requêtes pour la base de données. Il se charge de générer les requêtes à effectuer sur les Entités spécifiées. Il existe plusieurs ORM, dans Symfony, il s'agit de Doctrine.
Repository
Classe PHP qui fait le pont entre une entité et l'ORM, il permet notamment de structurer des requêtes complexes.
YAML
Format de structuration de données très utilisé dans Symfony, mais on peut utiliser du XML, du PHP ou encore les annotations (PHP 7) ou les attributs (php 8), les fichiers de configurations par défaut sont en YAML.
Annotations
Commentaire PHP directement dans les classes utiles (controller, entité, ...) interprété par Symfony pour générer des fichiers de configuration ;
Attributes
Les Attributes sont la nouvelle version des annotations, intégrés nativement dans les versions 8 et supérieures de PHP. Les Attributes sont une forme de données structurées, qui permet d'ajouter des métadonnées à nos déclarations de classes, propriétés, méthodes, fonctions, paramètres et constantes. Ils vont nous permettre de définir de la configuration au plus près du code, directement sur nos déclarations.
Routes
Les routes permettent de faire un lien entre une URL et un contrôleur.
Bundles
Sorte de modules Symfony qui peuvent contenir tout et n'importe quoi ; C'est la force de Symfony les modules peuvent fonctionner indépendamment et même sur d'autres structures PHP, autre framework etc.
ENVIRONNEMENTS
Symfony propose par défaut 2 environnements : dev et prod qui permettent de donner des configs différentes en fonction de l'environnement de travail ;
- dev permet une utilisation sans cache avec des outils de dev comme le profiler ;
- prod lui permet d'utiliser le site avec le cache et sans aucun message d'erreurs.
De plus on peut configurer les différents environnements pour par exemple rediriger tous les mails vers toto@titi.com en dev et laisser le fonctionnement normal pour prod ; pratique pour les debugs.
ENVIRONNEMENTS
Symfony propose également de définir autant d'environnement que nécessaire afin d'avoir différentes configurations. Le changement d'un environnement à un autre se faire en modifiant la ligne suivante dans le fichier ".env" (ou .env.local) :
###> symfony/framework-bundle ###
APP_ENV=devProfiler
Le profiler est un outil puissant (et indispensable) pour débuger une application. Par défaut le profiler n'est pas installé. Pour l'ajouter il faut exécuter la commande suivante :
composer require profiler --devLe profiler est toujours visible en bas de la page en mode développement.
Maker
Le maker est un outil puissant pour générer du code, et des éléments dans notre projet. Par défaut le maker n'est pas installé. Pour l'ajouter il faut exécuter la commande suivante :
composer require maker --devIl est assez facile de modifier le maker pour que le code généré corresponde exactement à notre projet et nos attentes.
Moteur de template
Un moteur de template est un "langage", un "outil" permettant d'écrire les vues (partie visible) de manière efficace et rapide. Symfony utilise Twig par défaut.