Démarrer avec symfony

Création d’un nouveau projet Symfony à l’aide de Symfony Installer

Le [Symfony Installer][1] est un outil en ligne de commande qui vous aide à créer de nouvelles applications Symfony. Il nécessite PHP 5.4 ou supérieur.

Téléchargement et installation de Symfony Installer sur Linux / MacOS

Ouvrez un terminal et exécutez les commandes suivantes :

sudo mkdir -p /usr/local/bin
sudo curl -LsS https://symfony.com/installer -o /usr/local/bin/symfony
sudo chmod a+x /usr/local/bin/symfony

Cela crée un exécutable symfony global qui peut être appelé de n’importe où. Vous n’avez à le faire qu’une seule fois : vous pouvez désormais créer autant de projets Symfony que vous le souhaitez.

Création d’un nouveau projet avec la dernière version de Symfony

Une fois le programme d’installation installé, vous pouvez l’utiliser pour créer un nouveau projet Symfony. Exécutez la commande suivante :

symfony new my_project_name

Cette commande créera un nouveau répertoire (appelé my_project_name) contenant la version la plus récente de [Symfony Standard Edition][2]. Il installera également toutes ses dépendances (y compris les composants Symfony réels) à l’aide de Composer.

Créer un nouveau projet en utilisant une version spécifique de Symfony

Si vous souhaitez sélectionner une version spécifique de Symfony au lieu de la dernière, vous pouvez utiliser le deuxième argument facultatif de la commande new.

Pour sélectionner une version mineure :

symfony new my_project_name 3.2

Pour sélectionner une version de correctif :

symfony new my_project_name 3.2.9

Pour sélectionner une version bêta ou une release candidate :

symfony new my_project 2.7.0-BETA1
symfony new my_project 2.7.0-RC1

Pour sélectionner la version de support à long terme (LTS) la plus récente :

symfony new my_project_name lts

[1] : https://symfony.com/doc/current/setup.html#creating-symfony-applications [2] : https://github.com/symfony/symfony-standard

Création d’un nouveau projet Symfony à l’aide de Composer

Si, pour une raison quelconque, l’utilisation de [Symfony Installer][1] n’est pas une option, vous pouvez également créer un nouveau projet à l’aide de Composer. Tout d’abord, assurez-vous d’avoir [installé Composer][2].

Ensuite, vous pouvez utiliser la commande create-project pour créer un nouveau projet :

composer create-project symfony/framework-standard-edition my_project_name

Semblable à l’installateur Symfony, cela installera la dernière version de [Symfony Standard Edition][3] dans un répertoire appelé my_project_name et installera ensuite ses dépendances (y compris les composants Symfony).

Installer une version spécifique de Symfony

Comme avec l’installateur Symfony, vous pouvez sélectionner une version spécifique de Symfony en fournissant un troisième argument facultatif :

composer create-project symfony/framework-standard-edition my_project_name "2.8.*"

Notez cependant que tous les alias de version (comme lts par exemple) ne sont pas disponibles ici.

[1] : https://www.wikiod.com/fr/symfony/demarrer-avec-symfony#Créer un nouveau projet Symfony à l’aide de Symfony Installer [2] : https://www.wikiod.com/fr/composer-php/premiers-pas-avec-composer-php [3] : https://github.com/symfony/symfony-standard

Exécution de l’application Symfony à l’aide du serveur Web intégré de PHP

Après avoir [créé une nouvelle application Symfony][1], vous pouvez utiliser la commande server:run pour démarrer un simple serveur Web PHP, afin de pouvoir accéder à votre nouvelle application depuis votre navigateur Web :

cd my_project_name/
php bin/console server:run

Vous pouvez maintenant visiter http://localhost:8000/ pour voir la page d’accueil de Symfony.

Important : Bien que l’utilisation du serveur Web intégré soit idéale pour le développement, vous ne devez pas l’utiliser en production. Utilisez plutôt un serveur Web complet tel qu’Apache ou Nginx.

[1] : https://www.wikiod.com/fr/symfony/demarrer-avec-symfony#Créer un nouveau projet Symfony à l’aide de Symfony Installer