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.
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
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— geraAPP_KEYno 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 publicse necessário.
Boas práticas iniciais
- Nunca comite o arquivo
.envno git. - Use
.env.examplecomo 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
| Comando | O que faz |
|---|---|
php artisan list | Lista todos os comandos Artisan disponíveis. |
php artisan help <comando> | Mostra a ajuda detalhada do comando. |
php artisan --version | Mostra versão do framework. |
php artisan about | Mostra informações básicas sobre o ambiente Laravel (versões, paths). |
php artisan serve | Sobe servidor local de desenvolvimento. |
php artisan tinker | Console REPL para testar código PHP/Laravel. |
php artisan vendor:publish | Publica assets/config/views de pacotes instalados. |
php artisan storage:link | Cria 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 migrate | Executa as migrations pendentes. |
php artisan migrate:status | Verifica quais migrations foram aplicadas. |
php artisan migrate:rollback | Desfaz última "batch" de migrations. |
php artisan migrate:rollback --step=2 | Desfaz as últimas 2 batches. |
php artisan migrate:reset | Desfaz todas as migrations (volta ao estado inicial). |
php artisan migrate:refresh | Rollback + reaplica todas migrations (útil para testes locais). |
php artisan migrate:fresh | Drop todas tabelas e roda migrations (apaga dados). |
php artisan migrate:install | Instala a tabela de controle de migrations (se necessário). |
Cache, Config e Otimização
| Comando | Uso/Por que |
|---|---|
php artisan cache:clear | Limpa cache da aplicação. |
php artisan config:clear | Limpa cache das configurações (útil após mudar .env). |
php artisan config:cache | Cria cache das configs para melhorar performance em produção. |
php artisan route:cache | Cria cache de rotas; muito recomendado para produção (rotas fechadas). |
php artisan route:clear | Limpa cache de rotas. |
php artisan view:clear | Limpa cache de views compiladas. |
php artisan view:cache | Compila views Blade em cache (para produção). |
php artisan optimize | Otimiza autoload, config e cache (use com cuidado; ver docs). :contentReference[oaicite:1]{index=1} |
php artisan optimize:clear | Limpa todos os caches de otimização. |
Queues / Jobs
| Comando | Quando usar |
|---|---|
php artisan queue:work | Inicia worker que processa jobs (em background). |
php artisan queue:listen | Escuta fila e processa jobs (modo menos performático que work). |
php artisan queue:restart | Faz com que workers reiniciem (útil ao fazer deploy). |
php artisan queue:failed | Lista jobs que falharam. |
php artisan queue:failed-table | Gera migration para tabela de failures. |
php artisan queue:retry <id> | Tenta reexecutar job que falhou. |
php artisan queue:flush | Remove todos os failed jobs. |
Eventos, Listeners, Mail, Notifications
| Comando | O que gera |
|---|---|
php artisan make:event NomeEvento | Cria evento. |
php artisan make:listener NomeListener | Cria listener (pode ser ligado a um evento). |
php artisan event:list | Lista eventos e listeners registrados. |
php artisan event:generate | Gera listeners "stub" para eventos existentes. |
php artisan make:mail NomeMail | Cria classe Mailable para envio de e-mails. |
php artisan make:notification NomeNotification | Cria 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 comkernel/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.
--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
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
- Crie Job:
php artisan make:job ProcessOrder - Dispare job:
ProcessOrder::dispatch($order) - 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
Eventos, Listeners & Testes
Eventos / Listeners
php artisan make:event UserRegisteredphp artisan make:listener SendWelcomeEmail --event=UserRegisteredphp 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)
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:cachephp artisan route:cachephp artisan view:cachephp artisan optimizeephp artisan optimize:clear
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 projetophp artisan filament:installphp artisan filament:install --panelsphp artisan make:filament-user— cria admin pelo CLIphp artisan make:filament-resource Produto— gera CRUD no painel
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
- Configurar variáveis de ambiente (DB, MAIL, APP_ENV=production, APP_DEBUG=false).
- Executar migrations e seeders controladamente (
php artisan migrate --force). - Gerar caches:
php artisan config:cache,php artisan route:cache,php artisan view:cache. - Rodar
composer install --no-dev --optimize-autoloader. - 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
--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}