# Laravel メンテナンスモード
アプリケーションをアップグレードしたり、データベースの構造変更など、一時的にアプリケーションを利用できないようにするため、Laravel のメンテナンスモード Artisan down コマンド使ってメンテナンスモードに簡単切り替えできます。メンテナンスモードの時、ステータスコード 503 でSymfony\Component\HttpKernel\Exception\HttpExceptionインスタンスを投げます。
# メンテナンスモード
php artisan down
# メンテナンスモード解除
php artisan up
# シークレットトークンでメンテナンスモードをバイパス
secret オプションを使い、メンテナンスモードパイパストークンを指定
php artisan down --secret="12345abc"
トークンと同じ URL によりブラウザでアプリケーションにアクセスすると、メンテナンスモードバイパスクッキーがそのブラウザへ発行されます。
http://localhost/12345abc
自動で secret トークン発行 php artisan down --with-secret
php artisan down --with-secret
# INFO Application is now in maintenance mode.
#
# INFO You may bypass maintenance mode via [http://localhost/krRY1mMuMize34rT].
メンテナンスモードバイパスクッキー
メンテナンスモードバイパスクッキーが一度発行されると、その後の通信はメンテナンスモードでない状態と同様になります。
# リダイレクト付きのメンテナンス
redirect オプションを使ってメンテナンス中に指定のパスにリダイレクトすることができます。
php artisan down --redirect=/
# メンテナンスモードをカスタマイズ
resources/views/errors/503.blade.php をカスタマイズで、メンテナンスモードの 503 ページをカスタマイズできます。
# Artisan の情報表示コマンド
php artisan about
--only オプションを使用してそのセクションをフィルタリング
php artisan about --only=environment コマンドで情報確認
Environment .....................
Application Name ..... ローカル環境
Laravel Version ......... 10.48.4
PHP Version .............. 8.2.10
Composer Version .......... 2.6.4
Environment ............... local
Debug Mode .............. ENABLED
URL ................... localhost
Maintenance Mode ............ OFF
設定ファイルの情報を詳しく表示する際に便利なコマンド
Database の設定を表示
php artisan config:show database
database .......................................
default .................................. mysql
connections ⇁ mysql ⇁ driver ............. mysql
connections ⇁ mysql ⇁ url ................. null
connections ⇁ mysql ⇁ host ............... mysql
connections ⇁ mysql ⇁ port ................ 3306
connections ⇁ mysql ⇁ database ... localdatabase
connections ⇁ mysql ⇁ username ............ sail
connections ⇁ mysql ⇁ password ........ password