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.

💡 Dica: Escolha uma versão com PHP 8.2 ou 8.3. Todo o código deste tutorial requer PHP 8.2 ou superior.

(2) Etapa 2: Instalar

Clique duas vezes no instalador baixado e siga as instruções. Lembre-se dos seguintes pontos:

(3) Etapa 3: Iniciar

Abra o Painel de Controle do XAMPP e clique nos botões Iniciar ao lado de Apache e MySQL:

TEXT
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.

⚠️ Atenção: Se o localhost não abrir, a causa mais comum é um conflito de porta (por exemplo, o Skype ou outro aplicativo usando a porta 80). No Painel de Controle do XAMPP, altere a porta do Apache: Config → Apache (httpd.conf) → procure por “Listen 80” → altere para “Listen 8080” → reinicie o Apache.


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:

TEXT
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
<?php
echo "Hello, PHP!";
echo "<br>";
echo "Today is " . date("F j, Y");
echo "<br>";

// Display PHP version and configuration info
phpinfo();
?>
▶ Experimente

Salve o arquivo e, em seguida, acesse http://localhost/myphp/ no seu navegador. Você deverá ver:

Parabéns! Você executou com sucesso seu primeiro programa em PHP.

💡 Dica: 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
<?php
$name = "John";
$age = 18;
echo "My name is {$name} and I'm {$age} years old.";
▶ Experimente
💡 Dica: Omitir o ?> 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

TEXT
┌──────────┐   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

📝 Exercícios

  1. 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.
  2. Dentro de htdocs/myphp/, crie about.php e use echo para exibir seu nome, cidade e a hora atual.
  3. Acesse http://localhost/myphp/about.php e verifique se está funcionando. Faça uma captura de tela do resultado.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%