Laravel Profissional
Ultima Versão: 14/09/25

Manual Profissional: Comandos Laravel — do início ao fim

Este documento organiza e explica, de forma profissional, todos os comandos relevantes do Laravel (Artisan, Composer, migrations, fila, testes, deploy, pacotes e mais). Mantive exatamente a sua lista original e adicionei dezenas de comandos complementares, exemplos de uso e um roteiro prático de carreira.

Completo Preserva sua lista original + amplia com melhores práticas e comandos avançados

Sua lista original (mantida sem alterações)

Abaixo está a sua lista de comandos tal como você enviou — nada foi removido, apenas complementado em seções posteriores.

composer create-project laravel/laravel:^10.0 ./ (PARA INSTALAR A VERSAO 10 DO LARAVEL)
composer create-project laravel/laravel exemplo  (CRIA UM PROJETO COM A ULTIMA VERSAO DO LARAVEL)
php artisan --version 					(MOSTRA A VERSAO DO FRAMEWORK DO LARAVEL)


php artisankey:generate     (GERA A CHAVE NO ARQUIVO .env APP_KEY=base64dfnsifniusdrs....)

php artisan make:controller ProdutoControllers --resource (CRIA UM ARQUIVO COM AS ROTA PRONTAS PARA CRIAR EDITAR DELETAR TABELAAS app/http/controller)
php artisan make:model Categoria --migration --controller --resource    (CRIA TODOS OS ARQUIVOS JA PARA MANIPULAR controller migrations models)

php artisan make:migration create_produtos_table  (CRIA UMA TABELA EM database/migrations)
php artisan make:migration alterar_nome_tabela_produtos (CRIE ESTA TABELA PARA MUDAR O NOME DE OUTRA TABELA DENTRO DO SEU CODIGO)
	
php artisan migrate:reset   (RESETA TODAS AS MIGRAÇOES)
php artisan migrate:refresh (RESETA E REINICIA OS MIGRATION DENTRO DO BANCO DE DADOS)
php artisan migrate:fresh       (DELETA TODO O BANCO DE DADOS E REINSTALA AS MIGRAÇOES)

php artisan migrate  		(EXECUTA O BANCO DE DADOS COM OS PRODUTOS)
php artisan migrate:rollback	(DEFAZER A ULTIMA MIGRAÇAO)
php artisan migrate:status      (STATUS DO BANCO SE FOI EXECUTADO OU NAO)
composer upgrade     (ATUALIZA O COMPOSER)

composer require doctrine/dbal  (PACOTE PARA MODIFICAR AS TABELAS E COLUNAS EXCLUIR COLUNAS)

php artisan make:seeder UsersSeeder
php artisan db:seed --class=UsersSeeder

php artisan make:factory CategoriaFactory
php artisan db:seed


composer require laravellegends/pt-br-validator

composer global require "filament/filament:^3.0" --with-all-dependencies  (globalmente no seu sistema não recomendado)
composer require filament/filament:"^2.0"  (BAIXA O FILAMENT PARA O PROJETO confira a versao)
php artisan filament:install               (INSTALA O FILAMENT NO PROJETO)
php artisan filament:install --panels     (CRIA UMA ROTA PARA O ADM)
php artisan make:filament-user             (CRIA UM ADMIN DO FILAMENT NO TERMINAL BASTA DIGITAR O NOME EMAIL E SENHA)
php artisan make:filament-resource Produto  (Isso vai gerar as telas de listagem, formulário e edição automaticamente, já puxando os dados do MySQL)

composer require laravel/breeze --dev      (BAIXA O BREEZE PARA O PROJETO)-cria rotas como /login /registro /dashboard /profile
php artisan breeze:install blade	   (INSTALA O BREEZE NO PROJETO)
php artisan migrate			   (ATUALIZE O BANCO DE DADOS)

composer require darryIdecode/cart
Sua lista original está preservada acima. A próxima seção amplia e organiza tudo com explicações e comandos adicionais.

Instalação & Setup inicial

Passo a passo para começar um projeto Laravel (localmente e com boas práticas).

Criação do projeto

  • composer create-project laravel/laravel:^10.0 ./ — instala a versão 10 num diretório atual.
  • composer create-project laravel/laravel exemplo — cria projeto com a última versão estável.
  • composer install — após clonar um repositório, instala dependências.

Chaves e ambiente

  • php artisan key:generate — gera APP_KEY no arquivo .env.
  • Edite .env (DB_CONNECTION, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MAIL_*, etc.).

Executando localmente

  • php artisan serve — sobe servidor local (http://127.0.0.1:8000).
  • Use php -S 127.0.0.1:8000 -t public se necessário.

Boas práticas iniciais

  • Nunca comite o arquivo .env no git.
  • Use .env.example como referência de variáveis.
  • Versione migrations e seeders no repositório.

Comandos Artisan — coleção completa e explicada

Abaixo agrupei comandos por categoria (geral, make, migrate, cache, queue, eventos, etc). Use php artisan list para ver tudo no seu projeto. Fonte: documentação Laravel e cheatsheets. :contentReference[oaicite:0]{index=0}

Comandos gerais

ComandoO que faz
php artisan listLista todos os comandos Artisan disponíveis.
php artisan help <comando>Mostra a ajuda detalhada do comando.
php artisan --versionMostra versão do framework.
php artisan aboutMostra informações básicas sobre o ambiente Laravel (versões, paths).
php artisan serveSobe servidor local de desenvolvimento.
php artisan tinkerConsole REPL para testar código PHP/Laravel.
php artisan vendor:publishPublica assets/config/views de pacotes instalados.
php artisan storage:linkCria link simbólico public/storage apontando para storage/app/public.

Migrations & Banco de Dados

ComandoÚtil quando...
php artisan make:migration <nome>Criar migration (ex: create_produtos_table).
php artisan migrateExecuta as migrations pendentes.
php artisan migrate:statusVerifica quais migrations foram aplicadas.
php artisan migrate:rollbackDesfaz última "batch" de migrations.
php artisan migrate:rollback --step=2Desfaz as últimas 2 batches.
php artisan migrate:resetDesfaz todas as migrations (volta ao estado inicial).
php artisan migrate:refreshRollback + reaplica todas migrations (útil para testes locais).
php artisan migrate:freshDrop todas tabelas e roda migrations (apaga dados).
php artisan migrate:installInstala a tabela de controle de migrations (se necessário).

Cache, Config e Otimização

ComandoUso/Por que
php artisan cache:clearLimpa cache da aplicação.
php artisan config:clearLimpa cache das configurações (útil após mudar .env).
php artisan config:cacheCria cache das configs para melhorar performance em produção.
php artisan route:cacheCria cache de rotas; muito recomendado para produção (rotas fechadas).
php artisan route:clearLimpa cache de rotas.
php artisan view:clearLimpa cache de views compiladas.
php artisan view:cacheCompila views Blade em cache (para produção).
php artisan optimizeOtimiza autoload, config e cache (use com cuidado; ver docs). :contentReference[oaicite:1]{index=1}
php artisan optimize:clearLimpa todos os caches de otimização.

Queues / Jobs

ComandoQuando usar
php artisan queue:workInicia worker que processa jobs (em background).
php artisan queue:listenEscuta fila e processa jobs (modo menos performático que work).
php artisan queue:restartFaz com que workers reiniciem (útil ao fazer deploy).
php artisan queue:failedLista jobs que falharam.
php artisan queue:failed-tableGera migration para tabela de failures.
php artisan queue:retry <id>Tenta reexecutar job que falhou.
php artisan queue:flushRemove todos os failed jobs.

Eventos, Listeners, Mail, Notifications

ComandoO que gera
php artisan make:event NomeEventoCria evento.
php artisan make:listener NomeListenerCria listener (pode ser ligado a um evento).
php artisan event:listLista eventos e listeners registrados.
php artisan event:generateGera listeners "stub" para eventos existentes.
php artisan make:mail NomeMailCria classe Mailable para envio de e-mails.
php artisan make:notification NomeNotificationCria notificação (mail, database, broadcast etc.).

Outros úteis

  • php artisan route:list — mostra todas as rotas (muito útil para debugging).
  • php artisan storage:link — cria link para uploads públicos.
  • php artisan migrate:status — mostra status de cada migration.
  • php artisan schedule:run / schedule:list — para trabalhar com kernel/schedule.

Make Commands — criar arquivos automaticamente

A lista make: gera artefatos padrão com esqueleto pronto. Útil para acelerar o desenvolvimento. (Exemplos e opções abaixo.) :contentReference[oaicite:2]{index=2}

Principais make:*

  • php artisan make:controller NomeController --resource — controller com métodos index/create/store/show/edit/update/destroy.
  • php artisan make:model NomeModel --migration — cria model + migration.
  • php artisan make:migration create_table_x — cria arquivo de migration.
  • php artisan make:seeder NomeSeeder — cria seeder para popular dados.
  • php artisan make:factory NomeFactory — cria factory para dados de teste.

Make avançado

  • php artisan make:job NomeJob — cria classe Job para execução assíncrona.
  • php artisan make:listener NomeListener — cria listener para eventos.
  • php artisan make:policy NomePolicy — cria policy (autorização).
  • php artisan make:middleware NomeMiddleware — cria middleware customizado.
  • php artisan make:test NomeTeste — cria teste unitário/feature.
Dica: Use o flag --resource para controllers quando for criar CRUDs — economiza muito tempo.

Migrations — versionamento do banco

Migrations permitem versionar a estrutura do banco (criar, alterar e reverter). Sempre escreva migrations para alterações de schema em vez de rodar queries manuais em produção.

Exemplos úteis

# criar tabela produtos
php artisan make:migration create_produtos_table --create=produtos

# adicionar coluna em tabela existente
php artisan make:migration add_price_to_produtos_table --table=produtos

# renomear tabela
php artisan make:migration rename_produtos_to_items --table=produtos

Comandos de manutenção

  • php artisan migrate — aplicar migrations.
  • php artisan migrate:rollback — desfazer última batch.
  • php artisan migrate:fresh --seed — recriar banco e rodar seeders (útil em testes locais).

Seeders & Factories

Seeders e factories ajudam a popular o banco com dados de teste e fixtures.

php artisan make:seeder UsersSeeder
php artisan make:factory UserFactory
php artisan db:seed --class=UsersSeeder
php artisan db:seed            # roda todos os seeders registrados
Recomendação: coloque os seeders mínimos necessários para desenvolvimento e use fixtures ou factories para testes automatizados.

Filas (Queues) & Jobs

Use filas para processar tarefas longas (envio de e-mails, integração com APIs, processamento de imagens). Laravel suporta diversos drivers (database, redis, sqs, etc.). :contentReference[oaicite:3]{index=3}

Fluxo básico

  1. Crie Job: php artisan make:job ProcessOrder
  2. Dispare job: ProcessOrder::dispatch($order)
  3. Worker em produção: php artisan queue:work --daemon (prefira supervisor/systemd para manter em execução)

Comandos úteis

php artisan queue:work
php artisan queue:listen
php artisan queue:restart
php artisan queue:failed
php artisan queue:retry <id>
php artisan queue:failed-table
Em produção, utilize Redis ou SQS para performance — o driver database é ok para desenvolvimento e projetos pequenos.

Eventos, Listeners & Testes

Eventos / Listeners

  • php artisan make:event UserRegistered
  • php artisan make:listener SendWelcomeEmail --event=UserRegistered
  • php artisan event:list — ver eventos registrados

Testes

  • php artisan make:test UserTest — cria teste (Feature ou Unit flags)
  • php artisan test — executa toda a suíte de testes (PHPUnit)
Escreva testes para regras críticas: processos de pagamento, autorização e integrações externas.

Cache & Otimização

Comandos de cache são essenciais antes do deploy em produção (rotas, views, config). Use com atenção — não rode config:cache durante desenvolvimento sem atualizar o .env corretamente.

  • php artisan config:cache
  • php artisan route:cache
  • php artisan view:cache
  • php artisan optimize e php artisan optimize:clear
Cache de rotas só é válido para rotas que usam closures? Se você usa Closures em rotas, route:cache pode falhar. Prefira controllers para rotas em produção.

Filament — painel administrativo

Comandos básicos para instalar e criar recursos com Filament (painel admin). Considere instalar por projeto, não globalmente.

  • composer require filament/filament:"^2.0" — instalar por projeto
  • php artisan filament:install
  • php artisan filament:install --panels
  • php artisan make:filament-user — cria admin pelo CLI
  • php artisan make:filament-resource Produto — gera CRUD no painel
Evite composer global require filament/filament — prefira por projeto para controles de versão.

Breeze — autenticação leve

Breeze é simples e rápido para começar com autenticação (login/register/forgot-password/profile).

composer require laravel/breeze --dev
php artisan breeze:install blade
php artisan migrate

Deploy & Produção

Checklist e comandos para subir em produção com boa performance e segurança.

Checklist antes do deploy

  1. Configurar variáveis de ambiente (DB, MAIL, APP_ENV=production, APP_DEBUG=false).
  2. Executar migrations e seeders controladamente (php artisan migrate --force).
  3. Gerar caches: php artisan config:cache, php artisan route:cache, php artisan view:cache.
  4. Rodar composer install --no-dev --optimize-autoloader.
  5. Configurar supervisor/systemd para workers de queue, e cron para schedule:run.

Comandos úteis

php artisan down               # modo manutenção
php artisan up                 # sai do modo manutenção
php artisan migrate --force    # força migração em produção
composer install --no-dev --optimize-autoloader
Use --force com cuidado e somente em servidores controlados (CI/CD ou quando tiver backups e janela de manutenção).

Roteiro de Carreira / Projeto — do Zero ao Produto

Um roteiro prático que você pode seguir para transformar aprendizado em projeto/produto real.

Fase 1 — Fundamentos (1–2 semanas)

  • Ler docs básicos: routes, controllers, blade, Eloquent.
  • Comandos principais: php artisan make:model, make:controller, make:migration, migrate.
  • Prática: montar CRUD simples (produtos/categorias).

Fase 2 — Recursos e Estrutura (2–4 semanas)

  • Adicionar autenticação (Breeze), painel (Filament), teste básico.
  • Aprender filas (jobs), eventos, listeners.
  • Versionar ambiente: migrations + seeders + factories.

Fase 3 — Produção e Escala (4–8 semanas)

  • Configurar deploy (CI/CD), caching, otimização, supervisord para queues.
  • Métricas: logs, tratamento de exceptions, alertas.
  • Performance: usar Redis, cache de rotas/views, monitoramento.

Exemplo de fluxo de desenvolvimento (comandos)

# iniciar projeto
composer create-project laravel/laravel exemplo

# criar recursos
php artisan make:model Produto -m
php artisan make:controller ProdutoController --resource

# migration, seeder e popular
php artisan migrate
php artisan make:seeder ProdutoSeeder
php artisan db:seed --class=ProdutoSeeder

# autenticação
composer require laravel/breeze --dev
php artisan breeze:install blade
php artisan migrate

# deploy (em servidor)
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache

Referências & Leituras recomendadas

Principais fontes consultadas para montar este manual (documentação oficial e cheatsheets):

  • Documentação oficial do Artisan — Laravel Docs. :contentReference[oaicite:4]{index=4}
  • Cheatsheet / Artisan page (coleção prática de comandos). :contentReference[oaicite:5]{index=5}
  • Gist / lista de make: comandos (exemplos e flags). :contentReference[oaicite:6]{index=6}
  • Queues — documentação (modelos e drivers). :contentReference[oaicite:7]{index=7}
  • Deploy & práticas (Deployer / artigos sobre otimização). :contentReference[oaicite:8]{index=8}
Observação — as referências servem para confirmar opções, flags e comportamento especificado na versão do Laravel que você estiver usando.