Installare PHP su Windows, Mac e Linux (verifica con php -v)

Per installare PHP, esegui un comando per il tuo sistema: winget install PHP.PHP.8.3 su Windows, brew install php su macOS, oppure sudo apt install php-cli su Ubuntu e Debian. Poi apri un nuovo terminale ed esegui php -v. Se stampa un numero di versione, PHP è installato.

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

La tua versione e la data di build saranno diverse. Dentro uno script, le stesse informazioni arrivano da PHP_VERSION e phpversion(). Premi Run per vedere cosa riporta il PHP di questa pagina:

<?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";

Installare PHP su Windows

La via più rapida è winget, incluso in Windows 10 e 11. Apri PowerShell o Windows Terminal:

winget install PHP.PHP.8.3

Chiudi il terminale, aprine uno nuovo ed esegui php -v. Serve una nuova finestra perché i terminali conservano il PATH con cui sono stati avviati.

Per installarlo a mano, invece:

1. Scarica lo zip "VS16 x64 Non Thread Safe" da windows.php.net/download.
2. Estrailo in un percorso breve come C:\php.
3. Copia php.ini-development in php.ini nella stessa cartella.
4. Aggiungi C:\php alla variabile Path (menu Start, "Modifica le variabili di ambiente relative al sistema", Variabili d'ambiente).
5. Apri un nuovo terminale ed esegui php -v.

Se vuoi anche Apache e MySQL in un unico installer, XAMPP e Laragon li includono insieme a PHP.

Installare PHP su macOS

macOS non include più PHP. Installalo con Homebrew:

brew install php
php -v

brew install php ti dà l'ultima release. Per fissare una versione, installala per nome, per esempio brew install php@8.3. Le formule con versione non vengono collegate di default, quindi aggiungila al tuo PATH con il comando che Homebrew stampa alla fine dell'installazione. In seguito brew upgrade php la aggiorna.

Installare PHP su Linux

Ubuntu 24.04 e Debian 13 includono PHP 8.3 o successivo nei propri repository:

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

Su Fedora, RHEL e sistemi simili:

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

Le estensioni sono pacchetti separati chiamati php-<name>: su Debian e Ubuntu php-mysql aggiunge i driver MySQL (php-mysqlnd su Fedora) e php-intl l'estensione intl. Per un PHP più recente di quello offerto dalla tua distribuzione su Ubuntu, il diffusissimo repository ppa:ondrej/php ha tutte le versioni supportate:

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

Verificare la versione di PHP nel codice

Spesso le librerie richiedono una versione minima. version_compare confronta stringhe di versione come fa PHP, e PHP_VERSION_ID restituisce un semplice intero (80300 significa 8.3.0) facile da confrontare:

<?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";

Verificare quali estensioni sono installate

Molti errori dopo un'installazione nuova sono dovuti a un'estensione mancante. In un terminale, php -m elenca tutte le estensioni caricate. Nel codice, extension_loaded ne verifica una per nome:

<?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";

Aggiungi i nomi che servono al tuo progetto (per esempio pdo_mysql, intl, gd) ed eseguilo sul tuo computer per vedere cosa installare.

Trovare php.ini

Impostazioni come display_errors, memory_limit e upload_max_filesize si trovano in php.ini. Il comando da terminale php --ini stampa quale file viene caricato. Dal codice:

<?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 e il web server possono usare file php.ini diversi, quindi un'impostazione modificata per uno non vale sempre per l'altro. La pagina sulla segnalazione degli errori mostra le impostazioni da cambiare per prime su una macchina di sviluppo.

Problema comune: il terminale esegue ancora la vecchia versione

Dopo un aggiornamento, a volte php -v riporta la versione precedente. Esegui which php (macOS, Linux) oppure where php (Windows) per vedere quale binario il terminale trova per primo. Su macOS spesso è una versione di Homebrew installata ma non collegata; su Windows di solito è una cartella più vecchia che compare prima in Path, come quella dentro XAMPP. Correggi l'ordine, apri un nuovo terminale e verifica di nuovo. Poi prosegui con eseguire file PHP.