Laravel Sailは、2020年末に正式版となった、Laravel公式のローカルDocker環境と、Docker環境を便利に使用できるコマンド群です。Laravel公式ドキュメントでも、Laravelのセットアップ方法として説明されています。今回は、Laravel Sailがどのような構成であるか、またよく使用すると思われるコマンドを紹介します。
Laravel Sailは、macOS、Linux、Windows(WSL2)で動作するDockerコンテナを構築します。
Laravel 8をセットアップすると、自動的に docker-compose.ymlが生成されます。また、sail自体も最初から入っています。ポートフォワードなどの設定方法については後ほど説明しますが、構成についてはこのようになっています。
php artisan serveコマンドでWebサーバを起動させます。mysql:8.0イメージが使用されています。redis:alpineイメージが使用されています。mailhog/mailhog:latestイメージが使用されています。基本的には、docker-composeコマンドと同じです。
$ ./vendor/bin/sail up # コンテナの起動 $ ./vendor/bin/sail stop # コンテナの停止
初回起動の場合は、しばらくするとコンテナが起動します。初期設定の場合は、 http://localhostにブラウザでアクセスすると、Laravelの初期画面が表示されます。
./vendor/bin/sail artisanのように、sailではサブコマンドが用意されています。このサブコマンドは、 laravel.testコンテナ内で実行されるため、ローカルでパッケージのインストールは必要ありません。
ちなみに、下記に含まれないサブコマンドを実行したときは、全て docker-composeのサブコマンドとして実行されます。( up や stopなど)
よく使うと思われるLaravel Sailの設定を紹介します。
laravel.testコンテナ、 mysqlコンテナのポートフォワードを設定するには、.envファイルに設定します。
APP_PORT=8080 # laravel.testコンテナのポート FORWARD_DB_PORT=13306 # MySQLのポート
docker-compose.yml側では、以下のように記述されているため、設定したポートフォワードが反映されます。
services:
laravel.test:
・・・中略・・・
ports:
- '${APP_PORT:-80}:80'
標準では、PHP 8が使われていますが、PHP 7.4に切り替えることもできます。あえて、PHP7.4を使用したい場合は、docker-compose.ymlの laravel.testコンテナを次のように修正します。
services:
laravel.test:
build:
context: ./vendor/laravel/sail/runtimes/7.4
・・・後略・・・ さらに一歩踏み込み、laravel.testコンテナを構成するDockerfile、php.iniなどをカスタマイズするには、 ./vendor/bin/sail artisan sail:publishコマンドで設定ファイルをコピーすることができます。dockerディレクトリ配下に以下のファイルが生成されます。
docker
├── 7.4
│ ├── Dockerfile
│ ├── php.ini
│ ├── start-container
│ └── supervisord.conf
└── 8.0
├── Dockerfile
├── php.ini
├── start-container
└── supervisord.conf
7.4、8.0ディレクトリはPHPのバージョンを指します。不要なバージョンは削除して良いと思います。
Laravel Sailは、ミニマムなコンテナを構築することができるため、良いテンプレートだと思いました。Docker初心者でも、簡単に構築することができ、また基本はdocker-compose.ymlやDockerファイルの変更によってカスタマイズが必要なので、Dockerの知識さえあればこれまでと同じようにカスタマイズできる点が特徴だと思いました。