O Artisan é a linha de comando do Laravel. Ele inicia a aplicação pelo terminal e oferece comandos para criar arquivos, preparar o banco, executar tarefas e consultar o estado do projeto. O comando base é php artisan, seguido do nome da tarefa.
O Artisan não é um programa separado do framework. Ele carrega o mesmo container de serviços usado por uma requisição HTTP. Por isso um comando consegue ler o .env, falar com o banco e usar as classes da aplicação.
Os comandos do dia a dia
A lista completa aparece com php artisan list. Os comandos mais usados durante o desenvolvimento criam e preparam partes do projeto:
php artisan make:model Fatura -mphp artisan migratephp artisan route:listphp artisan queue:workO primeiro comando cria o model e a migration correspondente, e o segundo aplica as migrations pendentes no banco. O terceiro lista as rotas registradas, com método, URI e controller. O quarto inicia um worker que consome a fila.
O php artisan help migrate mostra as opções de um comando específico. A saída de cada comando costuma indicar o próximo passo, como a migration criada ou a tabela alterada. Em automação, as opções --no-interaction e --quiet evitam uma pergunta aberta esperando resposta.
Comandos próprios
Uma tarefa recorrente da aplicação pode virar um comando. O arquivo fica em app/Console/Commands/ e declara a assinatura e o método que executa o trabalho:
protected $signature = 'faturas:fechar {--dia= : Data de referência}';
public function handle(): int{ // executa o fechamento e devolve o código de saída return self::SUCCESS;}A assinatura define o nome, os argumentos e as opções. O retorno é um código de saída, que o cron e o pipeline usam para saber se a tarefa terminou bem. O comando pode ser chamado por outro comando ou por um job, sem exigir o terminal.
Agendamento com uma entrada de cron
O Laravel concentra o agendamento no código. O servidor precisa de uma única entrada de cron, executada a cada minuto:
* * * * * cd /caminho/do/projeto && php artisan schedule:run >> /dev/null 2>&1O schedule:run verifica quais tarefas estão previstas para aquele minuto e executa as correspondentes. A definição fica em routes/console.php ou em um método da aplicação, conforme a versão. Essa centralização evita dezenas de linhas de cron espalhadas e mantém o horário junto do código.
O comando do cron precisa rodar com o usuário dono dos arquivos e com o ambiente correto. Um schedule:run executado como outro usuário pode falhar ao gravar log ou ao ler o .env.
Artisan, fila e implantação
O worker da fila é iniciado pelo Artisan e precisa continuar em execução. Em produção, ele fica sob um supervisor de processos, que reinicia o worker quando o processo termina. O comando queue:restart sinaliza aos workers que eles devem encerrar depois do trabalho atual, útil quando o código muda.
Na implantação, os comandos de migration e de cache fazem parte da sequência. config:cache e route:cache gravam versões otimizadas da configuração e das rotas, e precisam ser refeitos quando esses arquivos mudam. A ordem e o momento de cada comando dependem do pipeline, como explica o guia de entrega contínua.
Dúvidas frequentes
Perguntas frequentes sobre Artisan
- O Artisan só serve para criar arquivos?
- Não. Ele executa migrations, inicia o worker da fila, lista rotas, roda testes, limpa caches e agenda tarefas. Os comandos de criação são apenas uma parte da lista.
- Posso rodar o Artisan em produção?
- Sim, para tarefas de implantação e manutenção, como migration e limpeza de cache. O comando precisa usar o usuário e o ambiente corretos, e a execução deve ser registrada para que outro usuário consiga repetir.
- Qual é a diferença entre o Artisan e o cron?
- O cron do sistema inicia o comando no horário definido. O Artisan executa a tarefa dentro da aplicação, com acesso ao container, ao banco e às classes do Laravel. O agendador do Laravel usa uma entrada de cron para chamar o schedule:run.
Para continuar
Recursos relacionados
Documentação
Laravel: console Artisan
Lista os comandos disponíveis, explica a criação de comandos próprios e mostra as opções de entrada e saída.
Abrir recursoDocumentação
Laravel: agendamento de tarefas
Detalha a única entrada de cron que chama o schedule:run e a definição dos horários no código da aplicação.
Abrir recursoSite de referência
Promovaweb: o que é o Laravel
Mostra o Artisan no ciclo do framework, ao lado de rotas, controllers, Eloquent e Blade.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Durante o desenvolvimento de uma aplicação Laravel, você usa o Artisan para criar o model, rodar a migration e conferir as rotas antes de abrir a tela.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.