LaravelSail は、Laravel で作成した PHP アプリケーションを Docker 開発環境で動作させるための環境構築ツールです。Laravel を動作させるための一通りの仕組みが構築され、簡単に Docker での開発環境を構築する事ができます。

Laravel Sail なら Docker 開発環境がコマンド 2 撃で構築できる。PHP/MySQLからキューやメール環境までオールインワン

<p>Laravel Sail というツールが 2020年12月9日 にローンチされました。</p>
<p>公式が出した Laravel アプリケーションの Docker 開発環境構築ツールですが、今回はこの Laravel Sail を使って開発環境を構築してみます。</p>
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#laravelsail">LaravelSail</a></li>
<li><a href="#laravelsail-%E3%81%AE%E5%B0%8E%E5%85%A5">LaravelSail の導入</a></li>
<li><a href="#%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E8%B5%B7%E5%8B%95">アプリケーションの起動</a></li>
<li><a href="#sail-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">sail コマンド</a>
<ol>
<li><a href="#%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9%E3%82%92%E8%A8%AD%E5%AE%9A%E3%81%99%E3%82%8B">エイリアスを設定する</a></li>
<li><a href="#%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E8%B5%B7%E5%8B%95%E5%81%9C%E6%AD%A2%E7%A2%BA%E8%AA%8D">コンテナの起動・停止・確認</a></li>
<li><a href="#%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%B8%E3%81%AE%E6%8E%A5%E7%B6%9A">アプリケーションコンテナへの接続</a></li>
<li><a href="#mysql-%E3%81%B8%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3">MySQL へログイン</a></li>
<li><a href="#artisan-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">artisan コマンド</a></li>
<li><a href="#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E5%AE%9F%E8%A1%8C">テストの実行</a></li>
<li><a href="#php-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">PHP コマンド</a></li>
<li><a href="#composer-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">Composer コマンド</a></li>
<li><a href="#node">node</a></li>
</ol>
</li>
<li><a href="#%E7%8B%AC%E8%87%AA%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%82%92%E8%A1%8C%E3%81%86">独自の設定を行う</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
<p>今回の環境は以下の通りです。</p>
<ul>
<li>macOS Catalina</li>
<li>Docker Desktop for Mac (3.x)</li>
</ul>
<p>Laravel Sail を Mac で動かす為には Docker Desktop を予めインストールしておく必要があります。</p>
<h2 id="laravelsail">LaravelSail</h2>
<p>LaravelSail は、Laravel を Docker 開発環境で動作させるためのツールです。</p>
<p>Laravel を動作させるための一通りの仕組みが構築され、簡単に Docker での開発環境を構築する事ができます。</p>
<h2 id="laravelsail-の導入">LaravelSail の導入</h2>
<p>まずは sail のための Laravel をインストールする為にシェルを実行します。書式は以下になっています。</p>
<pre><code class="hljs language-shell">curl -s https://laravel.build/&#x3C;YOUR_PROJECT_NAME> | bash
</code></pre>
<p>プロジェクト名は「sample-app」にして進めます。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell">curl -s https://laravel.build/sample-app | bash
</code></pre>
<p>Laravel インストール用のイメージが作成され、起動したコンテナにて Laravel がインストールされます。</p>
<p>この処理が終わると、作成されたディレクトリ sample-app/ 配下に、Laravel のソースコードが展開されているのを確認できます。</p>
<h2 id="アプリケーションの起動">アプリケーションの起動</h2>
<p>Laravel がインストールされたら、プロジェクトルートで以下のコマンドを叩いてアプリケーションを起動します。</p>
<pre><code class="hljs language-shell">./vendor/bin/sail up
</code></pre>
<p>初回実行の場合は mysql, redis, mailhog, そして Laravel アプリケーション用（PHP や node などが入る）のイメージが作成されてから、それぞれコンテナが起動します。</p>
<pre><code class="hljs language-shell">Creating sample-app_redis_1   ... done
Creating sample-app_mailhog_1 ... done
Creating sample-app_mysql_1   ... done
Creating sample-app_laravel.test_1 ... done
</code></pre>
<p>ネットワークの状況にもよりますが、初回実行の場合はイメージを作成するため数分程度かかります。また、途中、ディレクトリのパーミッションを変更する為にパスワードの入力を求められます。</p>
<p>コンテナが起動したら、http://localhost/ にアクセスすると初期画面が表示されます。</p>
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/217/PSyTgQNtjoxPqil6Zvse.png" width="800" height="427" alt="Laravel初期画面"></div>
<p>MailHog のコンテナも起動しているので、メールの受信画面へは http://localhost:8025 にアクセスすると表示されます。</p>
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/217/4x16XnrlAK8VGBeIOYDG.png" width="800" height="427" alt="MailHog 画面"></div>
<p>これで Sail での環境構築は完了です。コマンドを 2 回叩いただけで環境が出来上がりました。</p>
<h2 id="sail-コマンド">sail コマンド</h2>
<p>Laravel Sail で起動させた場合に、コンテナの起動・停止や通常叩いている artisan コマンド等は以下の sail コマンドを使う事で実行できます。</p>
<pre><code class="hljs language-shell">./vendor/bin/sail &#x3C;same_command...>
</code></pre>
<h3 id="エイリアスを設定する">エイリアスを設定する</h3>
<p>毎回 ./vendor/bin/sail ... と入力するのが手間なので、エイリアス設定して、sail ... で sail コマンドを実行できるようにしておきます。</p>
<p>（以下、公式と記述が異なるので公式のアナウンスに沿った形でエイリアスを記述したい場合は <a href="https://laravel.com/docs/8.x/sail#configuring-a-bash-alias" rel="noopener noreferrer" target="_blank">Configuring A Bash Alias</a> を参照ください）</p>
<p>今回は .zshrc にエイリアスを設定します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">vim ~/.zshrc</span>

---
<span class="hljs-meta prompt_"># </span><span class="bash">Laravel Sail Command Alias</span>
alias sail="./vendor/bin/sail"
---
</code></pre>
<p>設定ファイルを再読み込みします。</p>
<pre><code class="hljs language-shell">source ~/.zshrc
</code></pre>
<p>エイリアスの反映確認のため、以下のコマンドを Laravel のルートディレクトリ配下で実行します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail -v</span>
docker-compose version 1.27.4, build 40524192
</code></pre>
<p>エイリアスが反映された事が確認できました。</p>
<h3 id="コンテナの起動停止確認">コンテナの起動・停止・確認</h3>
<p>コンテナの起動は up で行います</p>
<pre><code class="hljs language-shell">sail up
</code></pre>
<p>停止させる時は control + c でコンテナが停止します。</p>
<p>コンテナをバックグラウンドで動作させたい場合は -d を付与して detach モードで起動します。</p>
<pre><code class="hljs language-shell">sail up -d
</code></pre>
<p>この場合にコンテナを停止する時は down で行います。</p>
<pre><code class="hljs language-shell">sail down
</code></pre>
<p>コンテナが起動しているかの状態は sail とコマンドを打つことで確認できます</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail</span>
          Name                         Command               State                       Ports
-------------------------------------------------------------------------------------------------------------------
sample-app_laravel.test_1   start-container                  Up      0.0.0.0:80->80/tcp, 8000/tcp
.
.
.

</code></pre>
<h3 id="アプリケーションコンテナへの接続">アプリケーションコンテナへの接続</h3>
<p>アプリケーション用のコンテナに入りたい時は以下のコマンドで入ることができます。</p>
<pre><code class="hljs language-shell">sail shell
</code></pre>
<h3 id="mysql-へログイン">MySQL へログイン</h3>
<p>MySQL へログインするのは sail exec ... で行えます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail <span class="hljs-built_in">exec</span> mysql mysql -uroot</span>

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 9
Server version: 8.0.22 MySQL Community Server - GPL

Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
<span class="hljs-meta prompt_">
mysql></span><span class="bash">
</span></code></pre>
<p>MySQL へのログインに限りませんが、元は docker-compose なので、後述のものも含め、直接 docker-compose コマンドでも sail コマンドでも、どちらでもやりやすい方でよいと思います。</p>
<h3 id="artisan-コマンド">artisan コマンド</h3>
<p>artisan コマンドを実行する時も sail コマンドで行えます。</p>
<pre><code class="hljs language-shell">sail artisan &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail artisan -V</span>
Laravel Framework 8.18.1
</code></pre>
<h3 id="テストの実行">テストの実行</h3>
<p>PHPUnit を動作させる時も sail コマンドで実行できます。</p>
<pre><code class="hljs language-shell">sail test
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail <span class="hljs-built_in">test</span></span>

   PASS  Tests\Unit\ExampleTest
✓ basic test

   PASS  Tests\Feature\ExampleTest
✓ basic test

  &#x3C;b>Tests:&#x3C;/b>  2 passed
&#x3C;b style="color: rgb(248, 248, 242);">Time:&#x3C;/b>   0.71s
</code></pre>
<h3 id="php-コマンド">PHP コマンド</h3>
<p>PHP コマンドも sail コマンドから実行できます</p>
<pre><code class="hljs language-shell">sail php &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail php -v</span>
PHP 8.0.0 (cli) (built: Nov 27 2020 12:26:22) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.0-dev, Copyright (c) Zend Technologies
    with Zend OPcache v8.0.0, Copyright (c), by Zend Technologies
</code></pre>
<h3 id="composer-コマンド">Composer コマンド</h3>
<p>Composer コマンドも sail コマンドから実行できます。</p>
<pre><code class="hljs language-shell">sail composer &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail composer -v</span>
Composer version 2.0.8 2020-12-03 17:20:38
</code></pre>
<h3 id="node">node</h3>
<p>node もインストールされているので、sail コマンドから叩けます。（NPM）</p>
<pre><code class="hljs language-shell">sail node &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail node -v</span>
v15.4.0
</code></pre>
<h2 id="独自の設定を行う">独自の設定を行う</h2>
<p>sail で作成されるコンテナやイメージに新たに何かを追加したり変更したい場合は、Dockerfile 等の sail リソースを出力してカスタマイズする事が可能です。</p>
<p>以下のコマンドで出力します。</p>
<pre><code class="hljs language-shell">sail artisan sail:publish
</code></pre>
<p>コマンドを実行すると、プロジェクトルートに docker ディレクトリが作成されて Sail の Dockerfile やそこで使用している設定ファイルが出力されます。</p>
<pre><code class="hljs language-shell">docker
├── 7.4
│   ├── Dockerfile
│   ├── php.ini
│   ├── start-container
│   └── supervisord.conf
└── 8.0
    ├── Dockerfile
    ├── php.ini
    ├── start-container
    └── supervisord.conf
</code></pre>
<p>なお、publish すると次からは、プロジェクトルートの Dockerfile を参照するようになります。</p>
<p>試しにイメージを変更してみます。Sail の Dockerfile はデフォルトでは タイムゾーンが UTC で設定されているので、これを JST に変更してみます。</p>
<dl class="description_setting">
<dt>sample-app/docker/8.0/Dockerfile</dt>
<dd>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">ENV TZ=UTC</span>
ENV TZ='Asia/Tokyo'
</code></pre>
</dd>
</dl>
<p>Dockerfile を変更したら、以下のコマンドでイメージをビルドします。</p>
<pre><code class="hljs language-shell">sail build --no-cache
</code></pre>
<p>イメージのビルドが終わったらコンテナを起動して確認してみます。</p>
<pre><code># 変更前
% sail shell

sail@45e7f632b6e7:/var/www/html$ date
Tue Dec 15 11:49:45 UTC 2020


# 変更後
% sail shell

sail@f577af4e8b8f:/var/www/html$ date
Tue Dec 15 21:05:55 JST 2020
</code></pre>
<p>アプリケーション用のコンテナに変更が反映された事が確認できました。</p>
<h2 id="まとめ">まとめ</h2>
<p>たった 2 回のコマンドで環境が構築できるのはとても簡単ですね。</p>
<p>色々とカスタマイズもできるので、開発環境を構築する際に融通も利いて良い感じだと思います。</p>

<p>Laravel Sail というツールが 2020年12月9日 にローンチされました。</p>
<p>公式が出した Laravel アプリケーションの Docker 開発環境構築ツールですが、今回はこの Laravel Sail を使って開発環境を構築してみます。</p>
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#laravelsail">LaravelSail</a></li>
<li><a href="#laravelsail-%E3%81%AE%E5%B0%8E%E5%85%A5">LaravelSail の導入</a></li>
<li><a href="#%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E8%B5%B7%E5%8B%95">アプリケーションの起動</a></li>
<li><a href="#sail-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">sail コマンド</a>
<ol>
<li><a href="#%E3%82%A8%E3%82%A4%E3%83%AA%E3%82%A2%E3%82%B9%E3%82%92%E8%A8%AD%E5%AE%9A%E3%81%99%E3%82%8B">エイリアスを設定する</a></li>
<li><a href="#%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E8%B5%B7%E5%8B%95%E5%81%9C%E6%AD%A2%E7%A2%BA%E8%AA%8D">コンテナの起動・停止・確認</a></li>
<li><a href="#%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%B8%E3%81%AE%E6%8E%A5%E7%B6%9A">アプリケーションコンテナへの接続</a></li>
<li><a href="#mysql-%E3%81%B8%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3">MySQL へログイン</a></li>
<li><a href="#artisan-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">artisan コマンド</a></li>
<li><a href="#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E5%AE%9F%E8%A1%8C">テストの実行</a></li>
<li><a href="#php-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">PHP コマンド</a></li>
<li><a href="#composer-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">Composer コマンド</a></li>
<li><a href="#node">node</a></li>
</ol>
</li>
<li><a href="#%E7%8B%AC%E8%87%AA%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%82%92%E8%A1%8C%E3%81%86">独自の設定を行う</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
<p>今回の環境は以下の通りです。</p>
<ul>
<li>macOS Catalina</li>
<li>Docker Desktop for Mac (3.x)</li>
</ul>
<p>Laravel Sail を Mac で動かす為には Docker Desktop を予めインストールしておく必要があります。</p>
<h2 id="laravelsail">LaravelSail</h2>
<p>LaravelSail は、Laravel を Docker 開発環境で動作させるためのツールです。</p>
<p>Laravel を動作させるための一通りの仕組みが構築され、簡単に Docker での開発環境を構築する事ができます。</p>
<h2 id="laravelsail-の導入">LaravelSail の導入</h2>
<p>まずは sail のための Laravel をインストールする為にシェルを実行します。書式は以下になっています。</p>
<pre><code class="hljs language-shell">curl -s https://laravel.build/&#x3C;YOUR_PROJECT_NAME> | bash
</code></pre>
<p>プロジェクト名は「sample-app」にして進めます。以下のコマンドを叩きます。</p>
<pre><code class="hljs language-shell">curl -s https://laravel.build/sample-app | bash
</code></pre>
<p>Laravel インストール用のイメージが作成され、起動したコンテナにて Laravel がインストールされます。</p>
<p>この処理が終わると、作成されたディレクトリ sample-app/ 配下に、Laravel のソースコードが展開されているのを確認できます。</p>
<h2 id="アプリケーションの起動">アプリケーションの起動</h2>
<p>Laravel がインストールされたら、プロジェクトルートで以下のコマンドを叩いてアプリケーションを起動します。</p>
<pre><code class="hljs language-shell">./vendor/bin/sail up
</code></pre>
<p>初回実行の場合は mysql, redis, mailhog, そして Laravel アプリケーション用（PHP や node などが入る）のイメージが作成されてから、それぞれコンテナが起動します。</p>
<pre><code class="hljs language-shell">Creating sample-app_redis_1   ... done
Creating sample-app_mailhog_1 ... done
Creating sample-app_mysql_1   ... done
Creating sample-app_laravel.test_1 ... done
</code></pre>
<p>ネットワークの状況にもよりますが、初回実行の場合はイメージを作成するため数分程度かかります。また、途中、ディレクトリのパーミッションを変更する為にパスワードの入力を求められます。</p>
<p>コンテナが起動したら、http://localhost/ にアクセスすると初期画面が表示されます。</p>
<div class="img_wrap"><img src="/images/posts/217/PSyTgQNtjoxPqil6Zvse.png" width="800" height="427" alt="Laravel初期画面"></div>
<p>MailHog のコンテナも起動しているので、メールの受信画面へは http://localhost:8025 にアクセスすると表示されます。</p>
<div class="img_wrap"><img src="/images/posts/217/4x16XnrlAK8VGBeIOYDG.png" width="800" height="427" alt="MailHog 画面"></div>
<p>これで Sail での環境構築は完了です。コマンドを 2 回叩いただけで環境が出来上がりました。</p>
<h2 id="sail-コマンド">sail コマンド</h2>
<p>Laravel Sail で起動させた場合に、コンテナの起動・停止や通常叩いている artisan コマンド等は以下の sail コマンドを使う事で実行できます。</p>
<pre><code class="hljs language-shell">./vendor/bin/sail &#x3C;same_command...>
</code></pre>
<h3 id="エイリアスを設定する">エイリアスを設定する</h3>
<p>毎回 ./vendor/bin/sail ... と入力するのが手間なので、エイリアス設定して、sail ... で sail コマンドを実行できるようにしておきます。</p>
<p>（以下、公式と記述が異なるので公式のアナウンスに沿った形でエイリアスを記述したい場合は <a href="https://laravel.com/docs/8.x/sail#configuring-a-bash-alias" rel="noopener noreferrer" target="_blank">Configuring A Bash Alias</a> を参照ください）</p>
<p>今回は .zshrc にエイリアスを設定します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">vim ~/.zshrc</span>

---
<span class="hljs-meta prompt_"># </span><span class="bash">Laravel Sail Command Alias</span>
alias sail="./vendor/bin/sail"
---
</code></pre>
<p>設定ファイルを再読み込みします。</p>
<pre><code class="hljs language-shell">source ~/.zshrc
</code></pre>
<p>エイリアスの反映確認のため、以下のコマンドを Laravel のルートディレクトリ配下で実行します。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail -v</span>
docker-compose version 1.27.4, build 40524192
</code></pre>
<p>エイリアスが反映された事が確認できました。</p>
<h3 id="コンテナの起動停止確認">コンテナの起動・停止・確認</h3>
<p>コンテナの起動は up で行います</p>
<pre><code class="hljs language-shell">sail up
</code></pre>
<p>停止させる時は control + c でコンテナが停止します。</p>
<p>コンテナをバックグラウンドで動作させたい場合は -d を付与して detach モードで起動します。</p>
<pre><code class="hljs language-shell">sail up -d
</code></pre>
<p>この場合にコンテナを停止する時は down で行います。</p>
<pre><code class="hljs language-shell">sail down
</code></pre>
<p>コンテナが起動しているかの状態は sail とコマンドを打つことで確認できます</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail</span>
          Name                         Command               State                       Ports
-------------------------------------------------------------------------------------------------------------------
sample-app_laravel.test_1   start-container                  Up      0.0.0.0:80->80/tcp, 8000/tcp
.
.
.

</code></pre>
<h3 id="アプリケーションコンテナへの接続">アプリケーションコンテナへの接続</h3>
<p>アプリケーション用のコンテナに入りたい時は以下のコマンドで入ることができます。</p>
<pre><code class="hljs language-shell">sail shell
</code></pre>
<h3 id="mysql-へログイン">MySQL へログイン</h3>
<p>MySQL へログインするのは sail exec ... で行えます。</p>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail <span class="hljs-built_in">exec</span> mysql mysql -uroot</span>

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 9
Server version: 8.0.22 MySQL Community Server - GPL

Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
<span class="hljs-meta prompt_">
mysql></span><span class="bash">
</span></code></pre>
<p>MySQL へのログインに限りませんが、元は docker-compose なので、後述のものも含め、直接 docker-compose コマンドでも sail コマンドでも、どちらでもやりやすい方でよいと思います。</p>
<h3 id="artisan-コマンド">artisan コマンド</h3>
<p>artisan コマンドを実行する時も sail コマンドで行えます。</p>
<pre><code class="hljs language-shell">sail artisan &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail artisan -V</span>
Laravel Framework 8.18.1
</code></pre>
<h3 id="テストの実行">テストの実行</h3>
<p>PHPUnit を動作させる時も sail コマンドで実行できます。</p>
<pre><code class="hljs language-shell">sail test
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail <span class="hljs-built_in">test</span></span>

   PASS  Tests\Unit\ExampleTest
✓ basic test

   PASS  Tests\Feature\ExampleTest
✓ basic test

  &#x3C;b>Tests:&#x3C;/b>  2 passed
&#x3C;b style="color: rgb(248, 248, 242);">Time:&#x3C;/b>   0.71s
</code></pre>
<h3 id="php-コマンド">PHP コマンド</h3>
<p>PHP コマンドも sail コマンドから実行できます</p>
<pre><code class="hljs language-shell">sail php &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail php -v</span>
PHP 8.0.0 (cli) (built: Nov 27 2020 12:26:22) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.0-dev, Copyright (c) Zend Technologies
    with Zend OPcache v8.0.0, Copyright (c), by Zend Technologies
</code></pre>
<h3 id="composer-コマンド">Composer コマンド</h3>
<p>Composer コマンドも sail コマンドから実行できます。</p>
<pre><code class="hljs language-shell">sail composer &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail composer -v</span>
Composer version 2.0.8 2020-12-03 17:20:38
</code></pre>
<h3 id="node">node</h3>
<p>node もインストールされているので、sail コマンドから叩けます。（NPM）</p>
<pre><code class="hljs language-shell">sail node &#x3C;command ...>
</code></pre>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_">% </span><span class="bash">sail node -v</span>
v15.4.0
</code></pre>
<h2 id="独自の設定を行う">独自の設定を行う</h2>
<p>sail で作成されるコンテナやイメージに新たに何かを追加したり変更したい場合は、Dockerfile 等の sail リソースを出力してカスタマイズする事が可能です。</p>
<p>以下のコマンドで出力します。</p>
<pre><code class="hljs language-shell">sail artisan sail:publish
</code></pre>
<p>コマンドを実行すると、プロジェクトルートに docker ディレクトリが作成されて Sail の Dockerfile やそこで使用している設定ファイルが出力されます。</p>
<pre><code class="hljs language-shell">docker
├── 7.4
│   ├── Dockerfile
│   ├── php.ini
│   ├── start-container
│   └── supervisord.conf
└── 8.0
    ├── Dockerfile
    ├── php.ini
    ├── start-container
    └── supervisord.conf
</code></pre>
<p>なお、publish すると次からは、プロジェクトルートの Dockerfile を参照するようになります。</p>
<p>試しにイメージを変更してみます。Sail の Dockerfile はデフォルトでは タイムゾーンが UTC で設定されているので、これを JST に変更してみます。</p>
<dl class="description_setting">
<dt>sample-app/docker/8.0/Dockerfile</dt>
<dd>
<pre><code class="hljs language-shell"><span class="hljs-meta prompt_"># </span><span class="bash">ENV TZ=UTC</span>
ENV TZ='Asia/Tokyo'
</code></pre>
</dd>
</dl>
<p>Dockerfile を変更したら、以下のコマンドでイメージをビルドします。</p>
<pre><code class="hljs language-shell">sail build --no-cache
</code></pre>
<p>イメージのビルドが終わったらコンテナを起動して確認してみます。</p>
<pre><code># 変更前
% sail shell

sail@45e7f632b6e7:/var/www/html$ date
Tue Dec 15 11:49:45 UTC 2020


# 変更後
% sail shell

sail@f577af4e8b8f:/var/www/html$ date
Tue Dec 15 21:05:55 JST 2020
</code></pre>
<p>アプリケーション用のコンテナに変更が反映された事が確認できました。</p>
<h2 id="まとめ">まとめ</h2>
<p>たった 2 回のコマンドで環境が構築できるのはとても簡単ですね。</p>
<p>色々とカスタマイズもできるので、開発環境を構築する際に融通も利いて良い感じだと思います。</p>

Author