Como Instalar o PHP

PHP (Hypertext Preprocessor) é uma linguagem de script server-side amplamente utilizada para o desenvolvimento de aplicações web dinâmicas. Antes de executar qualquer código PHP, você precisa de um interpretador PHP instalado em sua máquina. Este guia mostra como instalar o PHP no Windows, macOS e Linux, escolher a configuração certa para o seu objetivo e verificar se tudo funciona.

Se você é completamente novo na linguagem, leia primeiro a Introdução ao PHP para entender o que é o PHP e onde ele é executado.

Qual instalação devo escolher?

Não existe uma forma "correta" única de instalar o PHP — a melhor opção depende do que você deseja fazer:

• Apenas aprendendo a linguagem? Instale o interpretador PHP CLI (linha de comando). O PHP vem com um servidor de desenvolvimento integrado, portanto você não precisa do Apache ou Nginx para começar.
• Construindo uma pilha web completa? Use um pacote tudo-em-um como XAMPP, MAMP ou Laragon. Eles instalam o PHP, o Apache (ou Nginx) e o MySQL juntos com um clique.
• Trabalhando em um projeto real? Instale o PHP através do gerenciador de pacotes do seu sistema (apt, brew, choco). Esta é a abordagem mais limpa e atualizável para desenvolvedores.

A tabela abaixo resume as diferenças:

Pré-requisitos

Antes de começar, certifique-se de ter:

• Um computador rodando Windows, macOS ou Linux.
• Um editor de texto como Visual Studio Code, Sublime Text ou Notepad++.
• Acesso a um terminal (Prompt de Comando ou PowerShell no Windows, Terminal no macOS/Linux).
• Um servidor web (Apache ou Nginx) somente se você não for usar o servidor de desenvolvimento integrado.

Instalando o PHP por sistema operacional

Windows

O caminho mais simples no Windows é o gerenciador de pacotes Chocolatey. Em um PowerShell elevado:

choco install php

Prefere uma instalação manual? Baixe o Zip mais recente non-thread-safe da página oficial de downloads do PHP, extraia para C:\php e adicione C:\php à variável de ambiente Path para que o comando php esteja disponível em qualquer lugar.

macOS

Homebrew é a ferramenta padrão:

brew install php

O Homebrew vincula o binário php ao seu PATH automaticamente.

Linux (Debian/Ubuntu)

Use o apt:

sudo apt update
sudo apt install php php-cli

No Fedora/RHEL o equivalente é sudo dnf install php php-cli.

Verificando a instalação

Independentemente do método utilizado, confirme que o PHP está no seu PATH verificando a versão em um terminal:

php -v

Você deve ver uma saída semelhante a esta (o número da versão pode variar):

PHP 8.3.6 (cli) (built: ...) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.3.6, ...

Se você receber um erro "command not found", o diretório do PHP não foi adicionado ao seu PATH — revise o passo de instalação para o seu sistema operacional.

Executando o PHP sem um servidor web

O PHP inclui um servidor de desenvolvimento integrado, que é a forma mais rápida de executar páginas enquanto aprende. Crie um arquivo chamado index.php:

<?php
echo "Hello from PHP " . PHP_VERSION;

Em seguida, inicie o servidor nessa pasta e abra a URL que ele exibir:

php -S localhost:8000

Acesse http://localhost:8000 no seu navegador. O servidor integrado é apenas para desenvolvimento — nunca o exponha à internet pública.

Configurando o PHP com o Apache

1. Abra o arquivo de configuração do Apache localizado na pasta de instalação do Apache (geralmente conf/httpd.conf no Windows ou /etc/apache2/apache2.conf no Linux/macOS).
2. Encontre a diretiva de carregamento do módulo PHP. Para instalações manuais no Windows, ela geralmente tem a seguinte aparência:

#LoadModule php_module "modules/php8apache2_4.dll"

3. Remova o símbolo # para descomentar a linha, certifique-se de que o caminho corresponde ao diretório de instalação do PHP e salve e feche o arquivo. (Nota: No Linux/macOS, o PHP geralmente é habilitado via gerenciadores de pacotes usando comandos como sudo a2enmod php8.2.)
4. Reinicie o Apache para aplicar as alterações.

Testando a Instalação do PHP

1. Crie um novo arquivo com extensão .php (ex.: index.php) na pasta raiz do seu servidor web (geralmente htdocs ou /var/www/html no Linux/macOS).
2. Insira o seguinte código no arquivo:

3. Salve e feche o arquivo.
4. Abra um navegador web e acesse http://localhost/index.php.
5. Se tudo estiver configurado corretamente, você verá uma página exibindo informações sobre a instalação do PHP. Você também pode verificar a instalação pela linha de comando executando php -v.

Problemas comuns na instalação

• php não é reconhecido / command not found. A pasta do PHP está ausente do seu PATH. Reabra o terminal após editar o PATH, pois as alterações só se aplicam a novas sessões de shell.
• phpinfo() aparece como texto simples. O navegador baixou o arquivo ou o servidor web não está processando PHP. Certifique-se de ter aberto pelo endereço http://localhost (servido por um servidor web), e não clicando duas vezes no arquivo.
• Versão errada do PHP. Se várias versões estiverem instaladas, php -v mostra a que aparece primeiro no seu PATH. Ajuste a ordem ou use o caminho completo (ex.: /usr/local/opt/[email protected]/bin/php).

Próximos passos

Agora que o PHP está rodando na sua máquina, continue com:

• Sintaxe PHP — como um script PHP é estruturado.
• Variáveis PHP — armazenando e reutilizando dados.
• PHP Echo e Print — exibindo conteúdo na página.

Conclusão

Agora você tem o PHP instalado e verificado, além da capacidade de executar scripts pelo Apache ou pelo servidor de desenvolvimento integrado do PHP. Escolha o fluxo de trabalho que se encaixa no seu objetivo — o servidor CLI para aprendizado rápido, ou uma pilha completa Apache/Nginx para aplicações reais — e você está pronto para começar a escrever PHP.

Prática