W3docs

Comment installer PHP

Apprenez à installer PHP sur Windows, macOS et Linux, à configurer Apache et à vérifier votre installation étape par étape.

PHP (Hypertext Preprocessor) est un langage de script côté serveur largement utilisé pour développer des applications web dynamiques. Avant de pouvoir exécuter du code PHP, vous devez disposer d'un interpréteur PHP installé sur votre machine. Ce guide vous explique comment installer PHP sur Windows, macOS et Linux, comment choisir la configuration adaptée à votre objectif, et comment vérifier que tout fonctionne correctement.

Si vous débutez avec ce langage, lisez d'abord l'introduction à PHP pour comprendre ce qu'est PHP et comment il s'exécute.

Quelle installation choisir ?

Il n'existe pas de méthode « universelle » pour installer PHP — la meilleure option dépend de ce que vous souhaitez faire :

  • Vous apprenez simplement le langage ? Installez l'interpréteur PHP CLI (ligne de commande). PHP inclut un serveur de développement intégré, vous n'avez donc pas besoin d'Apache ou de Nginx pour commencer.
  • Vous construisez une pile web complète ? Utilisez un bundle tout-en-un comme XAMPP, MAMP ou Laragon. Ces outils installent PHP, Apache (ou Nginx) et MySQL ensemble en un seul clic.
  • Vous travaillez sur un vrai projet ? Installez PHP via le gestionnaire de paquets de votre système (apt, brew, choco). C'est l'approche la plus propre et la plus facile à mettre à jour pour les développeurs.

Le tableau ci-dessous résume les compromis :

ApprocheIdéal pourInclut un serveur web ?
PHP CLI + serveur intégréApprentissage, petits scriptsIntégré (développement uniquement)
XAMPP / MAMP / LaragonDébutants souhaitant Apache + MySQLOui
Gestionnaire de paquetsDéveloppeurs, environnements proches de la productionNon (à installer séparément)

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

  • Un ordinateur sous Windows, macOS ou Linux.
  • Un éditeur de texte tel que Visual Studio Code, Sublime Text ou Notepad++.
  • Un accès à un terminal (Invite de commandes ou PowerShell sous Windows, Terminal sous macOS/Linux).
  • Un serveur web (Apache ou Nginx) uniquement si vous n'utilisez pas le serveur de développement intégré.

Installer PHP selon le système d'exploitation

Windows

Le chemin le plus simple sous Windows est le gestionnaire de paquets Chocolatey. Dans un PowerShell avec élévation de privilèges :

choco install php

Vous préférez une installation manuelle ? Téléchargez la dernière archive Zip non thread-safe depuis la page de téléchargements officielle de PHP, extrayez-la dans C:\php, puis ajoutez C:\php à votre variable d'environnement Path pour que la commande php soit disponible partout.

macOS

Homebrew est l'outil standard :

brew install php

Homebrew ajoute automatiquement le binaire php à votre PATH.

Linux (Debian/Ubuntu)

Utilisez apt :

sudo apt update
sudo apt install php php-cli

Sur Fedora/RHEL, la commande équivalente est sudo dnf install php php-cli.

Vérifier l'installation

Quelle que soit la méthode utilisée, confirmez que PHP est bien dans votre PATH en vérifiant la version depuis un terminal :

php -v

Vous devriez voir une sortie similaire à celle-ci (votre numéro de version peut différer) :

PHP 8.3.6 (cli) (built: ...) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.3.6, ...

Si vous obtenez une erreur « command not found », le répertoire de PHP n'a pas été ajouté à votre PATH — reprenez l'étape d'installation correspondant à votre système d'exploitation.

Exécuter PHP sans serveur web

PHP inclut un serveur de développement intégré, qui est la façon la plus rapide d'exécuter des pages pendant l'apprentissage. Créez un fichier nommé index.php :

<?php
echo "Hello from PHP " . PHP_VERSION;

Ensuite, démarrez le serveur depuis ce dossier et ouvrez l'URL affichée :

php -S localhost:8000

Visitez http://localhost:8000 dans votre navigateur. Le serveur intégré est réservé au développement — ne l'exposez jamais sur internet.

Configurer PHP avec Apache

  1. Ouvrez le fichier de configuration d'Apache situé dans le dossier d'installation d'Apache (généralement conf/httpd.conf sous Windows ou /etc/apache2/apache2.conf sous Linux/macOS).
  2. Repérez la directive de chargement du module PHP. Pour les installations manuelles sous Windows, elle ressemble généralement à ceci :
#LoadModule php_module "modules/php8apache2_4.dll"
  1. Supprimez le symbole # pour décommenter la ligne, vérifiez que le chemin correspond à votre répertoire d'installation PHP, puis enregistrez et fermez le fichier. (Remarque : sous Linux/macOS, PHP est généralement activé via les gestionnaires de paquets avec des commandes telles que sudo a2enmod php8.2.)
  2. Redémarrez Apache pour appliquer les modifications.

Tester l'installation de PHP

  1. Créez un nouveau fichier avec l'extension .php (p. ex. index.php) dans le dossier racine de votre serveur web (généralement htdocs ou /var/www/html sous Linux/macOS).
  2. Saisissez le code suivant dans ce fichier :
php— editable, runs on the server
  1. Enregistrez et fermez le fichier.
  2. Ouvrez un navigateur web et accédez à http://localhost/index.php.
  3. Si tout est correctement configuré, vous verrez une page affichant des informations sur votre installation PHP. Vous pouvez également vérifier l'installation en ligne de commande en exécutant php -v.

Problèmes courants lors de l'installation

  • php n'est pas reconnu / commande introuvable. Le dossier PHP est absent de votre PATH. Rouvrez le terminal après avoir modifié le PATH, car les modifications s'appliquent uniquement aux nouvelles sessions de shell.
  • phpinfo() s'affiche en texte brut. Le navigateur a téléchargé le fichier ou le serveur web ne traite pas PHP. Assurez-vous d'y accéder via http://localhost (servi par un serveur web), et non en double-cliquant sur le fichier.
  • Mauvaise version de PHP. Si plusieurs versions sont installées, php -v affiche celle qui apparaît en premier dans votre PATH. Ajustez l'ordre ou utilisez le chemin complet (p. ex. /usr/local/opt/[email protected]/bin/php).

Prochaines étapes

Maintenant que PHP fonctionne sur votre machine, continuez avec :

Conclusion

PHP est maintenant installé et vérifié sur votre machine. Vous pouvez exécuter des scripts via Apache ou via le serveur de développement intégré de PHP. Choisissez le flux de travail qui correspond à votre objectif — le serveur CLI pour un apprentissage rapide, ou une pile Apache/Nginx complète pour de vraies applications — et vous êtes prêt à écrire du PHP.

Practice

Pratique
Quelles sont les façons d'installer PHP ?
Quelles sont les façons d'installer PHP ?
Was this page helpful?