O comando key:generate
é usado para definir uma nova chave no seu arquivo .env
, que esta localizado na pasta inicial, ele seta o valor dentro de .env
em:
APP_KEY=<chave gerada>
Note que ao executar:
composer create-project --prefer-dist laravel/laravel <nome da pasta do projeto>
Ou se instalou o laravel-installer (composer global require laravel/installer
):
laravel new <nome da pasta do projeto>
Ele irá executar automaticamente o comando sem precisar fazer manualmente, somente será necessário o comando acaso deseje uma nova chave ou acaso tenha clonado um projeto que use laravel, mas que não é o proprio de fato.
O uso desta chave é como dito pelos próprios comentários do código oficial:
Essa chave é usada pelo serviço de criptografia
Illuminate
e deve ser definida como uma cadeia aleatória de 32 caracteres, caso contrário, essas cadeias criptografadas não serão seguras. Faça isso antes de implantar um aplicativo!
Ou seja é uma chave que é usada em geral para diversas funcionalidades que exigem criptografia dentro das "APIs" do Illuminate.
Um detalhe importante, conforme o colega @Bacco mencionou, a chave não deve ser alterada em um projeto que já tenha armazenado dados baseados nesta chave (algo feito com as APIs do Illuminate), se fizer isso vai invalidar todos dados, o que vai quebrar a aplicação
Se está começando a usar um projeto de baseado em Laravel, como October ou um sistema qualquer a chave só deve ser nova se o tal projeto não possuir dados em banco ou caches e realmente estiver começando do zero.