Erro “magento: command not found” no Magento 2

O que fazer quando você tenta executar um comando no Magento 2 e se depara com -bash: magento: command not found.

Antes de prosseguir, uma observação para os iniciantes, você só irá conseguir executar os comandos do Magento 2 em uma loja já devidamente instalada.

Caso você queira realizar a instalação pela linha de comando, consulte este material: Instalando Magento pela linha de comando

Command not found, verifique a sintaxe

Erro “command not found” pode estar ocorrendo por um erro de sintaxe, verifique se você esta utilizando todos os elementos necessários, o diretório bin, “php”, “magento” e “comando”.

 php magento xxxxxx

Observe bem o “php” antes do comando “magento”.

Os comandos são executados dentro do diretório bin que está localizado na raiz da instalação.

Diretórios removidos

Alguns diretórios como bin, setup, são obrigatórios na instalação para que seja possível executar os comandos.

Se por algum motivo eles foram removidos, infelizmente neste caso você terá que fazer uma restauração dos arquivos da loja.

Caso você não tenha backup dos arquivos a reparação ficará bem mais difícil, tendo que ser feita manualmente, diretório por diretório.

Versão do PHP incompatível

A versão do PHP que está instalado no servidor é incompatível.

consulte todos os requisitos necessários para que o Magento 2 funcione corretamente acessando: Requisitos de sistema para rodar Magento 2

deploy:mode:set developer

Eu já enfrentei esse problema ao mudar o modo de deploy de uma instalação para “developer”.

Por algum erro interno, que pode ter ocorrido por uma configuração de permissão errada ou até mesmo no próprio PHP (ex: limite de memória) a loja saiu totalmente do ar. Removendo diretórios vitais para instalação e inutilizando os comandos.

Neste caso, junto com o cliente, tive que restaurar o Backup.

Ocorreu o mesmo problema ao limpar/esvaziar os arquivos estáticos.

Em todo o caso, é muito importante que você tenha em mãos backups rotineiros dos arquivos antes de executar qualquer comando.

Qualquer coisa que possa ocorrer durante um “deploy”, paralisando o processo.. irá gerar grandes problemas.