php artisan up — メンテナンスモードを解除する

• カテゴリ: artisan
• 掲載バージョン: Laravel 12・PHP 8.4
• コマンド: php artisan up
• 関連: down, route:cache, config:cache
• 変更履歴: なし（安定）

要点（TL;DR）

• メンテナンスモード（down）を解除するコマンド
• 最低限の使い方: php artisan up
• よくある罠
  • デプロイ途中で up すると不整合が露出する
  • キャッシュ再生成前に公開してしまう
  • キュー/スケジューラが未起動のまま公開

概要

php artisan up は、php artisan down で有効化したメンテナンスモードを解除し、アプリケーションを通常公開状態に戻します。
デプロイ完了後の最後の一手として実行するのが基本です。
本番環境では、キャッシュ・マイグレーション・キュー起動を確認してから実行します。

構文 / シグネチャ

php artisan up

• 引数: なし
• 戻り値: なし
• 副作用: メンテナンスフラグ（storage/framework/down）の削除

使用例

最小例

php artisan up

実務例（安全なデプロイ手順）

php artisan down --render="errors::503"
php artisan migrate --force
php artisan config:clear
php artisan config:cache
php artisan route:cache
php artisan view:clear
php artisan up

DB変更・キャッシュ再生成が完了してから公開するのが定石。

よくある落とし穴・注意

• キャッシュ不整合
  config:cache / route:cache 前に up すると、旧設定でアクセスされる。
• キュー未起動
  Horizon / queue worker を起動せずに公開すると、非同期処理が滞る。
• CI/CD での順序ミス
  rsync・ビルド途中で up してしまうと、404 や500が一時的に発生。

代替・関連APIとの比較

手段	役割	使い分け
php artisan down	メンテナンス開始	デプロイ開始時
php artisan up	メンテナンス解除	デプロイ完了時
ロードバランサ制御	トラフィック遮断	大規模環境向け

テスト例（Pest）

it('maintenance mode is disabled', function () {
    expect(app()->isDownForMaintenance())->toBeFalse();
});

トラブルシュート（エラー別）

症状	原因	対処
503 が出続ける	down ファイル残存	storage/framework/down を確認
一部ページだけ 500	キャッシュ不整合	config:clear → cache
バッチが動かない	キュー未起動	worker / Horizon 起動

参考リンク

• Laravel公式ドキュメント（Maintenance Mode）
  https://laravel.com/docs/maintenance-mode