PHP Instalar no Windows e macOS

No Windows e no macOS, o PHP não vem instalado, e não há um "instalador de duas cliques" oficial: no Windows você baixa um arquivo .zip e diz ao sistema onde ele está; no macOS, o caminho mais simples é o Homebrew. Nesta aula você vai ver os passos oficiais, as alternativas prontas (XAMPP, Laragon, WSL) e como conferir se deu certo.

Antes de tudo: o terminal

O PHP é um programa de linha de comando: você o usa digitando comandos numa janela de texto, o terminal. Não existe "ícone do PHP" para clicar.

Nas aulas do guia, os comandos aparecem com o prompt ana@notebook:~$ da máquina fictícia (um Linux). No Windows o prompt é algo como PS C:\Users\Ana> e no macOS, ana@MacBook ~ %. Os comandos php são os mesmos nos três.

Windows

Qual caminho escolher?

Caminho 1: o zip oficial, passo a passo

1. Instale o Visual C++ Redistributable. O PHP para Windows é montado com o Visual Studio 2022 e precisa das bibliotecas dele. Baixe o "Visual C++ Redistributable for Visual Studio 2015-2022" para x64 (o link está na própria página de downloads do PHP, aka.ms/vs/17/release/vc_redist.x64.exe) e instale. Muitos computadores já têm; instalar de novo não faz mal.
2. Baixe o PHP. Em php.net/downloads.php?os=windows, procure a seção do PHP 8.5 e baixe o Zip da linha VS17 x64 Non Thread Safe. Em outubro de 2026, o arquivo é o php-8.5.11-nts-Win32-vs17-x64.zip (cerca de 34 MB).
3. Descompacte numa pasta simples, sem espaços nem acentos no caminho: C:\php. Dentro dela deve ficar o arquivo php.exe (e não uma subpasta com o nome do zip; se ficou, mova o conteúdo um nível acima).
4. Crie o php.ini. Na pasta C:\php há dois modelos: php.ini-development e php.ini-production. Faça uma cópia do development (ele mostra todos os erros, o que é bom para estudar) e renomeie a cópia para php.ini. Se o Windows esconder as extensões dos arquivos, ative "Extensões de nomes de arquivos" no menu Exibir do Explorador, senão você pode acabar com um php.ini.txt.
5. Ligue as extensões. Abra o php.ini no Bloco de Notas (ou no seu editor) e procure as linhas abaixo. Apague o ; do começo de cada uma (o ; transforma a linha em comentário, ou seja, desligada):

   extension_dir = "ext"
   extension=curl
   extension=mbstring
   extension=openssl
   extension=pdo_sqlite
   extension=sqlite3

   O extension_dir = "ext" diz que as extensões estão na subpasta ext. As outras linhas ligam as extensões usadas no guia.
6. Coloque o PHP no PATH (explicado logo abaixo).
7. Abra um terminal novo (os que já estavam abertos não enxergam a mudança) e confira com php -v.

O que é o PATH e como configurar

Quando você digita php no terminal, o Windows não procura no disco inteiro: ele olha só numa lista de pastas, guardada numa variável chamada PATH ("caminho"). Se a pasta C:\php não estiver na lista, o Windows responde que não conhece o comando. Para acrescentar:

1. Tecle Win, digite variáveis de ambiente e abra Editar as variáveis de ambiente do sistema.
2. Clique no botão Variáveis de Ambiente….
3. Na parte de cima (Variáveis de usuário), selecione Path e clique em Editar….
4. Clique em Novo, digite C:\php e confirme com OK em todas as janelas.

Agora, num terminal novo:

PS C:\Users\Ana> php -v
PHP 8.5.11 (cli) (built: …) (NTS Visual C++ 2022 x64)
Copyright (c) The PHP Group
Zend Engine v4.5.11, Copyright (c) Zend Technologies
    with Zend OPcache v8.5.11, Copyright (c), by Zend Technologies

A primeira linha confirma a versão e que é a montagem NTS de 64 bits. Para ver qual php.ini foi carregado e quais extensões estão ligadas, use os mesmos comandos do Linux: php --ini (deve mostrar C:\php\php.ini em Loaded Configuration File) e php -m (deve listar mbstring, pdo_sqlite…).

Caminho 2: winget

O Windows 10 e 11 vêm com o winget, um gerenciador de pacotes de linha de comando. Ele baixa o zip oficial, descompacta e acerta o PATH sozinho. Primeiro, procure os pacotes do PHP; depois instale o da versão desejada:

winget search PHP.PHP
winget install --id PHP.PHP.8.5 -e

O --id diz o identificador exato e o -e (de exact) evita que o winget escolha outro pacote parecido. Os identificadores seguem o padrão PHP.PHP.8.5, PHP.PHP.8.4…; confira com o winget search o que aparece no seu computador. Depois, abra um terminal novo e confira com php -v. Você ainda vai precisar criar o php.ini e ligar as extensões (passos 4 e 5 acima), na pasta onde o winget instalou o PHP: o comando php --ini mostra qual é.

Caminho 3: Laragon ou XAMPP

São "pacotes completos": um instalador gráfico que coloca o PHP, um servidor web (Apache ou nginx) e um banco de dados (MySQL ou MariaDB) de uma vez, com um painel para ligar e desligar tudo. São práticos para quem quer criar sites com banco de dados logo, mas escondem as peças, e às vezes trazem uma versão mais antiga do PHP.

• Laragon (laragon.org): leve e atualizado com frequência; permite trocar a versão do PHP pelo menu. Os sites ficam na pasta C:\laragon\www.
• XAMPP (apachefriends.org): o mais conhecido. Os sites ficam em C:\xampp\htdocs e são abertos em http://localhost/. Antes de baixar, veja na página qual versão do PHP vem em cada instalador.

Com qualquer um deles, o comando php do terminal pode não funcionar até você acrescentar a pasta do PHP deles ao PATH (por exemplo, C:\xampp\php). Use php -v para confirmar qual PHP o terminal está usando.

Caminho 4: WSL, um Linux dentro do Windows

O WSL (Windows Subsystem for Linux) roda um Ubuntu de verdade dentro do Windows. É o caminho que deixa o seu ambiente mais parecido com o das aulas e com os servidores da internet. Num PowerShell aberto como administrador:

wsl --install

O Windows instala o WSL e o Ubuntu, pede para reiniciar e, na primeira abertura do Ubuntu, pede um nome de usuário e uma senha para o Linux. A partir daí, abra o Ubuntu pelo menu Iniciar e siga a aula Instalar no Linux (sudo apt install php-cli). Os seus arquivos do Windows ficam acessíveis em /mnt/c/.

macOS

O macOS trazia um PHP antigo de fábrica até a versão 11 (Big Sur); a Apple o removeu a partir do macOS 12 (Monterey). Hoje, o jeito mais usado de instalar é o Homebrew, o gerenciador de pacotes mais popular do Mac (o "apt do macOS").

1. Instale o Homebrew (se ainda não tiver)

Confira se ele já existe com brew --version. Se o terminal disser command not found: brew, instale com o comando publicado em brew.sh (copie de lá, para ter sempre a versão atual):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

O instalador pede a senha do Mac, pode pedir para instalar as "Ferramentas de Linha de Comando do Xcode" (aceite) e, no fim, mostra dois ou três comandos em Next steps para colocar o brew no PATH. Rode esses comandos exatamente como ele mostrar.

2. Instale o PHP

brew install php

O Homebrew baixa o PHP mais recente (em outubro de 2026, o 8.5.11) e as bibliotecas de que ele precisa. Ele já vem com as extensões mais usadas ligadas, inclusive mbstring, pdo_sqlite e curl. Confira:

ana@MacBook ~ % php -v
PHP 8.5.11 (cli) (built: …) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.5.11, Copyright (c) Zend Technologies
    with Zend OPcache v8.5.11, Copyright (c), by Zend Technologies

O php.ini fica em $HOMEBREW_PREFIX/etc/php/8.5/: em Macs com processador Apple (M1, M2…), /opt/homebrew/etc/php/8.5/php.ini; em Macs com Intel, /usr/local/etc/php/8.5/php.ini. Como no Linux, php --ini mostra o caminho exato.

Outras versões e atualizações

Testando: o mesmo programa nos três sistemas

Com o PHP instalado, crie uma pasta site, salve nela um arquivo so.php com o conteúdo abaixo (num editor de código; veja Editores e IDEs) e rode com php so.php no terminal, dentro dessa pasta:

<?php
echo "Sistema: " . PHP_OS_FAMILY . "\n";
echo "Separador de pastas: " . DIRECTORY_SEPARATOR . "\n";
echo "Pasta deste arquivo: " . __DIR__ . "\n";

No laboratório do guia (Linux), a saída real é:

$ php so.php
Sistema: Linux
Separador de pastas: /
Pasta deste arquivo: /home/ana/t

No Windows, você veria Sistema: Windows, o separador \ e algo como C:\Users\Ana\site; no Mac, Sistema: Darwin (o nome do núcleo do macOS), / e /Users/ana/site. As constantes deixam o mesmo programa funcionar nos três sistemas:

PHP_OS_FAMILY

A família do sistema: Windows, Darwin (macOS), Linux, BSD…

DIRECTORY_SEPARATOR

O caractere que separa as pastas num caminho: \ no Windows, / nos outros. (Na prática, o PHP aceita / também no Windows.)

__DIR__

A pasta onde está o arquivo que está rodando. Começa e termina com dois sublinhados; é uma "constante mágica" (aula Constantes).

Rode o mesmo programa no PHP do navegador. Que sistema ele diz que é?

<?php
echo "Sistema: " . PHP_OS_FAMILY . "\n";
echo "Separador de pastas: " . DIRECTORY_SEPARATOR . "\n";
echo "Pasta deste arquivo: " . __DIR__ . "\n";
echo "Versão: " . PHP_VERSION . "\n";

O PHP do navegador responde Sistema: Unknown ("desconhecido"): ele roda num "computador de mentirinha" dentro da página, que não é Windows, nem macOS, nem Linux, com o seu próprio sistema de arquivos na memória. Por isso a pasta (/home/ana) não é nenhuma das suas. A aula O Editor do Guia explica.

Quando dá errado

php : O termo 'php' não é reconhecido como nome de cmdlet, função, arquivo de script ou programa operável.

Referência

Para fechar, uma missão sobre algo que muda entre os sistemas: a quebra de linha. O Linux e o macOS usam um caractere (\n); o Windows, tradicionalmente, dois (\r\n). A constante PHP_EOL (End Of Line, "fim de linha") vale a quebra certa para o sistema onde o PHP está rodando.

<?php
echo "linha 1";
echo "linha 2";

<?php
echo "linha 1" . PHP_EOL;
echo "linha 2" . PHP_EOL;

A aula echo e print compara "\n", PHP_EOL e <br>.

Exercícios

Resumo

• Windows: Visual C++ 2015-2022 → zip VS17 x64 Non Thread Safe em C:\php → php.ini-development copiado para php.ini → extensões sem ; → C:\php no PATH → terminal novo → php -v.
• Atalhos no Windows: winget install --id PHP.PHP.8.5 -e; pacotes completos (Laragon, XAMPP); ou o WSL com Ubuntu.
• macOS: Homebrew → brew install php (8.5.11 em out/2026) → php -v.
• php --ini e php -m funcionam igual nos três sistemas. which php / where.exe php mostram qual PHP está sendo usado.
• PHP_OS_FAMILY, DIRECTORY_SEPARATOR e PHP_EOL ajudam o mesmo código a rodar em qualquer sistema.
• Próximo passo: O Servidor Embutido.