Instalar PHP en Windows, Mac y Linux (comprobar con php -v)

Para instalar PHP, ejecuta un comando según tu sistema: winget install PHP.PHP.8.3 en Windows, brew install php en macOS o sudo apt install php-cli en Ubuntu y Debian. Después abre una terminal nueva y ejecuta php -v. Si imprime un número de versión, PHP está instalado.

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

Tu versión y tu fecha de compilación serán distintas. Dentro de un script, la misma información viene de PHP_VERSION y phpversion(). Pulsa Ejecutar para ver qué informa el PHP de esta página:

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

Instalar PHP en Windows

La vía más rápida es winget, que viene con Windows 10 y 11. Abre PowerShell o Windows Terminal:

winget install PHP.PHP.8.3

Cierra la terminal, abre una nueva y ejecuta php -v. Hace falta una ventana nueva porque las terminales conservan el PATH con el que se abrieron.

Para instalarlo a mano:

1. Descarga el zip "VS16 x64 Non Thread Safe" desde windows.php.net/download.
2. Descomprímelo en una ruta corta como C:\php.
3. Copia php.ini-development como php.ini en la misma carpeta.
4. Añade C:\php a la variable Path (menú Inicio, "Editar las variables de entorno del sistema", Variables de entorno).
5. Abre una terminal nueva y ejecuta php -v.

Si además quieres Apache y MySQL en un solo instalador, XAMPP y Laragon los incluyen junto con PHP.

Instalar PHP en macOS

macOS ya no incluye PHP. Instálalo con Homebrew:

brew install php
php -v

brew install php te da la última versión. Para fijar una versión, instálala por su nombre, por ejemplo brew install php@8.3. Las fórmulas con versión no se enlazan por defecto, así que añádela a tu PATH con el comando que Homebrew imprime al final de la instalación. Más adelante, brew upgrade php la actualiza.

Instalar PHP en Linux

Ubuntu 24.04 y Debian 13 traen PHP 8.3 o posterior en sus propios repositorios:

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

En Fedora, RHEL y sistemas similares:

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

Las extensiones son paquetes aparte llamados php-<name>: en Debian y Ubuntu, php-mysql añade los drivers de MySQL (php-mysqlnd en Fedora) y php-intl la extensión intl. Si en Ubuntu quieres un PHP más reciente que el que ofrece tu distribución, el repositorio ppa:ondrej/php, muy utilizado, tiene todas las versiones con soporte:

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

Comprobar la versión de PHP en el código

Muchas librerías exigen una versión mínima. version_compare compara cadenas de versión igual que lo hace PHP, y PHP_VERSION_ID da un entero simple (80300 significa 8.3.0) fácil de comparar:

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

Comprobar qué extensiones están instaladas

Muchos errores tras una instalación nueva se deben a una extensión que falta. En una terminal, php -m lista todas las extensiones cargadas. En el código, extension_loaded comprueba una por su nombre:

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

Añade los nombres que necesita tu proyecto (por ejemplo pdo_mysql, intl, gd) y ejecútalo en tu propio equipo para ver qué tienes que instalar.

Encontrar php.ini

Ajustes como display_errors, memory_limit y upload_max_filesize están en php.ini. El comando de terminal php --ini indica qué archivo se carga. Desde el código:

<?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 y el servidor web pueden usar archivos php.ini distintos, así que un ajuste cambiado para uno no siempre se aplica al otro. La página de errores en PHP muestra los ajustes que conviene cambiar primero en una máquina de desarrollo.

Problema habitual: la terminal sigue ejecutando la versión antigua

Después de actualizar, a veces php -v muestra la versión anterior. Ejecuta which php (macOS, Linux) o where php (Windows) para ver qué binario encuentra primero la terminal. En macOS suele ser una versión de Homebrew instalada pero no enlazada; en Windows suele ser una carpeta antigua que aparece antes en Path, como la de XAMPP. Corrige el orden, abre una terminal nueva y vuelve a comprobarlo. Después sigue con cómo ejecutar archivos PHP.