Installation de PHP, Composer et du Symfony CLI

PHP : le moteur de votre application Symfony

PHP (Hypertext Preprocessor) est le langage de programmation sur lequel repose Symfony. Avant toute chose, vous devez vous assurer que PHP est installé sur votre machine et qu'il s'agit d'une version compatible avec la version de Symfony que vous souhaitez utiliser. Par exemple, Symfony 6 nécessite PHP 8.1 ou une version ultérieure, tandis que Symfony 7 peut exiger PHP 8.2 ou plus. Vérifiez toujours les prérequis de la version de Symfony ciblée sur le site officiel.

Pour vérifier si PHP est installé et connaître sa version, ouvrez un terminal (Invite de commandes sur Windows, Terminal sur macOS et Linux) et tapez la commande :

php -v

Si la commande renvoie une version et qu'elle est compatible, vous êtes prêt pour cette étape. Sinon, vous devez installer ou mettre à jour PHP. La méthode d'installation varie considérablement en fonction de votre système d'exploitation :

Sur Windows :

• La méthode la plus simple est souvent d'utiliser un environnement de développement intégré comme XAMPP, WampServer, Laragon ou Winginx. Ces paquets installent PHP, un serveur web (Apache ou Nginx) et une base de données (MySQL/MariaDB) en une seule fois.
• Alternativement, vous pouvez télécharger les binaires de PHP directement depuis php.net. Choisissez la version "Thread Safe" si vous prévoyez d'utiliser PHP avec Apache en tant que module, ou "Non Thread Safe" (NTS) si vous utilisez IIS/Nginx avec FastCGI. Après le téléchargement, décompressez l'archive (par exemple, dans C:\php) et ajoutez ce répertoire à votre variable d'environnement système PATH pour pouvoir exécuter php depuis n'importe quel emplacement. Vous devrez également configurer le fichier php.ini (en renommant php.ini-development ou php.ini-production en php.ini et en l'ajustant).

Sur macOS :

• macOS est généralement livré avec une version de PHP, mais elle est souvent obsolète. La méthode recommandée est d'utiliser Homebrew, un gestionnaire de paquets pour macOS. Si vous n'avez pas Homebrew, installez-le depuis brew.sh. Ensuite, installez PHP :

brew update
brew install php # Installe la dernière version stable
# Ou pour une version spécifique, par exemple PHP 8.2 :
# brew install php@8.2

Homebrew s'occupera d'ajouter PHP à votre PATH. Vous pourriez avoir besoin de lier la version installée si vous avez plusieurs versions : brew link php@8.2 --force (adaptez la version).

Sur Linux (Debian/Ubuntu) :

• Utilisez le gestionnaire de paquets apt. Il est souvent recommandé d'ajouter un PPA (Personal Package Archive) pour obtenir les versions les plus récentes de PHP, comme celui d'Ondřej Surý :

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php # Appuyez sur Entrée pour confirmer
sudo apt update
sudo apt install php8.2 php8.2-cli php8.2-fpm # Adaptez la version (ex: php8.1)
# Installez les extensions PHP couramment requises par Symfony :
sudo apt install php8.2-common php8.2-xml php8.2-zip php8.2-curl php8.2-intl php8.2-mysql php8.2-gd php8.2-mbstring php8.2-bcmath php8.2-opcache

La liste des extensions peut varier légèrement, mais php-xml, php-ctype, php-iconv, php-json, php-session, php-simplexml, et php-tokenizer sont généralement indispensables. Symfony CLI (symfony check:requirements) vous aidera à identifier les manquantes.

Après l'installation, fermez et rouvrez votre terminal, puis vérifiez à nouveau avec php -v.

Composer : le gestionnaire de dépendances pour vos projets PHP

Composer est un outil indispensable dans l'écosystème PHP moderne. C'est un gestionnaire de dépendances au niveau de l'application. Cela signifie qu'il vous permet de déclarer les bibliothèques (paquets) dont votre projet a besoin et il s'occupe de les installer et de les mettre à jour pour vous. Symfony lui-même, ainsi que de nombreux bundles et composants que vous utiliserez, sont installés via Composer.

Pour installer Composer globalement (afin de pouvoir l'utiliser depuis n'importe quel répertoire), suivez les instructions officielles sur getcomposer.org/download/. Le processus implique généralement de télécharger un script d'installation PHP et de l'exécuter.

Sur Linux ou macOS, les commandes typiques sont :

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

Cela téléchargera composer.phar (une archive PHP). Pour le rendre exécutable globalement, déplacez-le dans un répertoire inclus dans votre PATH :

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

Sur Windows, le plus simple est de télécharger et d'exécuter l'installeur Composer-Setup.exe disponible sur la page de téléchargement de Composer. Il trouvera automatiquement votre installation PHP et configurera votre PATH.

Une fois l'installation terminée, ouvrez un nouveau terminal et vérifiez que Composer fonctionne en tapant :

composer --version

Vous devriez voir s'afficher la version de Composer installée. Composer lit ses dépendances à partir d'un fichier nommé composer.json à la racine de votre projet. Il génère un fichier composer.lock qui enregistre les versions exactes des paquets installés, assurant la cohérence entre les environnements de développement.

Symfony CLI : votre couteau suisse pour les projets Symfony

Le Symfony CLI (Command Line Interface) est un outil développé par l'équipe de Symfony pour simplifier de nombreuses tâches liées au développement d'applications Symfony. Il permet notamment de créer de nouveaux projets, de démarrer un serveur de développement local optimisé, de gérer des variables d'environnement, de vérifier les prérequis de votre système, et bien plus encore.

L'installation du Symfony CLI est également spécifique à votre système d'exploitation. Rendez-vous sur la page de téléchargement officielle : symfony.com/download.

Sur Linux ou macOS : Vous pouvez généralement l'installer avec une simple commande. Par exemple, en utilisant curl :

curl -1sLf 'https://dl.cloudsmith.io/public/symfony/stable/setup.deb.sh' | sudo -E bash
sudo apt install symfony-cli

Ou pour une installation manuelle (plus universelle sur Linux/macOS) :

wget https://get.symfony.com/cli/installer -O - | bash
# ou avec curl :
# curl -sS https://get.symfony.com/cli/installer | bash

Cette dernière commande télécharge le binaire et le place souvent dans ~/.symfony5/bin/ ou ~/.symfony/bin/. Vous devrez ensuite ajouter ce répertoire à votre variable d'environnement PATH. Suivez les instructions affichées par le script d'installation, qui vous indiqueront généralement la ligne à ajouter à votre fichier de profil shell (.bashrc, .zshrc, etc.), par exemple :

export PATH="$HOME/.symfony5/bin:$PATH" # Adaptez le chemin si nécessaire

N'oubliez pas de recharger votre configuration shell (source ~/.bashrc) ou d'ouvrir un nouveau terminal.

Sur Windows :

• Utilisez Scoop (un gestionnaire de paquets en ligne de commande pour Windows) :

scoop bucket add extras
scoop install symfony-cli

• Ou téléchargez l'exécutable .exe depuis la page de téléchargement et placez-le dans un répertoire inclus dans votre PATH, ou exécutez l'installeur fourni s'il y en a un.

Après l'installation, ouvrez un nouveau terminal et testez si le Symfony CLI est correctement installé :

symfony --version

Vous devriez voir la version du Symfony CLI. Une commande très utile à exécuter immédiatement est :

symfony check:requirements

Cette commande vérifiera si votre environnement PHP et votre système remplissent toutes les conditions requises et optionnelles pour faire fonctionner Symfony de manière optimale. Elle listera les extensions PHP manquantes ou les configurations à ajuster, ce qui est extrêmement précieux pour éviter des problèmes ultérieurs.

Avec PHP, Composer et le Symfony CLI installés et configurés, votre environnement de développement est prêt pour accueillir votre premier projet Symfony !