Instalar PHP no Windows, Mac e Linux (checar com php -v)

Para instalar o PHP, rode um comando para o seu sistema: winget install PHP.PHP.8.3 no Windows, brew install php no macOS, ou sudo apt install php-cli no Ubuntu e no Debian. Depois abra um novo terminal e rode php -v. Se ele imprimir um número de versão, o 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

Sua versão e data de build serão diferentes. Dentro de um script, a mesma informação vem de PHP_VERSION e phpversion(). Clique em Run para ver o que o PHP desta página informa:

<?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 no Windows

O caminho mais rápido é o winget, que já vem no Windows 10 e 11. Abra o PowerShell ou o Windows Terminal:

winget install PHP.PHP.8.3

Feche o terminal, abra um novo e rode php -v. É preciso uma nova janela porque os terminais mantêm o PATH com que foram iniciados.

Para instalar manualmente:

1. Baixe o zip "VS16 x64 Non Thread Safe" em windows.php.net/download.
2. Descompacte num caminho curto, como C:\php.
3. Copie php.ini-development para php.ini na mesma pasta.
4. Adicione C:\php à variável Path (menu Iniciar, "Editar as variáveis de ambiente do sistema", Variáveis de Ambiente).
5. Abra um novo terminal e rode php -v.

Se você também quer Apache e MySQL num único instalador, XAMPP e Laragon trazem os dois junto com o PHP.

Instalar PHP no macOS

O macOS não inclui mais o PHP. Instale com o Homebrew:

brew install php
php -v

brew install php instala a versão mais recente. Para fixar uma versão, instale pelo nome, por exemplo brew install php@8.3. Fórmulas com versão não são linkadas por padrão, então adicione-a ao seu PATH com o comando que o Homebrew imprime no fim da instalação. Depois, brew upgrade php atualiza o PHP.

Instalar PHP no Linux

Ubuntu 24.04 e Debian 13 trazem PHP 8.3 ou mais novo nos próprios repositórios:

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

No Fedora, RHEL e sistemas parecidos:

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

As extensões são pacotes separados chamados php-<name>: no Debian e no Ubuntu, php-mysql adiciona os drivers do MySQL (php-mysqlnd no Fedora) e php-intl a extensão intl. Para ter um PHP mais novo do que a sua distribuição oferece no Ubuntu, o repositório ppa:ondrej/php, bastante usado, tem todas as versões suportadas:

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

Verificar a versão do PHP no código

Bibliotecas costumam exigir uma versão mínima. version_compare compara strings de versão do jeito que o PHP compara, e PHP_VERSION_ID dá um inteiro simples (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";

Verificar quais extensões estão instaladas

Muitos erros depois de uma instalação nova são uma extensão faltando. No terminal, php -m lista todas as extensões carregadas. No código, extension_loaded verifica uma pelo 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";

Adicione os nomes de que o seu projeto precisa (por exemplo pdo_mysql, intl, gd) e rode na sua máquina para ver o que instalar.

Encontrar o php.ini

Configurações como display_errors, memory_limit e upload_max_filesize ficam no php.ini. O comando php --ini no terminal mostra qual arquivo está carregado. Pelo 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";

A CLI e o servidor web podem usar arquivos php.ini diferentes, então uma configuração alterada num nem sempre vale para o outro. A página sobre exibição de erros mostra as configurações que valem a pena mudar primeiro numa máquina de desenvolvimento.

Problema comum: o terminal continua rodando a versão antiga

Depois de atualizar, php -v às vezes mostra a versão anterior. Rode which php (macOS, Linux) ou where php (Windows) para ver qual binário o terminal encontra primeiro. No macOS, costuma ser uma versão do Homebrew instalada mas não linkada; no Windows, geralmente é uma pasta mais antiga que aparece antes no Path, como a que fica dentro do XAMPP. Corrija a ordem, abra um novo terminal e confira de novo. Depois continue em como rodar arquivos PHP.