Quando instalas um projeto Laravel pela primeira vez, encontras uma série de pastas que podem parecer confusas, mas cada uma cumpre um papel específico dentro da filosofia do framework. Entender a estrutura de pastas em Laravel é o primeiro passo para desenvolver aplicações web sólidas, organizadas e fáceis de manter.

Este recurso ajuda quem começa em PHP moderno e quer dominar um ambiente de trabalho padronizado, com boas práticas já integradas.

O que define a filosofia de um framework como Laravel?

Um framework é um ambiente de trabalho padronizado que reúne convenções, pastas organizadas, boas práticas e estilos de programação para resolver problemas comuns do desenvolvimento web. Laravel não é apenas uma biblioteca: é uma estrutura pronta que te entrega decisões já tomadas para que tu te concentres na lógica do teu produto.

¿Qué es un framework en programación web? É um conjunto de ferramentas, convenções e código base que te dão uma estrutura inicial. No caso de Laravel, inclui rotas, vistas, base de dados e testes prontos para usar.

Como está organizada a estrutura de pastas em Laravel?

A arquitectura do Laravel distribui responsabilidades por pastas claras. Vou levar-te por elas na ordem em que aparecem no projeto.

Onde fica o código principal: app, bootstrap e config

A pasta app contém o código central da tua aplicação: modelos, controladores e a lógica de negócio. É aqui onde passarás a maior parte do tempo.

A pasta bootstrap raramente se modifica. Laravel usa-a para gerar automaticamente ficheiros que melhoram o desempenho do projeto, como cache de configuração e serviços.

A pasta config guarda um ficheiro por cada componente ou pacote instalado. Podes editá-los para afinar o comportamento do framework, e revê-los é uma excelente forma de aprender o que Laravel oferece por baixo do capô.

Como funciona a pasta database com migrations, factories e seeders?

A pasta database centraliza tudo o que tem a ver com a base de dados [01:00]. Dentro dela encontras três peças fundamentais:

• Migrations: ficheiros com a estrutura das tabelas que serão criadas na base de dados.
• Factories: definições que geram dados fictícios para testar a aplicação.
• Seeders: responsáveis por executar essas factories. Por exemplo, podes pedir que crie 10 utilizadores com dados falsos automaticamente.

Esta combinação permite-te recriar todo o estado da base de dados em segundos, algo essencial em equipas e em ambientes de teste.

Para que serve a pasta lang em projetos multilingues?

A pasta lang controla o sistema multilingue. Por predefinição vem em inglês, mas podes adicionar uma pasta es para espanhol, pt para português e assim por diante. É a porta de entrada para internacionalizar a tua aplicação sem reescrever vistas.

Onde colocar ficheiros públicos, recursos e rotas?

Laravel separa claramente o que o utilizador vê do que tu editas como programador. Esta divisão é uma das chaves da sua organização.

Qual é a diferença entre public e resources?

A pasta public é o ponto de acesso web do projeto. Contém o index.php que recebe todas as requisições, além de imagens finais, JavaScript e CSS já compilados. Quando dizemos compilados, referimo-nos a ficheiros já processados e prontos para o navegador.

A pasta resources guarda os ficheiros originais: CSS, JavaScript e vistas Blade que tu editas no dia a dia. É a tua zona de trabalho criativa.

¿Dónde van los archivos CSS y JS originales en Laravel? Vão para a pasta resources. Os ficheiros já compilados e prontos para produção ficam em public.

Como configurar rotas no ficheiro web.php?

A pasta routes define os endpoints do projeto: página inicial, sobre, contactos, produtos, formulários. Trabalharás principalmente em web.php, onde declaras cada rota e a associas a um controlador ou vista.

O que guardam storage, tests e vendor?

Estas três pastas suportam o funcionamento interno e a qualidade do projeto.

A pasta storage contém registos, modelos compilados, sessões baseadas em ficheiros e cache. Se a tua aplicação permite carregar ficheiros, podem ser guardados em app/public. As vistas compiladas, já prontas para o navegador, ficam em framework/views. Repara que ali aparecem em PHP puro, sem as diretivas Blade. Por exemplo, um @if transforma-se num if clássico de PHP.

A pasta tests alberga testes unitários com PHPUnit e testes de funcionalidades. Laravel foi construído precisamente para que tudo possa ser verificado de forma automatizada.

A pasta vendor contém tudo o que instalas através do Composer. Não tocas nela manualmente: é gerida pelo gestor de dependências.

Como executar um projeto Laravel no navegador?

Tens várias formas de levantar um servidor local. Em Mac, podes usar Laravel Herd, mencionado nos pacotes da documentação oficial. Mas se trabalhas noutro sistema, há duas alternativas universais.

A primeira é abrir o terminal, entrar na pasta public e executar:

bash php -S 127.0.0.1:8000

Depois abres o navegador em 127.0.0.1:8000 e o projeto carrega.

A segunda, mais idiomática em Laravel, usa Artisan, a ferramenta de linha de comandos do framework:

bash php artisan serve

Este comando cumpre a mesma função e deixa o servidor a correr enquanto desenvolves. Se o cancelas, deixas de visualizar o sistema.

¿Qué hace el comando php artisan serve? Levanta um servidor local de desenvolvimento na porta 8000 para que vejas o teu projeto Laravel no navegador sem configurar Apache ou Nginx.

Agora que conheces a estrutura, dá uma vista de olhos a cada pasta no teu próprio projeto e toma notas. Que pasta achas mais interessante para começar a explorar primeiro? Conta nos comentários.