PHP Trail
Site oficial do PHP Trail

PHP Tutorial: projetos criados e executados na sua pasta

O PHP Trail 2.9.30 é um agente para Windows que escreve pequenos arquivos PHP na sua própria pasta, executa cada um e mostra o resultado, para você praticar construindo projetos de verdade.

Sistema

Windows 10/11

Roda em PCs x64

Versão

2.9.30

Lançada em 8 de novembro de 2026

Instalador

Cerca de 34 MB

O programa de instalação

Portátil

Cerca de 25 MB

Um único arquivo .exe

Interface

13 idiomas

Dentro do app

Conta

Não precisa

Para usar o app

Aprenda construindo

Um PHP tutorial que você constrói na sua própria pasta

Um PHP tutorial aqui é um projeto pequeno que você constrói, não uma aula a que você assiste. Você descreve a tarefa, o PHP Trail escreve o arquivo na sua pasta, executa seu comando PHP e mostra a saída ou a mensagem de erro reais, e você decide se aceita cada mudança. Os projetos são pequenos. Um primeiro script, como uma tabuada, precisa de cerca de 10 linhas.

01

Crie uma tabuada a partir de uma pasta vazia

Abra uma pasta vazia, escolha Ask first e peça a tabuada do 5 em um arquivo chamado table.php. O PHP Trail olha a pasta com list_dir e então write_file salva o novo script: um laço curto que imprime um produto por linha. Shell executa php -l table.php para verificar a sintaxe e php table.php para mostrar o resultado. A saída é real. O Ask first faz uma pausa antes de o arquivo ser salvo, então você lê e aceita ou rejeita. Se quiser outra tabuada, troque o número no seu prompt e execute de novo.

Registro das ferramentas
list_dir  .  → empty
write_file  table.php  → saved
Shell  php -l table.php  → exit 0
Shell  php table.php  → exit 0
02

Ache um erro de sintaxe pela mensagem real

Imagine que o guestbook.php para com um parse error e você não entende por quê. Shell executa php -l guestbook.php e devolve a mensagem de erro real com o número da linha, e então read_file abre aquele trecho do arquivo. Um ponto e vírgula esquecido é uma causa comum. A mensagem aponta 1 linha. O edit_file propõe a correção como um diff e, no modo Ask first, você lê a mudança e aceita antes de ela ser aplicada. Depois Shell roda a verificação de sintaxe de novo, e um código de saída bem-sucedido significa que o PHP não achou nenhum problema de sintaxe. Isso não prova que o livro de visitas funciona direito, então você ainda executa e testa por conta própria.

Registro das ferramentas
Shell  php -l guestbook.php  → exit 255
read_file  guestbook.php  → read
edit_file  guestbook.php  → +1 -1
Shell  php -l guestbook.php  → exit 0
03

Pratique classes com uma classe Product

Para praticar programação orientada a objetos, comece no Plan only e peça uma classe Product com nome privado, preço privado, um construtor e um método que devolva um rótulo. O agente explica o construtor e as palavras public e private e depois escreve um plano, sem executar nada. Ainda não há nada salvo. Mude para Ask first para executar o plano: write_file salva Product.php com algumas linhas no final que criam 3 produtos com new, e Shell executa php Product.php para que cada rótulo apareça. Leia cada diff antes de aceitar.

04

Leia um arquivo CSV em um array

Coloque um scores.csv pequeno na pasta e peça ao PHP Trail para somar uma coluna. read_file lê o CSV para o agente ver as colunas, e então write_file salva read_csv.php, que carrega cada linha com str_getcsv e soma os números com array_sum. Shell executa o script. Ele imprime o total e, se o número parecer errado, grep encontra a linha que lê a coluna e edit_file mostra a correção como um diff. Arrays, laços e 2 funções nativas são o básico do PHP em ação. Abra o scores.csv você mesmo para confirmar o total, porque o agente pode ler uma coluna errada.

Abrir o guia passo a passo

Como ele se diferencia de um assistente de chat comum

Assistentes de chat respondem em texto. O PHP Trail versão 2.9.30 vai além: ele cria os arquivos, executa seu comando PHP e mostra o resultado de cada passo em um cartão que você pode abrir.

Assistente de chat comumPHP Trail
ArquivosMostra código que você mesmo copia e colaSalva arquivos na sua pasta; no Ask first, só depois de você aceitar
ExecuçãoEm geral descreve como a saída deveria serExecuta seu comando PHP e mostra a saída real
ErrosExplica um erro a partir do trecho que você colaMostra a mensagem e a linha reais do php -l
RevisãoVocê compara o código antigo e o novo a olhoO Ask first mostra cada edição como um diff para aceitar

Como funciona em quatro passos

  1. Instale o PHP Trail no Windows 10 ou 11 e conecte um modelo na nuvem, um modelo local ou o modelo integrado.
  2. Escolha uma pasta vazia para o seu projeto de prática e defina o modo de aprovação como Ask first.
  3. Descreva uma tarefa pequena, como uma tabuada, e veja aparecer um cartão para cada ferramenta com o resultado real.
  4. Abra um cartão, leia a saída ou o diff e então aceite ou rejeite o passo.

Quem usa e quando

Iniciantes que já leram um tutorial de PHP para iniciantes, mas travam diante de um arquivo vazio, são o primeiro grupo. Uma forma de sair do ciclo de tutoriais é construir algo pequeno, executar e ler o resultado real. Mantenha o script curto. Cerca de 10 linhas bastam para a primeira tentativa, e a pasta onde ele fica continua sendo sua.

Autodidatas que já conhecem outra linguagem e querem migrar para o PHP são o segundo grupo. As recomendações para aprender PHP costumam apontar para o manual, e o PHP Trail pode ler esse manual com web_search e http_get enquanto escreve seus exemplos. Compare com o manual.

Profissionais que voltam ao PHP depois de uma pausa são o terceiro grupo. Depois de um tempo parado, retomar o PHP fica mais fácil quando um recurso fica aberto ao lado do seu trabalho, e o agente deixa o manual a poucas chamadas de ferramenta enquanto você refaz um hábito como escapar a saída. Revise cada diff. O modo de aprovação que você escolhe define a frequência com que ele para para perguntar.

Perguntas sobre o PHP Trail e a prática de PHP

O que é um PHP tutorial neste site?

É um projeto de prática que você constrói na sua própria pasta com um agente de IA que escreve, executa e explica pequenos arquivos PHP. O PHP Trail não é um curso, um quiz nem uma videoaula, e cada passo aparece como um cartão com o resultado real. Você revisa cada cartão.

O phptutorials.net é o site oficial do PHP Trail?

Sim, o phptutorials.net é o site oficial do PHP Trail. Baixe a versão original aqui, compare o checksum SHA-256 com o manifesto publicado e use o botão Send feedback dentro do app se algo parecer errado. Confira o hash primeiro.

PHP é uma boa primeira linguagem?

Sim, para muitos iniciantes é uma primeira linguagem razoável, porque um arquivo PHP é texto simples que você executa com um único comando e cujo resultado lê na hora. Ela é conhecida principalmente pelo trabalho web no lado do servidor. O básico vem primeiro. O SQL vem depois.

O PHP Trail é um curso, um quiz ou uma videoaula?

Não. O PHP Trail é um agente de IA para Windows que trabalha na sua própria pasta de projeto, então não há quizzes com nota, vídeos nem certificados para concluir. Ele escreve e executa arquivos com você e mostra cada resultado. Nada é avaliado.

Preciso instalar o PHP antes?

Sim. O PHP Trail executa seu comando PHP, então o PHP precisa estar instalado no seu PC; baixe-o no site do PHP e confira rodando php -v em um terminal. Se o php -v mostrar uma versão, seu comando PHP está pronto. Rode php -v primeiro.

O que significam Auto-run, Ask first e Plan only?

São os três modos de aprovação. O Auto-run deixa as ações rodarem na hora, o Ask first faz uma pausa antes de uma ação que muda algo e mostra as edições como um diff, e o Plan only escreve um plano e não executa nada até você trocar de modo. Para praticar, escolha o Ask first.

Meu código sai do meu PC?

Sim, se você escolher um modelo na nuvem: o texto do prompt, incluindo o texto de qualquer arquivo que o agente leia, vai para esse provedor. Com um modelo local, nada sai do PC. O app guarda chats, pastas de trabalho e chaves de API no seu PC. Decida antes de colar segredos.

Comece aqui

Crie seu primeiro script hoje

Instale o PHP Trail no Windows 10 ou 11 e transforme suas próximas aulas de PHP em pequenos arquivos que você executa, lê e altera por conta própria. A instalação tem cerca de 34 MB. Não precisa de conta.

Baixar o PHP Trail para Windows ↗

Para onde ir agora

Todas as páginas estão disponíveis em 20 idiomas.

O que o PHP Trail faz em projetos de prática ↗ Conecte um modelo na nuvem, local ou integrado ↗ Um exemplo completo com uma classe pequena ↗ Baixe e verifique a versão para Windows ↗ Respostas para as dúvidas mais comuns ↗ O que este site e o app guardam ↗