1
Symfony 2.0
AHMED ABATAL
ABATALAHMED1@GMAIL.COM
COURS SF 2.0 - 2014
2
Chapitre 1 :
Vue d'ensemble de Symfony 2
3
Symfony 2, un Framework
PHP
 Symfony2 est un Framework PHP open source , c' est-à-dire une
boite à outils faite en PHP dans but de vous simplifier le
développement des applications et sites web.
 Un Framework Français créé par la société SensioLab, en sa
première version sortie en 2005
 Une communauté active qui utilise le framework et qui contribue
en retour
 Une documentation de qualité et régulièrement mise à jour
 Un code source maintenu par des développeurs attitrés
 Un code qui respecte les standards de programmation
 Un support à long terme garanti et des mises à jour qui ne
cassent pas la compatibilité
4
Symfony 2, un Framework
PHP
 Symfony 2 nécessite une version de PHP supérieure ou égale
à 5.3.3 et propose une série de fonctionnalités avancées telles
que :
 un système de configuration en cascade utilisant le langage YAML ;
 le support d’Ajax ;
 l’internationalisation des projets ;
 un générateur de backoffice ;
 un système de mise en cache …
5
Télécharger Symfony 2.2
 Disponible sur le lien : http://symfony.com/download
 Deux options de téléchargement :
1. Version " without vendors" . Les librairies tierces seront ainsi
téléchargées via Git en exécutant le script « bin/vendors » situé
dans l'archive
exécutez la commande : php bin/vendors install
1. Version simple, avec les vendors, pour avoir toutes les librairies
incluses
6
Première Installation 1/3
 Décompressez les fichiers dans votre répertoire web
habituel, par exemple "C:wampwww" pour Windows
 Vérifier votre configuration PHP en accédant à l’url :
« http://localhost/symfony/web/config.php »
7
Première Installation 2/3
 Configuration de votre instance Symfony :
http://localhost/symfony/web/app_dev.php/_configurator
 Configuration en deux étapes :
1. Données d’accès à la base de donnée
2. Génération d’un hashcode utilisé pour des raisons de
sécurités
8
Première Installation 3/3
 C’est bon ! Vous pouvez maintenant vous connecter à votre
premier application Symfony 2 :
http://localhost/symfony/web/app_dev.php/
9
Arborescence des fichiers
 4 principaux répertoires :
1. app/ : Contient les fichiers des applications sauf
le code source, notamment; la configuration, le
cache, les fichiers logs etc...
2. vendor/ : contient toutes les librairies externes,
comme Doctrine, Twig, Swiftmailer…
3. Web/ : Ce répertoire contient tous les fichiers
destinés aux visiteurs : images , fichiers CSS et
JavaScript … Il contient également le
contrôleur frontal (app.php), dont nous
parlerons après. (NB: c’est le seul repertoire qui
doit être accessible par les internautes)
4. src/ : contient le code source des applications
organisé sous forme de bundles (par défaut il
contient un bundle d’exemple fourni par
Symfony)
10
Symfony et
MVC 2
11
La notion de « Bundle »
 Un bundle est une brique de votre application, permet de
regrouper toutes les ressources
 Quel intérêt ?
E n plus d' organiser votre code par fonctionnalité, la découpe en
bundles permet l'échange de bundles entre applications ! Cela
signifie que vous pouvez développer une fonctionnalité, puis la
partager avec d'autres développeurs ou encore la réutiliser dans
un de vos autres projets. Et de même utiliser des bundles d’autre
développeurs
 Dans Symfony2, chaque partie de votre site est un bundle
 Les Bundles de la communauté : http://knpbundles.com/
12
Créer un « Bundle »
 Dans la racine de Symfony, taper la commande :
php app/console generate:bundle
Ensuite suivre les étapes sur la consoles
13
Créer un « Bundle »
14Générer un bundle en ligne de commande
Structure d’un bundle
 Controller/ : Contient les contrôleurs
 DependencyInjection/ : les informations
sur votre bundles
 Ressources/
--- config/ : Contient les fichier de
configuration, notamment les routes
--- doc/ : contient la documentation
--- public/ : Contient les fichiers publics de
votre bundle : fichiers CSS et JavaScript,
images, etc
--- translations/
--- views / : Contient les vues de notre
bundle ( les templates Twig )
 Tests/ : Contient vos éventuels tests
unitaires et fonctionnels.
15
Bundle :
Controller et View
16
 Récupère les informations http
 Renvois la réponse.
 Contient la logique de
l’application.
 Considéré comme chef
d’orchestre qui fait la liaison entre
tous les éléments.
 Afficher le résultat de l’ action
 Assurer la séparation entre le
code HTML et le code PHP,
 Utilisation du moteur de template
Twig.
Créer un Bundle
17Actions et Vues
Manipuler les variables
envoyées en POST et/ou GET
 Récupérer l ' objet Request depuis notre contrôleur
 Utiliser l’objet pour récupérer les variables GET et/ou POST
GET : $request->query->get(‘nom_variable’)
POST : $request->request>get(‘nom_variable’)
Et Aussi les Cookies : $request->cookies->get(‘nom_variable’)
 Pour les sessions :
$session = $this->get('session');
$session->get('user_id')
18
La configuration : Système
d’annotation
 Plusieurs possibilité : yml, xml et annotation
 L’annotation est le moyen le plus rapide et simple pour des
projets de petite et moyenne taille
 Comment ça marche ?
19
Commentaire du genre :
@MotCles(Valeur2, Valeur2…)
Les Routes en Symfony
 Les routes en Symfony2 déterminent quel contrôleur exécuter en
fonction de l’URL appelé par l’internaute
 Annotation à ajouter au niveau des classes PHP des contrôleurs
@Route([URL], [Param 1], [Param 2]… )
Important : n’oublier pas d’appeler la classe Route par le
namespace suivant
use SensioBundleFrameworkExtraBundleConfigurationRoute
20
Les routes :
Règles 1/6
 Declarer une route simple pour un contrôleur
21
Les routes :
Règles 2/6
 Pour chaque route on peut definer :
1. /{nom_variable}  à passer en paramètre de la méthode
2. requierements={“nom_variable” = [expression régulière]}
3. defaults={“nom_variable” = “”valeur par defaut}
22
Les routes :
Règles 3/6
 Il est aussi possible de définir plusieurs URL’s au même
controleur
23
Les routes :
Règles 4/6
 Important : Pour que Symfony prend en compte les
annotations de routes définis dans le contrôleur, il faut
l’activer en ajouter les lignes suivantes au fichier de config
“app/config/routing.yml”
Par fichier :
Par répertoire
24
Les routes :
Règles 5/6
 Définir pour chaque contrôleur un prefix d’url
Lors de l’activation
Au niveau du fichier
25
Les routes :
Règles 6/6
 Définir un nom pour chaque route , cela peut être utiliser pour
générer des liens dans les vues
 Chaque route peut correspondre à une methode GET ou POST ou
les deux
26
Symfony Possède un
système de cache
 Pensez à vider le cache, des fois il suffit de le faire
pour votre code fonctionne correctement :
php app/console cache:clear
27

Presentation Symfony2

  • 1.
  • 2.
  • 3.
    Chapitre 1 : Vued'ensemble de Symfony 2 3
  • 4.
    Symfony 2, unFramework PHP  Symfony2 est un Framework PHP open source , c' est-à-dire une boite à outils faite en PHP dans but de vous simplifier le développement des applications et sites web.  Un Framework Français créé par la société SensioLab, en sa première version sortie en 2005  Une communauté active qui utilise le framework et qui contribue en retour  Une documentation de qualité et régulièrement mise à jour  Un code source maintenu par des développeurs attitrés  Un code qui respecte les standards de programmation  Un support à long terme garanti et des mises à jour qui ne cassent pas la compatibilité 4
  • 5.
    Symfony 2, unFramework PHP  Symfony 2 nécessite une version de PHP supérieure ou égale à 5.3.3 et propose une série de fonctionnalités avancées telles que :  un système de configuration en cascade utilisant le langage YAML ;  le support d’Ajax ;  l’internationalisation des projets ;  un générateur de backoffice ;  un système de mise en cache … 5
  • 6.
    Télécharger Symfony 2.2 Disponible sur le lien : http://symfony.com/download  Deux options de téléchargement : 1. Version " without vendors" . Les librairies tierces seront ainsi téléchargées via Git en exécutant le script « bin/vendors » situé dans l'archive exécutez la commande : php bin/vendors install 1. Version simple, avec les vendors, pour avoir toutes les librairies incluses 6
  • 7.
    Première Installation 1/3 Décompressez les fichiers dans votre répertoire web habituel, par exemple "C:wampwww" pour Windows  Vérifier votre configuration PHP en accédant à l’url : « http://localhost/symfony/web/config.php » 7
  • 8.
    Première Installation 2/3 Configuration de votre instance Symfony : http://localhost/symfony/web/app_dev.php/_configurator  Configuration en deux étapes : 1. Données d’accès à la base de donnée 2. Génération d’un hashcode utilisé pour des raisons de sécurités 8
  • 9.
    Première Installation 3/3 C’est bon ! Vous pouvez maintenant vous connecter à votre premier application Symfony 2 : http://localhost/symfony/web/app_dev.php/ 9
  • 10.
    Arborescence des fichiers 4 principaux répertoires : 1. app/ : Contient les fichiers des applications sauf le code source, notamment; la configuration, le cache, les fichiers logs etc... 2. vendor/ : contient toutes les librairies externes, comme Doctrine, Twig, Swiftmailer… 3. Web/ : Ce répertoire contient tous les fichiers destinés aux visiteurs : images , fichiers CSS et JavaScript … Il contient également le contrôleur frontal (app.php), dont nous parlerons après. (NB: c’est le seul repertoire qui doit être accessible par les internautes) 4. src/ : contient le code source des applications organisé sous forme de bundles (par défaut il contient un bundle d’exemple fourni par Symfony) 10
  • 11.
  • 12.
    La notion de« Bundle »  Un bundle est une brique de votre application, permet de regrouper toutes les ressources  Quel intérêt ? E n plus d' organiser votre code par fonctionnalité, la découpe en bundles permet l'échange de bundles entre applications ! Cela signifie que vous pouvez développer une fonctionnalité, puis la partager avec d'autres développeurs ou encore la réutiliser dans un de vos autres projets. Et de même utiliser des bundles d’autre développeurs  Dans Symfony2, chaque partie de votre site est un bundle  Les Bundles de la communauté : http://knpbundles.com/ 12
  • 13.
    Créer un «Bundle »  Dans la racine de Symfony, taper la commande : php app/console generate:bundle Ensuite suivre les étapes sur la consoles 13
  • 14.
    Créer un «Bundle » 14Générer un bundle en ligne de commande
  • 15.
    Structure d’un bundle Controller/ : Contient les contrôleurs  DependencyInjection/ : les informations sur votre bundles  Ressources/ --- config/ : Contient les fichier de configuration, notamment les routes --- doc/ : contient la documentation --- public/ : Contient les fichiers publics de votre bundle : fichiers CSS et JavaScript, images, etc --- translations/ --- views / : Contient les vues de notre bundle ( les templates Twig )  Tests/ : Contient vos éventuels tests unitaires et fonctionnels. 15
  • 16.
    Bundle : Controller etView 16  Récupère les informations http  Renvois la réponse.  Contient la logique de l’application.  Considéré comme chef d’orchestre qui fait la liaison entre tous les éléments.  Afficher le résultat de l’ action  Assurer la séparation entre le code HTML et le code PHP,  Utilisation du moteur de template Twig.
  • 17.
  • 18.
    Manipuler les variables envoyéesen POST et/ou GET  Récupérer l ' objet Request depuis notre contrôleur  Utiliser l’objet pour récupérer les variables GET et/ou POST GET : $request->query->get(‘nom_variable’) POST : $request->request>get(‘nom_variable’) Et Aussi les Cookies : $request->cookies->get(‘nom_variable’)  Pour les sessions : $session = $this->get('session'); $session->get('user_id') 18
  • 19.
    La configuration :Système d’annotation  Plusieurs possibilité : yml, xml et annotation  L’annotation est le moyen le plus rapide et simple pour des projets de petite et moyenne taille  Comment ça marche ? 19 Commentaire du genre : @MotCles(Valeur2, Valeur2…)
  • 20.
    Les Routes enSymfony  Les routes en Symfony2 déterminent quel contrôleur exécuter en fonction de l’URL appelé par l’internaute  Annotation à ajouter au niveau des classes PHP des contrôleurs @Route([URL], [Param 1], [Param 2]… ) Important : n’oublier pas d’appeler la classe Route par le namespace suivant use SensioBundleFrameworkExtraBundleConfigurationRoute 20
  • 21.
    Les routes : Règles1/6  Declarer une route simple pour un contrôleur 21
  • 22.
    Les routes : Règles2/6  Pour chaque route on peut definer : 1. /{nom_variable}  à passer en paramètre de la méthode 2. requierements={“nom_variable” = [expression régulière]} 3. defaults={“nom_variable” = “”valeur par defaut} 22
  • 23.
    Les routes : Règles3/6  Il est aussi possible de définir plusieurs URL’s au même controleur 23
  • 24.
    Les routes : Règles4/6  Important : Pour que Symfony prend en compte les annotations de routes définis dans le contrôleur, il faut l’activer en ajouter les lignes suivantes au fichier de config “app/config/routing.yml” Par fichier : Par répertoire 24
  • 25.
    Les routes : Règles5/6  Définir pour chaque contrôleur un prefix d’url Lors de l’activation Au niveau du fichier 25
  • 26.
    Les routes : Règles6/6  Définir un nom pour chaque route , cela peut être utiliser pour générer des liens dans les vues  Chaque route peut correspondre à une methode GET ou POST ou les deux 26
  • 27.
    Symfony Possède un systèmede cache  Pensez à vider le cache, des fois il suffit de le faire pour votre code fonctionne correctement : php app/console cache:clear 27