Installer PHP sur Windows, Mac et Linux (vérifier php -v)

Pour installer PHP, lancez une seule commande selon votre système : winget install PHP.PHP.8.3 sur Windows, brew install php sur macOS, ou sudo apt install php-cli sur Ubuntu et Debian. Ouvrez ensuite un nouveau terminal et lancez php -v. S'il affiche un numéro de version, PHP est installé.

php -v

PHP 8.3.19 (cli) (built: Mar 27 2025 11:08:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.19, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.19, Copyright (c), by Zend Technologies

Votre version et votre date de build seront différentes. Dans un script, les mêmes informations viennent de PHP_VERSION et de phpversion(). Cliquez sur Run pour voir ce que renvoie le PHP de cette page :

<?php
echo "PHP version: " . phpversion() . "\n";
echo "Version as a number: " . PHP_VERSION_ID . "\n";
echo "Operating system family: " . PHP_OS_FAMILY . "\n";
echo "Integer size: " . PHP_INT_SIZE * 8 . " bit\n";

Installer PHP sur Windows

Le plus rapide est winget, fourni avec Windows 10 et 11. Ouvrez PowerShell ou Windows Terminal :

winget install PHP.PHP.8.3

Fermez le terminal, ouvrez-en un nouveau et lancez php -v. Une nouvelle fenêtre est nécessaire car un terminal garde le PATH avec lequel il a démarré.

Pour installer à la main :

1. Téléchargez le zip « VS16 x64 Non Thread Safe » sur windows.php.net/download.
2. Décompressez-le dans un chemin court comme C:\php.
3. Copiez php.ini-development en php.ini dans le même dossier.
4. Ajoutez C:\php à la variable Path (menu Démarrer, « Modifier les variables d'environnement système », Variables d'environnement).
5. Ouvrez un nouveau terminal et lancez php -v.

Si vous voulez aussi Apache et MySQL dans un seul installateur, XAMPP et Laragon les fournissent avec PHP.

Installer PHP sur macOS

macOS n'inclut plus PHP. Installez-le avec Homebrew :

brew install php
php -v

brew install php installe la dernière version. Pour fixer une version, installez-la par son nom, par exemple brew install php@8.3. Les formules versionnées ne sont pas liées par défaut : ajoutez-la à votre PATH avec la commande que Homebrew affiche à la fin de l'installation. brew upgrade php la met à jour plus tard.

Installer PHP sur Linux

Ubuntu 24.04 et Debian 13 fournissent PHP 8.3 ou plus récent dans leurs dépôts officiels :

sudo apt update
sudo apt install php-cli php-mbstring php-xml php-curl
php -v

Sur Fedora, RHEL et les systèmes similaires :

sudo dnf install php-cli php-mbstring php-xml
php -v

Les extensions sont des paquets séparés nommés php-<name> : sur Debian et Ubuntu, php-mysql ajoute les pilotes MySQL (php-mysqlnd sur Fedora) et php-intl l'extension intl. Pour un PHP plus récent que celui de votre distribution sur Ubuntu, le dépôt très utilisé ppa:ondrej/php propose toutes les versions supportées :

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3-cli

Vérifier la version de PHP dans le code

Les bibliothèques exigent souvent une version minimale. version_compare compare des chaînes de version comme le fait PHP, et PHP_VERSION_ID donne un simple entier (80300 signifie 8.3.0) facile à comparer :

<?php
$required = '8.1.0';

if (version_compare(PHP_VERSION, $required, '>=')) {
    echo "PHP " . PHP_VERSION . " is new enough (need $required)\n";
} else {
    echo "Please upgrade: this code needs PHP $required\n";
}

echo PHP_VERSION_ID >= 80300 ? "8.3 features are available\n" : "Older than 8.3\n";
echo "Major: " . PHP_MAJOR_VERSION . ", minor: " . PHP_MINOR_VERSION . "\n";

Vérifier quelles extensions sont installées

Après une installation neuve, beaucoup d'erreurs viennent d'une extension manquante. Dans un terminal, php -m liste toutes les extensions chargées. Dans le code, extension_loaded en vérifie une par son nom :

<?php
$needed = ['mbstring', 'json', 'ctype', 'dom'];

foreach ($needed as $ext) {
    $status = extension_loaded($ext) ? 'loaded' : 'MISSING';
    printf("%-10s %s\n", $ext, $status);
}

echo "\nTotal extensions loaded: " . count(get_loaded_extensions()) . "\n";

Ajoutez les noms dont votre projet a besoin (par exemple pdo_mysql, intl, gd) et exécutez-le sur votre machine pour savoir quoi installer.

Trouver php.ini

Les réglages comme display_errors, memory_limit et upload_max_filesize se trouvent dans php.ini. La commande php --ini affiche le fichier chargé. Depuis le code :

<?php
$ini = php_ini_loaded_file();
echo $ini === false ? "No php.ini loaded, PHP uses its defaults\n" : "Loaded: $ini\n";

echo "memory_limit = " . ini_get('memory_limit') . "\n";
echo "max_execution_time = " . ini_get('max_execution_time') . "\n";

La CLI et le serveur web peuvent utiliser des fichiers php.ini différents : un réglage modifié pour l'un ne s'applique donc pas toujours à l'autre. La page sur l'affichage des erreurs montre les réglages à changer en premier sur une machine de développement.

Problème fréquent : le terminal lance toujours l'ancienne version

Après une mise à jour, php -v affiche parfois la version précédente. Lancez which php (macOS, Linux) ou where php (Windows) pour voir quel binaire le terminal trouve en premier. Sur macOS, c'est souvent une version Homebrew installée mais non liée ; sur Windows, c'est généralement un ancien dossier placé plus haut dans Path, comme celui de XAMPP. Corrigez l'ordre, ouvrez un nouveau terminal et vérifiez à nouveau. Passez ensuite à l'exécution de fichiers PHP.