Para começar a programar em PHP, é necessário preparar um ambiente de desenvolvimento. Nesta aula, você aprenderá diferentes formas de instalar o PHP, desde a instalação manual até o uso de pacotes como XAMPP. Também veremos como usar o servidor embutido do PHP para testar rapidamente seus scripts e como configurar o VSCode com extensões que facilitam a escrita de código.

Independentemente do sistema operacional (Windows, macOS ou Linux), existem opções flexíveis. Vamos explorar cada uma delas com exemplos práticos.

Instalando o PHP

A instalação manual do PHP é a abordagem mais flexível, permitindo que você escolha a versão exata e as extensões necessárias. No Windows, baixe o pacote zip do site oficial (windows.php.net), extraia para uma pasta (ex.: C:\php) e adicione esse diretório ao PATH do sistema. No Linux, utilize o gerenciador de pacotes: sudo apt install php (Debian/Ubuntu) ou sudo yum install php (CentOS/RHEL). No macOS, você pode usar o Homebrew: brew install php.

Após a instalação, verifique a versão com o comando php -v. Se o comando não for reconhecido, verifique se o diretório do PHP está no PATH. Exemplo de saída esperada:

PHP 8.2.0 (cli) (built: Nov 30 2022 10:00:00) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.2.0, Copyright (c) Zend Technologies

Servidor embutido (php -S)

O PHP possui um servidor web embutido, ideal para desenvolvimento e testes. Para iniciá-lo, navegue até o diretório do seu projeto e execute: php -S localhost:8000. Isso cria um servidor HTTP na porta 8000, servindo arquivos do diretório atual. Você pode acessar http://localhost:8000.

Para usar um roteador personalizado (front controller), especifique um arquivo PHP: php -S localhost:8000 router.php. Exemplo de router.php:

 'ok']);
    exit;
}
return false; // serve o arquivo estático

O servidor embutido é leve e não requer configuração adicional, mas não é recomendado para produção devido à falta de recursos como suporte a múltiplas requisições simultâneas.

XAMPP vs instalação manual

XAMPP é um pacote que inclui PHP, Apache, MySQL e outros componentes, facilitando a configuração de um ambiente completo. É ideal para iniciantes, pois oferece uma interface gráfica (Painel de Controle) para iniciar/parar serviços. A instalação é simples: baixe o instalador do site oficial (apachefriends.org) e siga as instruções.

Já a instalação manual oferece mais controle e é recomendada para quem deseja personalizar cada componente. Com XAMPP, você obtém um ambiente pré-configurado, mas pode ter versões desatualizadas ou conflitos com outras instalações. A escolha depende do seu nível de experiência e necessidades. Para projetos simples, XAMPP é suficiente; para ambientes de produção ou desenvolvimento avançado, a instalação manual é preferível.

VSCode e extensões

O Visual Studio Code é um editor de código leve e poderoso. Para PHP, instale as seguintes extensões:

  • PHP Intelephense: fornece autocompletar, navegação e diagnóstico de erros.
  • PHP Debug: permite depuração com Xdebug.
  • PHP DocBlocker: gera comentários de documentação.
  • Composer: integração com o gerenciador de dependências.

Após instalar as extensões, configure o VSCode para usar o executável PHP correto. No arquivo settings.json (Ctrl+Shift+P, digite "settings"), adicione:

{
    "php.validate.executablePath": "C:/php/php.exe",
    "php.executablePath": "C:/php/php.exe"
}

Ajuste o caminho conforme sua instalação. Com isso, você terá realce de sintaxe, autocompletar e depuração funcionando.

Boas práticas

Sempre mantenha o PHP atualizado para evitar vulnerabilidades. Use o servidor embutido para testes rápidos e o XAMPP para projetos que exigem Apache e MySQL. No VSCode, configure o PHP Debug com Xdebug para depurar passo a passo. Além disso, considere usar o Composer para gerenciar dependências desde o início.

Referências

Exercícios

  1. Instale o PHP manualmente no seu sistema operacional. Verifique a versão com php -v. Qual comando você usou e qual saída obteve?

    ✓ Resposta: No Windows, baixe o zip, extraia e adicione ao PATH. No Linux: sudo apt install php. No macOS: brew install php. Depois, execute php -v; a saída deve mostrar a versão, por exemplo: 
    PHP 8.2.0 (cli) (built: ...)

  2. Crie um arquivo index.php com o conteúdo <?php echo "Olá, mundo!"; ?>. Inicie o servidor embutido na porta 8080 e acesse via navegador. Descreva o processo.

    ✓ Resposta: Execute php -S localhost:8080 no diretório do arquivo. Acesse http://localhost:8080; a página exibirá "Olá, mundo!".

  3. Baixe e instale o XAMPP. Inicie o Apache e crie um arquivo PHP na pasta htdocs. Acesse via http://localhost/seuarquivo.php. Qual a diferença para o servidor embutido?

    ✓ Resposta: O XAMPP fornece Apache + MySQL, enquanto o servidor embutido é apenas PHP puro. O XAMPP é mais completo para projetos com banco de dados, mas mais pesado.

  4. Instale o VSCode e adicione as extensões PHP Intelephense e PHP Debug. Configure o caminho do executável PHP. Mostre as configurações no settings.json.

    ✓ Resposta: No VSCode, vá em Extensões e instale as mencionadas. Depois, em settings.json adicione: 
    {
    "php.validate.executablePath": "/usr/bin/php",
    "php.executablePath": "/usr/bin/php"
}
    Ajuste o caminho conforme seu sistema.

  5. Crie um script PHP que use o servidor embutido com um roteador personalizado. O roteador deve redirecionar requisições para /api para um JSON e as demais para arquivos estáticos. Teste ambas as rotas.

    ✓ Resposta: Crie um arquivo router.php com: 
    <?php
$uri = $_SERVER['REQUEST_URI'];
if ($uri === '/api') {
    header('Content-Type: application/json');
    echo json_encode(['message' => 'API funcionando']);
    exit;
}
return false;
?>
    Inicie com php -S localhost:8080 router.php. Acesse /api e veja o JSON; acesse /index.html (se existir) e veja o arquivo estático.