PHP Editores e IDEs

Um programa PHP é um arquivo de texto comum. Dá para escrevê-lo até no Bloco de Notas, mas um editor de código ajuda muito: pinta cada parte do código com uma cor, avisa do erro antes de você rodar, completa nomes de funções e arruma o alinhamento. Nesta aula você vai conhecer as opções mais usadas, configurar o VS Code para PHP e aprender os cuidados com o arquivo (codificação, fim de linha) que evitam erros misteriosos.

A ideia: caneta, caderno e estojo completo

Dá para escrever uma redação numa folha solta com qualquer caneta (o editor de texto simples, como o Bloco de Notas). Um caderno com pauta e margem ajuda a manter tudo alinhado (o editor de código). E um estojo completo, com régua, corretivo e marca-texto, faz quase tudo por você (a IDE, de Integrated Development Environment, "ambiente de desenvolvimento integrado").

Para quem está começando, um editor de código bem configurado é o ideal: é leve, gratuito e mostra o que importa. O guia usa o VS Code como exemplo, mas qualquer um serve.

VS Code + PHP Intelephense

O Visual Studio Code (ou VS Code) é um editor gratuito da Microsoft, para Windows, macOS e Linux, e o mais usado hoje. Sozinho, ele já pinta o código PHP e confere a sintaxe; com a extensão certa, ele passa a "entender" o PHP.

1. Instale o VS Code. Baixe em code.visualstudio.com. No Linux, há pacotes .deb e .rpm no mesmo site (e o Snap: sudo snap install code --classic).
2. Abra a pasta do projeto, não um arquivo solto: menu Arquivo → Abrir Pasta… e escolha a pasta site. Assim o editor enxerga todos os arquivos e o terminal já começa nessa pasta.
3. Instale a extensão PHP Intelephense. Clique no ícone de Extensões na barra lateral (ou Ctrl+Shift+X), pesquise intelephense e instale a PHP Intelephense, de Ben Mewburn (o identificador é bmewburn.vscode-intelephense-client).
4. Desative o suporte embutido, como a própria documentação da Intelephense recomenda, para não ter sugestões repetidas: em Extensões, pesquise @builtin php, abra PHP Language Features e clique em Desabilitar. (Deixe ligada a PHP Language Basics, que cuida das cores.)

O que a Intelephense faz

A versão gratuita faz tudo isso; uma licença paga ("Premium") acrescenta recursos como renomear em todo o projeto. Para o guia, a gratuita basta.

Configurando: a versão e o executável do PHP

As configurações do VS Code ficam num arquivo settings.json. Para abri-lo: Ctrl+Shift+P (a "paleta de comandos"), digite settings json e escolha Preferências: Abrir Configurações do Usuário (JSON). Acrescente, entre as chaves que já existem:

{
    "intelephense.environment.phpVersion": "8.5.0",
    "php.validate.executablePath": "/usr/bin/php",
    "[php]": {
        "editor.defaultFormatter": "bmewburn.vscode-intelephense-client",
        "editor.formatOnSave": true,
        "editor.tabSize": 4,
        "editor.insertSpaces": true
    },
    "files.encoding": "utf8",
    "files.eol": "\n"
}

intelephense.environment.phpVersion

Para qual versão do PHP você escreve. Com "8.5.0", a extensão aceita recursos novos como o |> e avisa quando você usa algo que não existe nessa versão. Se o seu servidor tem o 8.4, ponha "8.4.0".

php.validate.executablePath

Onde está o programa php. O VS Code usa esse PHP de verdade para conferir a sintaxe ao salvar. Descubra o caminho com which php (Linux e macOS) ou where.exe php (Windows). No Windows, as barras são dobradas: "C:\\php\\php.exe".

"[php]": { … }

Ajustes que valem só para arquivos PHP: usar a Intelephense para formatar, formatar ao salvar, recuo de 4 espaços.

files.encoding / files.eol

Salvar em UTF-8 e com o fim de linha do Linux (\n). Explicado em Os cuidados com o arquivo.

Para descobrir o caminho do PHP, pergunte ao terminal. No laboratório do guia:

$ which php
/opt/php/bin/php           « no laboratório; num Ubuntu com apt, /usr/bin/php

O terminal dentro do editor

O VS Code tem um terminal embutido: menu Terminal → Novo Terminal (ou Ctrl+'). Ele abre já na pasta do projeto. O fluxo de trabalho do guia fica assim: o código em cima, o terminal embaixo; você salva (Ctrl+S) e roda php ola.php. Para páginas web, abra um segundo terminal (o ícone + do painel), ligue o php -S localhost:8000 nele (aula O Servidor Embutido) e use o navegador.

Outras opções

PhpStorm

A IDE da JetBrains feita só para PHP, muito usada por profissionais. Entende o projeto inteiro sem configurar nada: refatoração segura, depurador integrado, testes, Composer, banco de dados, Git. É paga (assinatura), com período de teste e licença gratuita para estudantes e professores (programa educacional da JetBrains). Download em jetbrains.com/phpstorm.

Para configurar o PHP: Settings → PHP, escolha o PHP language level (8.5) e, em CLI Interpreter, clique em … e aponte para o executável do php. A formatação é Ctrl+Alt+L, já no padrão PSR-12 (o padrão de estilo da comunidade; veja Padrões PSR).

Sublime Text

Um editor rápido e leve, de sublimetext.com. Pode ser avaliado de graça por tempo indeterminado (de vez em quando aparece um lembrete para comprar). Para ter os recursos da Intelephense, instale o Package Control (menu Tools → Install Package Control) e, depois, os pacotes LSP e LSP-intelephense.

E os outros

Qual escolher?

Formatar o código

O PHP não liga para espaços e recuos: um programa todo numa linha só funciona igual. Mas pessoas leem código, e código bagunçado esconde erros. Formatar é arrumar espaços, recuos e quebras de linha num padrão. Compare:

<?php
$nota=7.5;
if($nota>=7){
echo "Aprovada\n";
    }else{echo "Recuperação\n";}

<?php
$nota = 7.5;
if ($nota >= 7) {
    echo "Aprovada\n";
} else {
    echo "Recuperação\n";
}

Os dois fazem a mesma coisa. No segundo, dá para ver de relance o que está dentro do if e o que está dentro do else, graças ao recuo de 4 espaços. Como formatar:

Experimente: o código abaixo está bagunçado, mas funciona. Rode, arrume os espaços e o recuo à mão (o editor do guia não formata sozinho) e rode de novo: a saída não muda.

<?php
$nota=7.5;
if($nota>=7){
echo "Aprovada\n";
    }else{echo "Recuperação\n";}

Os cuidados com o arquivo

Extensão .php

Salve sempre com a extensão .php. No Windows, ative a exibição de extensões no Explorador (menu Exibir → Mostrar → Extensões de nomes de arquivos), senão um ola.php.txt parece ola.php.

Codificação: UTF-8 sem BOM

O computador guarda letras como números, e a codificação é a tabela que diz qual número é qual letra. O padrão da web é o UTF-8, que tem todos os acentos. O VS Code mostra a codificação no canto inferior direito da janela (UTF-8); clicando ali, dá para trocar.

Alguns editores (principalmente no Windows) gravam no começo do arquivo três bytes invisíveis chamados BOM (Byte Order Mark, "marca de ordem dos bytes"). Para o PHP, esses bytes estão antes do <?php, ou seja, são HTML comum, e são enviados ao navegador logo de cara. Isso quebra tudo o que precisa acontecer antes da primeira saída, como mudar cabeçalhos, iniciar sessões e redirecionar. Veja um arquivo com BOM:

<?php
header("Content-Type: text/plain; charset=utf-8");
echo "Olá!\n";

$ file bom.php
bom.php: PHP script, Unicode text, UTF-8 (with BOM) text     « o comando file denuncia o BOM
$ curl -i localhost:8000/bom.php
HTTP/1.1 200 OK
Host: localhost:8000
Date: Sat, 17 Oct 2026 00:05:11 GMT
Connection: close
X-Powered-By: PHP/8.5.8
Content-type: text/html; charset=UTF-8                        « o header() não funcionou: continua text/html

<br />
<b>Warning</b>:  Cannot modify header information - headers already sent by (output started at /home/ana/bom/bom.php:1) in <b>/home/ana/bom/bom.php</b> on line <b>2</b><br />
Olá!

"Não é possível modificar a informação de cabeçalho: os cabeçalhos já foram enviados (a saída começou em bom.php:1)". A linha 1 parece começar com <?php, mas os três bytes invisíveis vieram antes (eles estão grudados no começo da linha do <br />, só que não aparecem). A aula header e Redirecionamento explica os cabeçalhos.

Como evitar: salve em "UTF-8" (no VS Code, é o padrão), e nunca em "UTF-8 com BOM". Para consertar um arquivo, no VS Code clique na codificação no canto inferior direito → Salvar com Codificação → UTF-8.

Fim de linha: LF ou CRLF

O Linux e o macOS terminam cada linha com um caractere (LF, o \n); o Windows, tradicionalmente, com dois (CRLF, \r\n). O PHP aceita os dois no código, mas scripts que rodam em servidores Linux (como os com #!/usr/bin/env php no começo, aula PHP na Linha de Comando) falham com CRLF. O VS Code mostra LF ou CRLF no canto inferior direito; prefira LF.

Conferindo a sintaxe sem rodar: php -l

O que o editor faz quando sublinha um erro é parecido com isto: o PHP tem uma opção -l (de lint, o nome que programadores dão a "procurar defeitos") que lê o arquivo e confere a sintaxe sem executar nada. É útil antes de enviar um arquivo para o servidor, ou num editor sem extensão de PHP.

$ php -l e.php
No syntax errors detected in e.php                 « "nenhum erro de sintaxe encontrado"
$ echo $?
0
$ php -l a.php

Parse error: syntax error, unexpected token "echo", expecting "," or ";" in a.php on line 3
Errors parsing a.php                               « "erros ao analisar a.php"
$ echo $?
255

O a.php tem um ; faltando no fim da linha 2. O PHP só percebe na linha 3, quando encontra o echo seguinte sem que a instrução anterior tivesse terminado: por isso a mensagem fala em "echo inesperado" e aponta a linha 3. É o mesmo erro que o editor sublinharia em vermelho. A aula Lendo Erros do PHP desmonta essa mensagem.

Quando dá errado

Referência: atalhos do VS Code

Para fechar, faça o trabalho de um editor: encontre os erros. Este programa tem dois erros de sintaxe, o tipo de coisa que a Intelephense sublinharia em vermelho. Rode, leia a mensagem (ela mostra um erro de cada vez), conserte e rode de novo até funcionar.

<?php
echo "Lista de compras:\n";
echo "- pão\n"
echo "- leite\n";
echo "- café\n;

<?php
echo "Lista de compras:\n";
echo "- pão\n";
echo "- leite\n";
echo "- café\n";

Exercícios

Resumo

• Editor de código (VS Code, Sublime, Zed, Vim) para começar; IDE (PhpStorm) para projetos grandes.
• VS Code: instale a PHP Intelephense, desabilite a PHP Language Features embutida e configure intelephense.environment.phpVersion = "8.5.0" e php.validate.executablePath (descubra com which php / where.exe php).
• Abra a pasta do projeto e use o terminal integrado para php arquivo.php e php -S.
• Formate com Shift+Alt+F ou ao salvar; recuo de 4 espaços (PSR-12).
• Salve em UTF-8 sem BOM e com fim de linha LF. O BOM causa "headers already sent … output started at …:1".
• php -l arquivo.php confere a sintaxe sem executar.
• Próximo passo: O Editor do Guia.