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


関連記事

軽量なAlpine Linuxイメージでgitbookのローカル環境を構築する

1 はじめに2 Alpine Linuxとは3 Docker本体のインストール4 サンプルリポジトリのダウンロード5 dockerイメージ作成6 Gitbook初期化&実行7 Dockerの ...

laravel logo

LaravelでHTTP通信

1 はじめに2 インストール3 基本的な使い方3.1 GETでリクエストを投げる3.2 リクエストヘッダーを指定3.3 クエリパラメータを指定3.4 timeout時間を指定3.5 POSTでリクエス ...

laravel logo

Laravelの開発環境構築

1 はじめに2 開発環境構築2.1 Homestead2.2 Laradock3 Laradockで開発環境構築3.1 Laradockのダウンロード3.2 コンテナの設定ファイルを作成3.3 コンテ ...

Stripe Connectで支払方法をクローンする

1 はじめに2 プラットフォームの顧客側の実装2.1 プラットフォームの顧客登録2.2 支払方法の登録3 支払方法クローンの実装3.1 顧客と支払方法のクローン3.1.1 支払方法のクローン3.1.2 ...

laravel logo

laravel-enumを使ってみたら快適だった

1 はじめに2 enumについて3 環境4 導入5 enumクラス5.1 生成5.2 enumクラス編集5.3 日本語化6 マイグレーション6.1 生成6.2 編集7 プロパティのキャスト8 さいごに ...

フォロー

blog-page_side_responsive

2021年1月
 12
3456789
10111213141516
17181920212223
24252627282930
31  

アプリ情報

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