Hapicode

# 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

# 参考

2024-04-08
  • laravel
  • php

同じタグを持つ記事をピックアップしました。