BackEnd

Laravel SailでDocker環境構築

投稿日:2021年1月25日 更新日:

はじめに

Laravel Sailは、2020年末に正式版となった、Laravel公式のローカルDocker環境と、Docker環境を便利に使用できるコマンド群です。Laravel公式ドキュメントでも、Laravelのセットアップ方法として説明されています。今回は、Laravel Sailがどのような構成であるか、またよく使用すると思われるコマンドを紹介します。

Laravel Sailの基本

Laravel Sailは、macOS、Linux、Windows(WSL2)で動作するDockerコンテナを構築します。

Dockerの構成

Laravel 8をセットアップすると、自動的に docker-compose.yml が生成されます。また、sail自体も最初から入っています。ポートフォワードなどの設定方法については後ほど説明しますが、構成についてはこのようになっています。

  • laravel.test
    UbuntuベースのオリジナルのDockerイメージです。 php artisan serve コマンドでWebサーバを起動させます。
  • mysql
    mysql:8.0 イメージが使用されています。
  • redis
    redis:alpine イメージが使用されています。
  • mailhog
    mailhog/mailhog:latest イメージが使用されています。

コンテナの起動・停止

基本的には、docker-composeコマンドと同じです。

初回起動の場合は、しばらくするとコンテナが起動します。初期設定の場合は、 http://localhost にブラウザでアクセスすると、Laravelの初期画面が表示されます。

sailで使用できるコマンド

./vendor/bin/sail artisan のように、sailではサブコマンドが用意されています。このサブコマンドは、 laravel.test コンテナ内で実行されるため、ローカルでパッケージのインストールは必要ありません。
ちなみに、下記に含まれないサブコマンドを実行したときは、全て docker-compose のサブコマンドとして実行されます。( upstop など)

  • php
  • composer
  • artisan
  • test
  • dusk
  • tinker
  • node
  • npm
  • npx
  • yarn
  • mysql
  • psql
  • shell / bash
  • root-shell
  • share

Laravel Sailの設定

よく使うと思われるLaravel Sailの設定を紹介します。

ポートフォワードの設定

laravel.test コンテナ、 mysql コンテナのポートフォワードを設定するには、.envファイルに設定します。

docker-compose.yml側では、以下のように記述されているため、設定したポートフォワードが反映されます。

PHPのバージョン切り替え

標準では、PHP 8が使われていますが、PHP 7.4に切り替えることもできます。あえて、PHP7.4を使用したい場合は、docker-compose.ymlの laravel.test コンテナを次のように修正します。

laravel.testコンテナのカスタマイズ

さらに一歩踏み込み、 laravel.test コンテナを構成するDockerfile、php.iniなどをカスタマイズするには、 ./vendor/bin/sail artisan sail:publish コマンドで設定ファイルをコピーすることができます。dockerディレクトリ配下に以下のファイルが生成されます。

7.4、8.0ディレクトリはPHPのバージョンを指します。不要なバージョンは削除して良いと思います。

さいごに

Laravel Sailは、ミニマムなコンテナを構築することができるため、良いテンプレートだと思いました。Docker初心者でも、簡単に構築することができ、また基本はdocker-compose.ymlやDockerファイルの変更によってカスタマイズが必要なので、Dockerの知識さえあればこれまでと同じようにカスタマイズできる点が特徴だと思いました。

おすすめ書籍

PHPフレームワークLaravel入門 第2版 PHPフレームワーク Laravel実践開発 PHPフレームワーク Laravel Webアプリケーション開発 バージョン5.5 LTS対応 よくわかるPHPの教科書 【PHP7対応版】

blog-page_footer_336




blog-page_footer_336




-BackEnd
-, ,

執筆者:


comment

メールアドレスが公開されることはありません。

CAPTCHA


関連記事

EloquentのtoArray()とtoJson()をカスタマイズ

1 はじめに2 $visibleプロパティと$hiddenプロパティ2.1 $visibleプロパティ2.2 $hiddenプロパティ3 独自属性の追加3.1 $appendsプロパティ4 使い所5 ...

RubyのHanamiチュートリアルをやってみた

1 はじめに2 紹介2.1 Hanamiとは?2.2 Hanamiを選ぶ理由2.2.1 軽量2.2.2 アーキテクチャとして2.2.3 スレッドセーフ3 チュートリアルのための準備4 実践4.1 はじ ...

Stripe Connectを使って複合プランの継続課金を実装

1 はじめに1.1 想定する継続課金1.2 想定するシチュエーション2 継続課金商品の作成2.1 プランの継続課金商品の作成2.2 ID数の継続課金商品の作成3 実装3.1 プランAとID数を30契約 ...

rails

form_withでフォームの送信前に処理を行う方法

1 はじめに2 form_with3 サンプル4 さいごに5 参考 はじめに フォームを送信する前に処理を行いたいケース(Google Analyticsのイベントのトラッキングなど)があると思います ...

php logo

PHP入門 〜文字列と数値の操作〜

1 はじめに2 基本ルール2.1 開始と終了のタグ2.2 ホワイトスペース2.3 大文字と小文字の区別2.4 コメント2.5 変数の定義3 文字列の操作3.1 文字列の定義3.2 無駄なスペースを削除 ...

フォロー

blog-page_side_responsive

2021年1月
 12
3456789
10111213141516
17181920212223
24252627282930
31  

アプリ情報

私たちは無料アプリもリリースしています、ぜひご覧ください。 下記のアイコンから無料でダウンロードできます。