Dev - Tutorial
Symfony 5
Dev - Tutorial - 09/08/2021
Table des matières
1 Les outils
1.1 Wamp ou Laragon
1.2 Symfony Cli
1.3 Composer
1.4 Git
2 Vérifications des pré-requis
2.1 Méthode
2.2 Méthode
2.3 Variables d’environnement
3 Création d’une application Symfony
4 Exécuter des applications Symfony
4.1 Activer TLS
4.2 Serveur Symfony ou php
4.2.1 Serveur web local Symfony
4.2.2 Serveur interne php
1 Les outils
1.1 Wamp ou Laragon
Il vous faut PHP 7.2 au minimum, Phpmyadmin et Mysql.
En passant par Wamp ou Laragon, vous installerez tous cela en une seule fois.
https://www.wampserver.com/
https://laragon.org/download/
1.2 Symfony Cli
Vous installez également Symfony Cli . Cela crée un binaire appelé Symfony qui fournit tous les outils dont vous avez besoin pour développer et exécuter votre application Symfony localement, il exécutera les différentes commandes de Symfony dans un terminal.
https://symfony.com/download
1.3 Composer
Ensuite installez Composer , qui est utilisé pour installer les packages PHP.
https://getcomposer.org/download/
1.4 Git
Installer Git, logiciel de gestion de versions décentralisé.
Il s’agit d’un programme qui créé différentes versions d’un projet au fur et à mesure que les fichiers sont édités.
Il permet de garder une trace des versions antérieures du projet. Très utile en cas de debug.
https://git-scm.com/
2 Vérifications des pré-requis
2.1 Méthode 1
Dans votre terminal, tapez :
>composer -V
Il indiquera la version de Composer, l’important c’est de voir qu’il est bien installé.
>git --version
Vérifiez que vous possédez bien Git.
>php -v
Il indiquera la version de PHP, et il vous faut au minimum la 7.2.
Si vous avez un message d’erreur pour php -v, le « path » n’est pas configuré dans votre variable d’environnement de windows (voir le chap 2.3)
2.2 Méthode 2
Dans votre terminal, tapez :
>symfony check:requirements
Il vous indiquera si tout est bon ou sinon suivre les remarques affichées.
2.3 Variables d’environnement
Ces variables définissent les configurations par défaut de chaque programme qu’il est possible d’utiliser en ligne de commande.
Où trouver les variables d’environnement?
En ce qui concerne Windows, il y a plusieurs façons de les trouver, dont voici la plus classique.
Dans le menu Démarrer de Windows, cliquez sur Panneau de configuration (sous Windows 10, tapez panneau de configuration dans la barre de recherche , vous tomberez dessus)
Cliquez ensuite sur Système, puis sur Paramètres système avancés.
Vous pouvez enfin cliquer sur Variables d’environnement :
Dans la fenêtre Variables système, scrollez jusqu’à la variable Path et cliquez dessus.
Vous allez pouvoir ajouter à tous les chemins déjà présents le chemin vers votre exécutable PHP.
Mais où se trouve l’exécutable PHP ?
Nous avons auparavant installé WAMP (ou XAMPP ou MAMP ou LARAGON) qui nous offre un serveur PHP, c’est dans les dossiers de WAMP que se trouve l’exécutable.
Dans le dossier c:/wamp64/bin/php se trouvent les dossiers de chaque version disponible du serveur PHP.
Cliquez sur la dernière version disponible de PHP (ici php7.3.1)
Sélectionnez l’adresse, sur la barre d’adresse : C:\wamp64\bin\php\php7.3.1
Ajoutez-la dans votre variable d’environnement Path.
Faites ok puis refermer tout les fenêtres.
3 Création d’une application Symfony
Créer un dossier n’importe ou dans votre pc mais qui doit être facile à retrouver et nommer le, par exemple : my-project.
Ouvrez votre terminal de console et exécutez l'une de ces commandes pour créer une nouvelle application Symfony :
>cd my-project
>symfony new my_project_name --version=next –full
ou
>cd my-project
>symfony new my_project_name --version=next
La seule différence entre ces deux commandes est le nombre de packages installés par défaut.
L'option --full installe tous les packages dont vous avez généralement besoin pour créer des applications Web, la taille de l'installation sera donc plus importante.
Quelle que soit la commande que vous exécutez pour créer l'application Symfony.
Tous créeront un nouveau my_project_name/répertoire, y téléchargeront des dépendances et généreront même les répertoires et fichiers de base dont vous aurez besoin pour commencer.
En d'autres termes, votre nouvelle application est prête !
Personnellement je travaille avec le version basique et rajoute mes packages seulement si nécessaire, pour alléger mon application.
4 Exécuter des applications Symfony
4.1 Activer TLS
Il est important de parcourir localement la version sécurisée de vos applications pour détecter rapidement les problèmes de contenu mixte et pour exécuter des bibliothèques qui ne s'exécutent qu'en HTTPS.
Traditionnellement, cela a été pénible et compliqué à mettre en place, mais le serveur Symfony automatise tout.
Tout d'abord, exécutez cette commande :
>cd my-project
>symfony server:ca:install
Cette commande crée une autorité de certification locale, l'enregistre dans votre magasin de confiance système, l'enregistre dans Firefox (cela n'est requis que pour ce navigateur) et crée un certificat par défaut pour localhost et 127.0.0.1.
En d'autres termes, il fait tout pour vous.
Avant de parcourir votre application locale avec HTTPS au lieu de HTTP, redémarrez son serveur en l'arrêtant et en le redémarrant.
4.2 Serveur Symfony ou php
4.2.1 Serveur web local Symfony
Cependant, pour le développement local, le moyen le plus pratique d'exécuter Symfony est d'utiliser le serveur Web local fourni par le Symfony binaire.
Ce serveur local prend entre autres en charge HTTP/2, les requêtes simultanées, TLS/SSL et la génération automatique de certificats de sécurité.
Ouvrez votre terminal de console, accédez à votre nouveau répertoire de projet et démarrez le serveur Web local comme suit :
>cd my-project
>symfony serve
Ouvrez votre navigateur et accédez à http://localhost:8000/ .
Si tout fonctionne, vous verrez une page d'accueil.
Plus tard, lorsque vous avez fini de travailler, arrêtez le serveur en appuyant sur Ctrl+C depuis votre terminal.
Vous pouvez utiliser un autre port que 8000 pour votre serveur. Il suffit de le préciser.
Essayez d’exécuter par exemple : symfony server:start --port=7700
4.2.2 Serveur interne php
Ouvrez votre terminal de console, accédez à votre nouveau répertoire de projet et démarrez le serveur Web local comme suit :
>cd my-project
>php -S localhost:8000 -t public
Ouvrez votre navigateur et accédez à http://localhost:8000/
Si tout fonctionne, vous verrez une page d'accueil.
Plus tard, lorsque vous avez fini de travailler, arrêtez le serveur en appuyant sur Ctrl+C depuis votre terminal.
