Introduction

Présentation

Découvrir et appréhender un framework PHP web.

Pré-requis

• PHP

• Programmation Orientée Objet

• Structure MVC

• Base de données

Organisation

• 20 heures de TD

• 12 heures de TP

• LPDEV : voir planning sur la page dédiée : LP DEV

• Notes :

  • 1 évaluation écrite (dernier TD)

  • 1 note pratique (lors du dernier TP)

Rappels des concepts du MVC

Schéma de principe du MVC

C: Controller / Contrôleur

C'est lui qui reçoit l'interaction (la demande/request) du visiteur. Il se charge de récupérer les éléments nécessaires auprès du/des modèle(s). Il transmets toutes les données nécessaires à la vue.

V: View / Vue

C'est lui qui apporte la réponse (response/render) au visiteur. Une vue peut être une page web, un fichier pdf, ... Ne se préoccupe que de l'affiche des informations, n'assure aucun traitement

M: Model / Modèle

C'est lui qui s'occupe de récupérer et préparer les données. Le modèle peut être en lien avec une base de données. Le modèle peut être en lien avec des API. Le modèle prépare les données pour qu'elles soient facilement manipulables par la vue.

Notion de Framework

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 ;

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.

Framework Orienté Objet

Un framework dit orienté objet est typiquement composé de classes mères qui seront dérivées et étendues par héritage en fonction des besoins spécifiques à chaque logiciel qui utilise le framework.

Le développeur qui utilise le framework pourra personnaliser les éléments principaux du framework par extension, en utilisant le mécanisme d’héritage : créer des nouvelles classes qui contiennent toutes les fonctionnalités que met en place le framework, et en plus ses fonctionnalités propres, créées par le développeur en fonction des besoins spécifiques à son application.

Avantages	Inconvénients
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, ...	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 10 frameworks les plus populaires en PHP (2019).

Article comparatifs des 10 frameworks PHP les plus populaires de 2019: https://coderseye.com/best-php-frameworks-for-web-developers/

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

• Depuis la V4, Symfony est très léger et très rapide

Roadmap des versions de Symfony

Toutes les informations sur l'évolution du framework : https://symfony.com/releases

Symfony V4 : Un retour aux bases

Avec sa version 4 (et suivante), Symfony à pris un virage important par rapport aux précédentes versions, et se rapproche des "standards" de la majorité des framework, mais à aussi grandement optimisé son poids et sa vitesse d'exécution. Dans une grande logique de simplification Symfony à également automatisé de nombreux mécanismes qui auparavant auraient impliqués de nombreuses lignes de configuration.

SKELETON ET FLEX

La version Skeleton de Symfony : Apporte un framework Symfony très léger, avec le minimum pour faire fonctionner un controller.

La version 4 de Symfony introduit Flex qui est un gestionnaire de "recipes" (recettes), qui permet l'ajout de fonctionnalité à Symfony (gestionnaire de vue, de base de données, d'email, ...) avec un mécanisme d'auto-configuration de ces "bundles". Cela permet donc de fournir par défaut un framework très léger, avec une grande facilité pour lui ajouter tous les composants nécessaires, sans en mettre plus que nécessaire.

Par défaut Symfony version Skeleton ne sais rien faire ! Par contre, il n'embarque pas des dizaines de Bundles dont vous n'aurez peut être jamais besoin (fonctionnement des versions 2 et 3 avec plus de 46 bundles par défaut, contre 10 aujourd'hui).

Grâce à Flex vous installez rapidement le nécessaire pour répondre à votre projet.

Symfony V5 : Continuer vers la simplification et la standardisation

Avec sa version 5 (et suivante), Symfony continue sa simplification en facilitant l'usage de nombreux composants redéfinis et devenus génériques.

Une lecture intéressante sur la logique d'évolution du framework Symfony : https://www.disko.fr/reflexions/technique/symfony-4-4-5-0-les-nouveautes-venir/

Installations

Configuration requise pour votre serveur

• Un serveur Web

• PHP 7.2.5 ou supérieur, PHP8 ou supérieur pour la version 6

• Git (différent de GitHub)

• Le gestionnaire de dépendance Composer

• Le nouveau gestionnaire d'installation de Symfony : https://symfony.com/download

• Une maîtrise de son système d'exploitation ! (fichiers cachés, variables PATH, php.ini, console...)

Vous pouvez suivre aussi les éléments de la documentation officielle : https://symfony.com/doc/current/setup.html

Exercice 1 : Installation des outils

• Installer un serveur local (si ce n'est pas déjà fait)

• Installer Git

• Installer Composer

Pour les utilisateurs de Mac ou Linux

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

//puis
sudo mv composer.phar /usr/local/bin/composer

Pour les utilisateurs de Windows

Télécharger : https://getcomposer.org/download/2.2.5/composer.phar (ou plus récente sur le site), puis créer une variable d'environnement dans Windows (PATH)

• Installer l'utilitaire Symfony (facultatif)

• Pour les utilisateurs de Windows : Installer une vraie console PowerShell (à partir de windows 10) ou https://cmder.net/ par exemple.

• Installer un vraie IDE ! (PhpStorm).

Pensez à vérifier que tout fonctionne correctement :

php -v
composer -v
symfony -v
git --version

Vous devez vous afficher les numéros de version. Corrigez les messages d'erreurs éventuels.

Vous pouvez tester si votre système est prêt à installer Symfony (si vous avez installé l'utilitaire Symfony) :

symfony check:requirements

Exercice 2 : Installation de Symfony.

Symfony propose deux versions :

• La version skeleton, la plus minimaliste et légère, qui n'installe que le stricte minimum, vous laissant ainsi la liberté d'ajouter les composants dont vous avez réellement besoin. Avec cette solution vous pouvez développer des API, des micro-services, ou une application en console

• Le version website-skeleton, qui va installer tout le nécessaire pour faire fonctionner un site (vues, annotations, base de données, ...)

On va privilégier la version skeleton.

Placez-vous dans le répertoire où vous souhaitez installer Symfony (www, public_html, ...) et exécutez la commande suivante (cela va créer un répertoire du nom de votre projet).

symfony new nomDuProjet

#ou avec Composer
 composer create-project symfony/skeleton nomDuProjet
 
 # Version 5.4
 composer create-project symfony/skeleton:"^5.4" nomDuProjet

Par défaut cette commande récupère la dernière version stable de Symfony (actuellement la version 6.1). Le téléchargement peut prendre quelques minutes.

Il est possible de tester immédiatement le bon fonctionnement de l'installation en utilisant la ligne de commande intégrée dans l'utilitaire Symfony :

cd nomDuProjet

Si vous vous rendez sur l'URL http://localhost/nomDuProjet/public/index.php vous devriez voir la page d'accueil de Symfony avec le numéro de la version installée.

Symfony embarque (et installe) un serveur Web très puissant qui permet de tester le fonctionnement d'un site. Il est possible de gérer les url sécurisées (https), la simulation d'un domaine, ...

Symfony server:start (si vous avez installé l'utilitaire)