Mise en place d’un projet Symfony

1. Introduction

Avant de se lancer dans la création d’un projet Symfony, il est important de s’équiper ! Un certain nombre d’outils sont nécessaires pour mettre en place le projet et pour développer, leur installation correcte est détaillée ci-après. Certains de ces outils sont indispensables pour tout développeur Symfony, d’autres sont optionnels ou possèdent des alternatives. Il est essentiel de bien comprendre leur rôle et de les installer à bon escient avant d’aller plus loin dans la construction de son projet.

2. Symfony : Un projet PHP

Le premier ensemble d’outils à installer permet de poser les fondations. En effet, un projet Symfony est avant tout un projet PHP avec tout ce que cela implique : serveur web disposant de PHP, base de données…

Il est donc nécessaire de prévoir l’installation d’un tel environnement, même si, comme cela sera évoqué plus loin, l’installeur Symfony peut se substituer au serveur web. L’installation d’un vrai serveur web disposant de PHP sera à un moment ou un autre indispensable, notamment pour la mise en place de tests logiciels, ou encore pour certaines fonctionnalités de sécurité.

Pour disposer d’une installation fonctionnelle de ce type d’environnement, deux solutions s’offrent à vous :

La première approche nécessite bien entendu une connaissance poussée du système d’exploitation choisi, du réseau, et du fonctionnement de ces produits. La seconde, elle, est beaucoup plus abordable techniquement, et surtout plus rapide, notamment en environnement Windows.

1. Prérequis

Comme évoqué précédemment, vous devez disposer d’une installation de PHP dans sa version 8.1 au minimum pour créer un projet Symfony 6.

Nous allons présenter plusieurs techniques de création de projet utilisant l’installeur Symfony ou bien l’installation via Composer. Les deux solutions sont pertinentes pour créer un projet, mais une installation par l’installeur n’affranchit pas d’avoir installé Composer pour d’autres tâches ultérieures.

2. Création via l’installeur Symfony

L’installeur Symfony s’utilise en ligne de commande dans un terminal sous Linux ou macOS et dans une invite de commandes sous Windows. Avant de créer un nouveau projet, vous pouvez demander la vérification des prérequis en exécutant la commande :

symfony check:requirements 

Le résultat affiché à l’écran peut vous indiquer des erreurs dans la configuration de PHP qu’il faudra corriger avant d’aller plus loin. En plus des erreurs, il peut également y avoir des préconisations d’optimisations faites par l’outil, mais tant que le résultat est « OK », vous pouvez continuer.

La création du projet se fera ensuite grâce à la commande :

symfony new mon_projet --version="6.4.*" --webapp 

Plus généralement, la commande :

symfony new mon_projet --version=lts --webapp 

permet de créer un projet sur la base de la dernière version LTS en date.

Cette commande crée la structure de projet et installe Symfony 5.4 dans le dossier mon_projet. Vous remarquerez qu’en fait, la commande symfony utilise Composer de manière sous-jacente. Vous noterez également qu’un dépôt Git a été initialisé pour ce projet, ce qui vous permet de gérer le code source et ses versions.

C’est la seule différence entre l’usage des deux techniques d’installation présentées ici : l’installeur Symfony nécessite une installation fonctionnelle de Git sur le poste de développement.

3. Création via Composer

Pour initialiser un projet Symfony, nous utilisons la commande...

1. Arborescence du projet

Une application Symfony contient différents répertoires et chacun d’eux a un rôle précis.