Configurando o Ambiente de Desenvolvimento

Nathan Geeksman 3 visualizações

Antes de escrever qualquer programa, você precisa de um ambiente onde o PHP possa rodar. Neste artigo vamos instalar o PHP, conhecer o servidor embutido, escolher um editor de código e entender a estrutura básica de um arquivo PHP. O objetivo é que, ao final, você tenha tudo configurado e rode seu primeiro programa com sucesso.

Instalando o PHP

A forma de instalar o PHP varia conforme o sistema operacional.

No Linux (Ubuntu/Debian):

sudo apt update
sudo apt install php php-cli php-mbstring php-xml php-curl

No macOS (com Homebrew):

brew install php

No Windows:

A maneira mais simples no Windows é instalar o XAMPP (disponível em apachefriends.org), que inclui PHP, Apache e MySQL em um único instalador. Alternativamente, você pode baixar o PHP diretamente em php.net/downloads e configurar o PATH manualmente.

Após a instalação, abra o terminal e confirme:

php --version

A saída deve mostrar algo como PHP 8.3.x. Se apareceu, está funcionando.

O servidor embutido do PHP

Para desenvolvimento local, o PHP possui um servidor web embutido que elimina a necessidade de instalar Apache ou Nginx. Basta apontar para uma pasta e ele serve os arquivos:

# Navegue até a pasta do projeto
cd meu-projeto

# Inicie o servidor na porta 8000
php -S localhost:8000

Abra o navegador em http://localhost:8000 e o PHP servirá os arquivos da pasta. Para encerrar, pressione Ctrl + C no terminal.

Esse servidor é suficiente para todo o Módulo 1 e 2 desta série. Nos módulos mais avançados, usaremos Docker para ambientes mais próximos da produção.

Escolhendo o editor de código

Você pode escrever PHP em qualquer editor de texto, mas algumas ferramentas tornam a experiência muito mais produtiva:

VS Code é a escolha mais popular e recomendada para iniciantes. Gratuito, extensível e com excelente suporte a PHP. Instale as extensões PHP Intelephense (autocomplete inteligente) e PHP Debug (depuração).

PhpStorm é o IDE profissional mais completo para PHP, desenvolvido pela JetBrains. É pago (com período de avaliação gratuito), mas oferece recursos que aumentam significativamente a produtividade em projetos maiores.

Para esta série, usaremos exemplos que funcionam em qualquer editor. A recomendação é VS Code com Intelephense.

Estrutura de um arquivo PHP

Um arquivo PHP tem extensão .php. Dentro dele, você pode escrever HTML puro, PHP puro, ou misturar os dois. O código PHP sempre fica dentro das tags de abertura e fechamento:

<?php
// Código PHP aqui
?>

Quando o arquivo contém apenas PHP (sem HTML), a boa prática é omitir a tag de fechamento ?>. Isso evita que espaços em branco acidentais sejam enviados para o navegador antes dos headers HTTP, o que pode causar erros em redirecionamentos e cookies.

<?php
// Arquivo apenas com PHP: sem tag de fechamento
echo "Olá, mundo!";

Seu primeiro programa

Crie uma pasta chamada php-curso e, dentro dela, um arquivo index.php:

<?php

// echo envia texto para a saída (navegador ou terminal)
echo "Olá, Mundo!\n";

// Podemos exibir o resultado de expressões diretamente
echo 2 + 2;
echo "\n";

// date() é uma função nativa que formata datas
// "d/m/Y" significa: dia/mês/ano com quatro dígitos
echo "Hoje é: " . date("d/m/Y");

No terminal, dentro da pasta php-curso, rode:

php index.php

Saída esperada:

Olá, Mundo!
4
Hoje é: 05/03/2026

Você pode também iniciar o servidor embutido e acessar pelo navegador — o resultado será o mesmo, mas sem a formatação de quebra de linha (pois o navegador interpreta HTML, e \n não é uma quebra de linha em HTML).

Exibindo HTML pelo PHP

Quando rodando no servidor web, o PHP gera HTML. Veja como ficaria uma página completa:

<?php
$nome = "Ricardo";
$data = date("d/m/Y");
?>
<!DOCTYPE html>
<html lang="pt-BR">
<head>
    <meta charset="UTF-8">
    <title>Meu primeiro PHP</title>
</head>
<body>
    <h1>Bem-vindo, <?php echo $nome; ?>!</h1>
    <p>Hoje é <?php echo $data; ?>.</p>
</body>
</html>

Perceba que abrimos e fechamos o bloco PHP várias vezes. Isso é válido e muito comum em templates PHP. Existe também uma forma abreviada de echo para usar dentro do HTML:

<h1>Bem-vindo, <?= $nome ?>!</h1>

O <?= é um atalho para <?php echo. Ele é muito utilizado em arquivos de template onde PHP e HTML se misturam com frequência.

Boas práticas desde o início

Já neste terceiro artigo, é hora de introduzir alguns hábitos que farão diferença ao longo da sua carreira:

Use UTF-8 sempre. Declare charset=UTF-8 em seus HTMLs e salve seus arquivos em UTF-8. Isso evita problemas com acentuação que são frustrantes de diagnosticar.

Um arquivo, uma responsabilidade. Evite criar arquivos PHP gigantes que fazem tudo ao mesmo tempo. Desde cedo, pense em separar responsabilidades.

Nomeie variáveis com clareza. $nomeDoUsuario é infinitamente melhor que $n. Código se lê muito mais do que se escreve — clareza é respeito pelo seu eu futuro.

Indentação consistente. Use 4 espaços por nível de indentação (padrão PSR-2/PSR-12, os padrões oficiais da comunidade PHP). Configure seu editor para isso.

Resumo

Tópico	O que aprendemos
Instalação	`apt`, `brew` ou XAMPP dependendo do OS
Servidor embutido	`php -S localhost:8000` para desenvolvimento
Editor	VS Code com PHP Intelephense
Estrutura	`<?php ... ?>` ou `<?= ... ?>` para atalho de echo
Primeiro programa	`echo`, `date()`, mistura PHP + HTML
Boas práticas	UTF-8, nomenclatura clara, indentação consistente

No próximo artigo: Variáveis, tipos de dados e operadores — a base de toda lógica PHP.

Os três primeiros artigos estão escritos. Perceba a progressão:

Artigo 01 — Contexto e motivação (por que PHP)
Artigo 02 — História completa, de 1994 ao PHP 8
Artigo 03 — Ambiente configurado, primeiro código rodando

Diga "Continue" para os próximos artigos (04 em diante), ou me diga se quer ajustar alguma coisa no estilo, profundidade ou formato.

you asked

Ficou ótimo o html. Tem como por em texto e aí em html? Fazer assim com cada artigo? Não vi referências pra aprofundar os estudos. Refaça por favor desse jeito texto depois html

Artigo 03 — Configurando o Ambiente de Desenvolvimento

Módulo 1 · Semana 3 · Nível: Iniciante

Introdução

Antes de escrever qualquer programa, você precisa de um lugar onde o PHP possa rodar. Esse lugar é o seu ambiente de desenvolvimento — a combinação de ferramentas instaladas na sua máquina que permite escrever, executar e depurar código PHP. Configurar esse ambiente corretamente desde o início poupa horas de frustração no futuro.

Neste artigo vamos instalar o PHP, conhecer o servidor embutido, escolher um editor de código, entender a estrutura básica de um arquivo PHP e rodar nosso primeiro programa de verdade.

Instalando o PHP

A instalação varia conforme o sistema operacional. Em todos os casos, o objetivo é ter o comando php disponível no terminal.

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install php php-cli php-mbstring php-xml php-curl

macOS (com Homebrew):

brew install php

Se você não tem o Homebrew instalado, acesse https://brew.sh e siga as instruções — é o gerenciador de pacotes padrão para macOS.

Windows:

A forma mais direta é instalar o XAMPP, disponível em https://www.apachefriends.org. Ele inclui PHP, Apache e MySQL em um único instalador com interface gráfica. Após a instalação, adicione o caminho do PHP ao PATH do sistema para usar o comando php no terminal.

Alternativamente, baixe o PHP diretamente em https://windows.php.net/download e siga as instruções de configuração manual do PATH.

Após qualquer instalação, abra o terminal e confirme:

php --version

A saída deve mostrar algo como PHP 8.3.x (cli). Se apareceu, está funcionando.

O servidor embutido do PHP

Para desenvolvimento local, o PHP possui um servidor web embutido que elimina a necessidade de instalar Apache ou Nginx. Você aponta para uma pasta e ele serve os arquivos PHP diretamente:

# Navegue até a pasta do projeto
cd meu-projeto

# Inicie o servidor na porta 8000
php -S localhost:8000

Abra o navegador em http://localhost:8000. O PHP servirá os arquivos da pasta atual. Para encerrar, pressione Ctrl + C no terminal.

Você também pode especificar um arquivo de entrada específico, útil quando há um ponto de entrada único:

# Usar index.php como ponto de entrada para todas as requisições
php -S localhost:8000 index.php

Esse servidor é suficiente para os Módulos 1 a 5 desta série. Nos módulos avançados, usaremos Docker para ambientes mais próximos da produção real.

Escolhendo o editor de código

Você pode escrever PHP em qualquer editor de texto, mas ferramentas certas aumentam a produtividade de forma significativa.

VS Code é a escolha mais popular e a recomendada para esta série. Gratuito, extensível e com excelente suporte a PHP. Baixe em https://code.visualstudio.com e instale as extensões:

PHP Intelephense — autocomplete inteligente, navegação de código, detecção de erros em tempo real
PHP Debug — integração com Xdebug para depuração com breakpoints
PHP CS Fixer — formata o código automaticamente seguindo os padrões PSR

PhpStorm é o IDE profissional mais completo para PHP, desenvolvido pela JetBrains. Disponível em https://www.jetbrains.com/phpstorm. É pago, com período de avaliação de 30 dias. Oferece recursos avançados que fazem diferença em projetos grandes. Vale considerar quando você estiver no Módulo 7 em diante.

Para esta série, VS Code com Intelephense atende muito bem.

Estrutura de um arquivo PHP

Um arquivo PHP tem extensão .php. Dentro dele, você pode escrever HTML puro, PHP puro, ou misturar os dois. O código PHP sempre fica dentro das tags de abertura e fechamento:

<?php
// Código PHP aqui
?>

Quando o arquivo contém apenas PHP — sem HTML —, a boa prática é omitir a tag de fechamento ?>. Isso evita que espaços em branco acidentais sejam enviados ao navegador antes dos headers HTTP, o que causa erros em redirecionamentos e cookies.

<?php
// Arquivo puramente PHP: sem tag de fechamento no final
// Isso é um padrão da comunidade — siga sempre

echo "Olá, mundo!";

Seu primeiro programa

Crie uma pasta chamada php-curso e dentro dela um arquivo index.php com o seguinte conteúdo:

<?php

// echo envia texto para a saída — navegador ou terminal
echo "Olá, Mundo!\n";

// Expressões matemáticas são avaliadas antes de serem exibidas
echo 2 + 2;
echo "\n";

// date() é uma função nativa que formata a data atual
// "d/m/Y" = dia/mês/ano com quatro dígitos
echo "Hoje é: " . date("d/m/Y");
echo "\n";

// phpinfo() exibe informações completas sobre a instalação do PHP
// Extremamente útil para diagnóstico — mas nunca deixe em produção
// phpinfo();

No terminal, dentro da pasta php-curso, rode:

php index.php

Saída esperada:

Olá, Mundo!
4
Hoje é: 05/03/2026

Você pode também iniciar o servidor embutido e acessar pelo navegador — o resultado será o mesmo conteúdo, mas sem quebras de linha visíveis, pois o navegador interpreta HTML, e \n não é uma quebra de linha em HTML (para isso seria necessário <br>).

Misturando PHP com HTML

Quando rodando no servidor web, o PHP gera HTML. Essa é a forma mais comum de usar PHP em projetos web tradicionais:

<?php
// Definimos as variáveis no início do arquivo — antes de qualquer HTML
$nome = "Ricardo";
$data = date("d/m/Y");
$hora = date("H:i");
?>
<!DOCTYPE html>
<html lang="pt-BR">
<head>
    <meta charset="UTF-8">
    <title>Meu primeiro PHP</title>
</head>
<body>
    <h1>Bem-vindo, <?= $nome ?>!</h1>

    <!--
        <?= $variavel ?> é um atalho para <?php echo $variavel; ?>
        Use-o em templates HTML para manter o código mais limpo
    -->
    <p>Hoje é <?= $data ?>, são <?= $hora ?>.</p>

</body>
</html>

O <?= é chamado de short echo tag. É um atalho para <?php echo. Use-o em arquivos de template onde PHP e HTML se misturam com frequência — o código fica mais limpo e legível.

Depurando com var_dump e print_r

Dois dos comandos mais úteis para inspecionar valores durante o desenvolvimento:

<?php

$nome  = "Ana";
$idade = 28;
$ativo = true;
$notas = [9.5, 8.0, 7.5];

// echo exibe o valor como string — simples, mas sem informação de tipo
echo $nome;
echo "\n";

// var_dump exibe o tipo e o valor — essencial para depuração
// Mostra: string(3) "Ana"
var_dump($nome);

// var_dump em booleano mostra true ou false com o tipo
// Mostra: bool(true)
var_dump($ativo);

// var_dump em array mostra toda a estrutura com tipos
var_dump($notas);

// print_r exibe arrays e objetos de forma mais legível para humanos
// Menos verboso que var_dump — bom para estruturas complexas
print_r($notas);

Saída de var_dump($notas):

array(3) {
  [0] => float(9.5)
  [1] => float(8)
  [2] => float(7.5)
}

Saída de print_r($notas):

Array
(
    [0] => 9.5
    [1] => 8
    [2] => 7.5
)

Use var_dump quando precisar saber o tipo exato. Use print_r quando só precisar ver a estrutura dos dados.

Boas práticas desde o início

Alguns hábitos que farão diferença ao longo de toda a sua carreira:

Use UTF-8 sempre. Declare charset=UTF-8 em seus HTMLs e salve seus arquivos em UTF-8 no editor. Isso evita problemas com acentuação que são frustrantes de diagnosticar.

Omita a tag de fechamento ?> em arquivos puramente PHP. É um padrão do PSR-12, o guia de estilo oficial da comunidade PHP.

Use 4 espaços por nível de indentação. Também é definido pelo PSR-12. Configure seu editor para inserir espaços automaticamente ao pressionar Tab.

Nomeie variáveis com clareza. $nomeDoUsuario é infinitamente melhor que $n. Código é lido muito mais do que escrito — clareza é respeito pelo seu eu futuro, e por quem trabalhar com você.

Um arquivo, uma responsabilidade. Desde cedo, evite arquivos PHP gigantes que fazem tudo ao mesmo tempo. Separar responsabilidades é o fundamento de todo bom design de software.

Resumo

Tópico	O que aprendemos
Instalação	`apt`, `brew` ou XAMPP dependendo do sistema operacional
Servidor embutido	`php -S localhost:8000` para desenvolvimento local
Editor recomendado	VS Code com extensão PHP Intelephense
Estrutura do arquivo	`<?php ... ?>` ou `<?= ... ?>` para atalho de echo
Primeiro programa	`echo`, `date()`, mistura de PHP com HTML
Depuração	`var_dump()` para tipo + valor, `print_r()` para estruturas
Boas práticas	UTF-8, sem `?>` final, 4 espaços, nomes claros

Referências e leituras para aprofundar

PHP — Instalação e configuração oficial https://www.php.net/manual/pt_BR/install.php Documentação oficial cobrindo instalação em todos os sistemas operacionais, com detalhes sobre extensões e configuração do php.ini.
Homebrew — Gerenciador de pacotes para macOS https://brew.sh Indispensável para desenvolvedores em macOS. Facilita a instalação e atualização do PHP e de centenas de outras ferramentas.
XAMPP — Apache Friends https://www.apachefriends.org Ambiente de desenvolvimento completo para Windows, macOS e Linux. Inclui PHP, Apache, MySQL e phpMyAdmin.
VS Code — Download oficial https://code.visualstudio.com Editor gratuito da Microsoft. Após instalar, busque "PHP Intelephense" na aba de extensões.
PHP Intelephense — Extensão VS Code https://marketplace.visualstudio.com/items?itemName=bmewburn.vscode-intelephense-client A extensão PHP mais completa para VS Code. Autocomplete preciso, detecção de erros em tempo real, navegação de código e muito mais.
PSR-12: Extended Coding Style https://www.php-fig.org/psr/psr-12/ O padrão oficial de estilo de código da comunidade PHP. Cobre indentação, espaçamento, nomenclatura e muito mais. Vale uma leitura rápida já nesta semana.
PhpStorm — JetBrains https://www.jetbrains.com/phpstorm/ IDE profissional para PHP. Considere quando avançar para os módulos de frameworks e projetos maiores.

Configurando o Ambiente de Desenvolvimento

Instalando o PHP

O servidor embutido do PHP

Escolhendo o editor de código

Estrutura de um arquivo PHP

Seu primeiro programa

Exibindo HTML pelo PHP

Boas práticas desde o início

Resumo

you asked

Artigo 03 — Configurando o Ambiente de Desenvolvimento

Introdução

Instalando o PHP

O servidor embutido do PHP

Escolhendo o editor de código

Estrutura de um arquivo PHP

Seu primeiro programa

Misturando PHP com HTML

Depurando com var_dump e print_r

Boas práticas desde o início

Resumo

Referências e leituras para aprofundar

Newsletter exclusiva