<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p>Laravelではメンテナンスモードがあり、Artisanコマンドで簡単に切り替えることができます<br>
ここでは、メンテナンスモードの切替についてまとめました</p>
<h1 id="%E7%92%B0%E5%A2%83">
<a class="header-anchor-link" href="#%E7%92%B0%E5%A2%83" aria-hidden="true"></a> 環境</h1>
<p>Laravel 9で確認していますが、8でも同様にメンテナンスモードの切り替えができます</p>
<div class="code-block-container"><pre><code>$  php -v
PHP 8.1.8 (cli) (built: Jul  8 2022 10:58:31) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.8, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.8, Copyright (c), by Zend Technologies
$ composer -V
Composer version 2.3.10 2022-07-13 15:48:23
$ php artisan -V
Laravel Framework 9.21.3
</code></pre></div><h1 id="%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%A2%E3%83%BC%E3%83%89%E3%81%AB%E5%88%87%E3%82%8A%E6%9B%BF%E3%81%88%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%A2%E3%83%BC%E3%83%89%E3%81%AB%E5%88%87%E3%82%8A%E6%9B%BF%E3%81%88%E3%82%8B" aria-hidden="true"></a> メンテナンスモードに切り替える</h1>
<p>以下のコマンドでメンテナンスモードに切り替わります</p>
<div class="code-block-container"><pre><code>$ php artisan down

   INFO  Application is now in maintenance mode.  
</code></pre></div><p><img src="https://storage.googleapis.com/zenn-user-upload/24bb1707217d-20220721.png" alt loading="lazy" class="md-img"></p>
<h1 id="%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%A2%E3%83%BC%E3%83%89%E3%82%92%E8%A7%A3%E9%99%A4%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%A2%E3%83%BC%E3%83%89%E3%82%92%E8%A7%A3%E9%99%A4%E3%81%99%E3%82%8B" aria-hidden="true"></a> メンテナンスモードを解除する</h1>
<p>以下のコマンドでメンテナンスモードを解除できます</p>
<div class="code-block-container"><pre><code>$ php artisan up

   INFO  Application is now live.  
</code></pre></div><h1 id="%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%A2%E3%83%BC%E3%83%89%E6%99%82%E3%81%AB%E8%A8%AD%E5%AE%9A%E3%81%A7%E3%81%8D%E3%82%8B%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%A8%E6%8C%99%E5%8B%95">
<a class="header-anchor-link" href="#%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%A2%E3%83%BC%E3%83%89%E6%99%82%E3%81%AB%E8%A8%AD%E5%AE%9A%E3%81%A7%E3%81%8D%E3%82%8B%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%A8%E6%8C%99%E5%8B%95" aria-hidden="true"></a> メンテナンスモード時に設定できるオプションと挙動</h1>
<h2 id="%E3%83%AA%E3%83%95%E3%83%AC%E3%83%83%E3%82%B7%E3%83%A5%E3%81%95%E3%81%9B%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%AA%E3%83%95%E3%83%AC%E3%83%83%E3%82%B7%E3%83%A5%E3%81%95%E3%81%9B%E3%82%8B" aria-hidden="true"></a> リフレッシュさせる</h2>
<p>RefreshのHTTPヘッダーの指定ができます<br>
以下のコマンドの場合、5秒間で表示しているブラウザがリフレッシュされます。</p>
<div class="code-block-container"><pre><code>$ php artisan down --refresh=5

   INFO  Application is now in maintenance mode.  
</code></pre></div><h2 id="%E3%83%90%E3%82%A4%E3%83%91%E3%82%B9%E3%81%95%E3%81%9B%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%90%E3%82%A4%E3%83%91%E3%82%B9%E3%81%95%E3%81%9B%E3%82%8B" aria-hidden="true"></a> バイパスさせる</h2>
<p>メンテナンスモード中に通常のページを確認したい場合に利用できます<br>
<code>http://hogehoge.co.jp/testtest</code> にアクセスすれば、Cookieにバイパスの設定が追加され、アクセス後はメンテナンス画面は表示されなくなります。<br>
もとに戻したい場合は ブラウザに保存されている Cookieで name が <code>laravel_maintenance</code> を削除すればメンテナンスモードになります</p>
<div class="code-block-container"><pre><code>$ php artisan down --secret="testtest"

   INFO  Application is now in maintenance mode.  
</code></pre></div><h2 id="%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E7%94%A8%E3%81%AE%E3%83%93%E3%83%A5%E3%83%BC%E3%82%92%E3%83%AC%E3%83%B3%E3%83%80%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E7%94%A8%E3%81%AE%E3%83%93%E3%83%A5%E3%83%BC%E3%82%92%E3%83%AC%E3%83%B3%E3%83%80%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%99%E3%82%8B" aria-hidden="true"></a> メンテナンス用のビューをレンダリングする</h2>
<p>errorsを指定していますが、任意のビューの指定もできます</p>
<div class="code-block-container"><pre><code>$ php artisan down --render="errors::503"

   INFO  Application is now in maintenance mode. 
</code></pre></div><h2 id="%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AB%E3%83%AA%E3%83%80%E3%82%A4%E3%83%AC%E3%82%AF%E3%83%88%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%A1%E3%83%B3%E3%83%86%E3%83%8A%E3%83%B3%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AB%E3%83%AA%E3%83%80%E3%82%A4%E3%83%AC%E3%82%AF%E3%83%88%E3%81%99%E3%82%8B" aria-hidden="true"></a> メンテナンスページにリダイレクトする</h2>
<p><code>--redirect</code> でURLを指定すると、リダイレクトさせることができます</p>
<div class="code-block-container"><pre><code>$ php artisan down --redirect=/maintenance

   INFO  Application is now in maintenance mode.  
</code></pre></div><h1 id="%E5%8F%82%E8%80%83">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83" aria-hidden="true"></a> 参考</h1>
<p><a href="https://readouble.com/laravel/9.x/ja/configuration.html#environment-configuration" target="_blank" rel="nofollow noopener noreferrer">メンテナンスモード</a></p>


Laravelでメンテナンスモードを試してみた

メンテナンスモードに切り替える

メンテナンスモードを解除する

メンテナンス用のビューをレンダリングする

メンテナンスページにリダイレクトする

メンテナンスモード時に設定できるオプションと挙動

Discussion