return env('AWS_URL');

env を直接参照していた箇所が、ある日突然値を返さなくなった。最初は env が読めていないとは思わず、別の箇所を疑ってしまって少し遠回りしてしまった。

調べてみると、config:cache を有効化した途端に env() が値を返さなくなるという Laravel の仕様があったらしいので、軽く調べてみた。

php artisan config:cache
これを「config の設定値を更新するときに打つコマンド」くらいにしか理解していなかったが、実際には以下の処理を行っている。

→ 以降は env() を一切見に行かず、config キャッシュだけを参照する。

そのため、キャッシュを有効化している環境だと env() は基本的に null を返す。

Laravel 的にはenvを直接読まないことが前提らしいなので、これはもうそういうものだと扱うしかないのだけど、じゃあ「警告くらい出してくれよ！」とはおもったり……

Laravel は通常、リクエストを受けるたびに

という処理を行う。これが意外と重いらしく

config:cache によってこれらをデプロイ時の 1回だけに置き換えることで

「巨大な配列をひとつ読み込むだけ」

という高速な形にしている。

env の値は環境によって変わるため、アプリ本体が直接読むと本番だけ挙動が変わる事故が起きやすい。

env() はキャッシュ前後で参照可否が変わるため、使用箇所が混在すると再現性の低いバグが起きる。

env は「入力値」、config は「アプリが読むべき確定した値」で、それぞれ役割が違う。

という分担になっている

php artisan config:clear

でキャッシュを削除できるコマンドがあるけど、実際には

php artisan config:cache

を再実行するだけでキャッシュは上書き更新されるし、最新の設定を反映させたいだけならほとんどこちらだけで十分。
開発中に「いったんキャッシュを完全に消したい」ときだけ config:clear を使うことが多い。