Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Vibe Coding: Do Zero ao MVP

    O que é Artisan?

    O Artisan é a linha de comando do Laravel. Ele cria arquivos, executa migrations, inicia workers e roda comandos próprios da aplicação pelo terminal.

    Também chamado de: Laravel Artisan, php artisan

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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:

    Terminal
    php artisan make:model Fatura -m
    php artisan migrate
    php artisan route:list
    php artisan queue:work

    O 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>&1

    O 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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano