Configurando seu ambiente de desenvolvimento
Para programar em PHP, você precisa apenas de duas coisas: um ambiente de servidor capaz de executar PHP e um editor de código. Esta lição vai ajudá-lo a configurar ambos — e, em seguida, a escrever sua primeira linha de código em PHP.
1. Escolhendo um ambiente de desenvolvimento em PHP
Para executar o PHP, é necessário um servidor web + mecanismo PHP + banco de dados. Você pode instalar o Apache/Nginx, o PHP e o MySQL separadamente, mas é muito mais simples usar um pacote completo que funcione imediatamente.
| Pacote | Plataforma | Observações |
|---|---|---|
| XAMPP | Windows / Mac / Linux | O mais popular; Apache + MariaDB (MySQL) + PHP + Perl |
| Laragon | Windows | Leve e rápido, com hosts virtuais automáticos — recomendado para usuários do Windows |
| MAMP | Mac / Windows | A melhor opção para usuários de Mac |
| Laravel Herd | Mac / Windows | Ferramenta oficial do Laravel, mas voltada para o framework |
Este tutorial utiliza o XAMPP (multiplataforma, completo e fácil de configurar). Se você usa o Windows, o Laragon também é uma excelente opção.
2. Instalando o XAMPP
(1) Passo 1: Baixar
Acesse https://www.apachefriends.org/ e clique no botão “Download” correspondente ao seu sistema operacional.
(2) Etapa 2: Instalar
Clique duas vezes no instalador baixado e siga as instruções. Lembre-se dos seguintes pontos:
- Caminho de instalação: Use o padrão
C:\xampp\(Windows) ou/Applications/XAMPP/(Mac) - Seleção de componentes: No mínimo, marque Apache, MySQL, PHP e phpMyAdmin
- O firewall pode exibir uma mensagem durante a instalação — clique em “Permitir acesso”
(3) Etapa 3: Iniciar
Abra o Painel de Controle do XAMPP e clique nos botões Iniciar ao lado de Apache e MySQL:
XAMPP Control Panel
┌──────────────────────────────────────────┐
│ Apache [Start] → Ports 80, 443 │
│ MySQL [Start] → Port 3306 │
│ FileZilla [Start] (not needed) │
│ Mercury [Start] (not needed) │
│ Tomcat [Start] (not needed) │
└──────────────────────────────────────────┘
Quando você vir “Em execução” com fundo verde ao lado do Apache e do MySQL, significa que tudo está funcionando.
(4) Etapa 4: Verificar
Abra seu navegador e acesse http://localhost/. Se você vir a página de boas-vindas do XAMPP, significa que tudo está funcionando.
Então acesse http://localhost/phpmyadmin/. Se você vir a interface do phpMyAdmin, significa que o MySQL também está em execução.
3. Instalando o VS Code
Você só precisa de um editor de texto para escrever código PHP. Recomendamos o VS Code (gratuito, leve e com um rico ecossistema de extensões).
Após a instalação, adicione estas duas extensões recomendadas:
| Extensão | Finalidade |
|---|---|
| PHP Intelephense | Sugestões de código, autocompletar, verificação de erros |
| Servidor PHP | Servidor PHP integrado com instalação em um clique (opcional; você não precisará disso com o XAMPP) |
Clique no ícone “Extensões” na barra lateral do VS Code (ou pressione Ctrl+Shift+X), procure o nome da extensão e clique em “Instalar”.
4. Seu primeiro programa em PHP
(1) Localize o diretório raiz da Web do XAMPP
XAMPP serves files from the htdocs directory:
| Sistema | Caminho |
|---|---|
| Windows | C:\xampp\htdocs\ |
| Mac | /Applications/XAMPP/htdocs/ |
| Linux | /opt/lampp/htdocs/ |
Dentro de htdocs, crie uma nova pasta chamada myphp:
htdocs/
└── myphp/
└── index.php ← We'll create this file
(2) Criar o arquivo index.php
Abra a pasta htdocs\myphp\ no VS Code (Arquivo → Abrir pasta), em seguida, crie um novo arquivo chamado index.php e insira o seguinte código:
▶ Exemplo: Hello World
<?php
echo "Hello, PHP!";
echo "<br>";
echo "Today is " . date("F j, Y");
echo "<br>";
// Display PHP version and configuration info
phpinfo();
?>
Salve o arquivo e, em seguida, acesse http://localhost/myphp/ no seu navegador. Você deverá ver:
- “Olá, PHP!”
- Data de hoje
- Uma página roxa com informações de configuração do PHP (gerada por
phpinfo())
Parabéns! Você executou com sucesso seu primeiro programa em PHP.
echo é a instrução de saída mais usada no PHP — ela envia conteúdo para a página HTML. A função date() retorna a hora atual. O . (ponto) é o operador de concatenação de strings do PHP. Abordaremos tudo isso em detalhes nas próximas aulas.
5. Regras para arquivos PHP
| Regra | Explicação |
|---|---|
| Extensão do arquivo | Deve ser .php (não .html) |
| Tags PHP | O código PHP fica entre <?php e ?> |
| Localização do arquivo | Deve estar dentro da raiz de documentos do servidor web (por exemplo, htdocs) |
| Como acessar | Acesse por meio do http://localhost/... — não é possível clicar duas vezes no arquivo para abri-lo |
| Arquivos puramente em PHP | Se um arquivo contiver apenas código PHP, você pode omitir a tag de fechamento ?> |
▶ Exemplo: Arquivo em PHP puro (recomendado sem ?>)
<?php
$name = "John";
$age = 18;
echo "My name is {$name} and I'm {$age} years old.";
?> de fechamento em arquivos de PHP puro é uma prática recomendada pela comunidade PHP. Por quê? Porque qualquer espaço em branco ou linha em branco após o ?> pode ser acidentalmente enviado, o que pode causar falhas no envio de cabeçalhos HTTP. Esse é um pequeno detalhe, mas é importante adotar bons hábitos desde o início.
6. Como o PHP é executado — Resumo
┌──────────┐ Request ┌──────────┐ Execute PHP ┌──────────┐
│ Browser │ ──────────→ │ Apache │ ──────────→ │ PHP Engine│
│ │ ←─────────── │ (Web Srv) │ ←────────── │ │
└──────────┘ HTML Resp. └──────────┘ Generate HTML└──────────┘
↑ ↓
└─────────────── http://localhost/ ─────────────────────┘
O PHP deve ser acessado por meio de um servidor web (http://localhost/...). Não é possível clicar duas vezes em um arquivo .php da mesma forma que se faz com arquivos .html. Ao clicar duas vezes em um arquivo .php, será exibido o código-fonte bruto, e não o resultado da execução.
❓ Perguntas Frequentes
P: Por que, ao acessar o localhost, o arquivo .php é baixado em vez de exibir o resultado da execução do PHP? R: O módulo PHP do Apache não está carregado corretamente. Verifique se o Apache apresenta o status “Em execução” (verde) no Painel de Controle do XAMPP e, em seguida, confirme se o arquivo httpd.conf contém a linha de configuração
LoadModule php_module.
P: E se a porta 80 já estiver em uso após a instalação do XAMPP? R: Você pode alterar a porta. No Painel de Controle do XAMPP, vá até Configuração do Apache → httpd.conf → procure por “Listen 80” → altere para “Listen 8080” → salve e reinicie o Apache. Depois disso, acesse o site em http://localhost:8080/.
P: O Mac já vem com o PHP pré-instalado — ainda preciso do XAMPP? R: O Mac realmente vem com o PHP, mas geralmente é uma versão mais antiga e não inclui o MySQL nem o phpMyAdmin. Recomenda-se instalar o XAMPP ou o Laravel Herd — eles são muito mais fáceis de gerenciar.
📖 Resumo
- O XAMPP inclui o Apache, o PHP e o MySQL — basta instalar uma vez e está pronto para uso
- A raiz da web do XAMPP é
htdocs/— os arquivos PHP devem ser colocados nesse local para que possam ser acessados pelo navegador - O código PHP deve ser colocado entre as tags
<?php ?>; os arquivos devem ter a extensão.php - Acesse páginas PHP por meio do
http://localhost/— nunca clique duas vezes para abrir echoexibe o conteúdo na página;.concatena strings- Para arquivos em PHP puro, omita a tag de fechamento
?>
📝 Exercícios
- Instale o XAMPP e o VS Code, inicie o Apache e acesse
http://localhost/. Faça uma captura de tela da página de boas-vindas do XAMPP. - Dentro de
htdocs/myphp/, crieabout.phpe useechopara exibir seu nome, cidade e a hora atual. - Acesse
http://localhost/myphp/about.phpe verifique se está funcionando. Faça uma captura de tela do resultado.



