Aprender Laravel 13: tutorial completo para iniciantes

Esta série ensina Laravel construindo um blogue completo, do projeto vazio até à pesquisa e à paginação. Dirige-se a um iniciante que conhece PHP mas nunca usou um framework.

O que vais construir

Um blogue que se aguenta de pé: artigos arrumados por categoria e por etiqueta, um back-office para os escrever, uma página inicial que os lista, um motor de pesquisa, paginação e artigos semelhantes. O projeto completo tem cerca de 25 ficheiros e cabe numa base SQLite.

Cada capítulo parte de um estado de projeto preciso e acaba em qualquer coisa que funciona no browser. O código publicado é o que foi executado no ambiente descrito no início de cada capítulo.

O que é preciso saber antes de começar

• PHP ao nível das funções, dos arrays e das classes. Os espaços de nomes e o autoloading são explicados pelo caminho.
• HTML e CSS para ler os templates. O visual usa Tailwind CSS, fornecido com o Laravel, mas não é preciso conhecê-lo à partida.
• Um terminal. Todos os comandos do tutorial correm lá.

Não se pressupõe qualquer conhecimento de Composer, de Eloquent ou de Blade.

Versões

O Laravel 13 saiu a 17 de março de 2026 e exige PHP 8.3 no mínimo. Aceita PHP 8.3, 8.4 e 8.5. A série foi executada de novo em PHP 8.4.25.

O Laravel 12 já só recebe correções de segurança, até 24 de fevereiro de 2027. O Laravel 11 está em fim de vida desde 12 de março de 2026. Se começas um projeto hoje, escolhe o Laravel 13.

O código desta série também funciona em Laravel 12, com uma única exceção assinalada no seu lugar: o atributo Eloquent #[Fillable] do capítulo 6, próprio do Laravel 13. O atributo #[Scope], por sua vez, existe desde o Laravel 12.5.

O sumário

As bases

1. Configuração do projeto, instalar o Laravel 13, perceber a árvore de ficheiros e arrancar o servidor.
2. O routing, associar um endereço a código, dar nome às rotas, ler os parâmetros do URL.
3. A estrutura MVC, controladores, vistas Blade, herança de templates.
4. Painel de administração, instalar o Filament, e porque já não é o Voyager.

Base de dados, modelos, rotas, controladores e vistas

5. Criar uma página inicial, o template do site, o Vite e o Tailwind.
6. Criar modelos e configurar o painel de administração, migrações, relações Eloquent, resources do Filament.
7. Criar rotas, controladores e vistas, as páginas de categoria, de etiqueta e de artigo.

Pesquisa e paginação

8. Motor de pesquisa, um formulário, uma consulta, e o que o LIKE sabe ou não fazer.
9. Paginação e artigos semelhantes, dividir as listas e ligar os artigos entre si.

O que esta série não cobre

A autenticação dos visitantes, os comentários, as filas de espera, o envio de e-mails e o deployment não são tratados. O back-office protege o acesso com uma simples verificação do endereço de e-mail, o que chega para aprender mas não para um site em produção.

Para pôr um projeto Laravel online, vê o guia instalar o Laravel num servidor Debian. Os outros artigos sobre Laravel estão reunidos no hub Desenvolvimento web.