Laravel Sailを使うと、PCにPHPやMySQLを入れずに、DockerだけでLaravelの開発環境を作れます。この記事では、新しいプロジェクトの作成から、使うバージョンの固定、起動、Artisan・Composer・npmの実行、データベースへの接続、停止までを、実際に動かした結果とあわせてまとめます。MySQLは、長期サポート版(LTS)の最新の9.7.4を使います。
結論
| やりたいこと | コマンド |
|---|---|
| プロジェクトを作る | 「1. プロジェクトを作る」のコマンド |
| バージョンを固定する | 「2. バージョンを固定する」の手順(sail:publish と、compose.yaml、Dockerfile の書き換え) |
| 起動する | ./vendor/bin/sail up -d |
| 状態を見る | sail ps |
| Artisanを実行する | sail artisan migrate |
| Composerを実行する | sail composer require laravel/sanctum:4.3.3 |
| npmを実行する | sail npm install、sail npm run build |
| MySQLに入る | sail mysql |
| 止める | sail stop |
| 止めて、コンテナを消す | sail down |
| データベースの中身も消す | sail down -v |
sail は、./vendor/bin/sail を短く打つためのエイリアスです(「4. sail と打つだけで動かす」)。
対象のOSと前提
この記事は、MacとWindowsの両方の読者を対象にしています。Laravelの公式ドキュメントでは、SailはmacOS、Linux、Windows(WSL2経由)に対応しています。コマンドは、Macではターミナルのシェル(zshなど)、WindowsではWSL2のUbuntuなどのシェルで実行します。
| OS | 用意するもの | コマンドを打つ場所 |
|---|---|---|
| Mac | Docker Desktop | ターミナル |
| Windows | WSL2とLinux(Ubuntuなど)、Docker Desktop(Linuxコンテナの設定)。Docker Desktopの Settings > Resources > WSL Integration で、使うLinuxを有効にする | WSL2のUbuntuなどのターミナル |
- Windowsでは、プロジェクトをWSLのファイルシステム(
~の下)に置きます。Microsoftの公式ドキュメントでは、Linuxのコマンドラインで作業するときは、ファイルをWSLのファイルシステムに置くと最も速いとされています。/mnt/cの下(Windowsのフォルダ)は避けます。 - MacとWindowsの手順は、公式ドキュメント(Laravel、Docker、Microsoft)に基づくもので、実際には動かしていません。
動作確認した環境
この記事のコマンドは、Claude(AI)が実行して確認しました。確認したLinuxは、Windows 11のDocker Desktopの上に、Docker公式の docker:29.9.3-dind(Docker in Docker)のコンテナとして用意したものです(Alpine Linux 3.24、bash 5.3.9、uid 1000の一般ユーザー、Docker 29.9.3、Docker Compose v5.7.0)。この中で、新しい環境から上から順に実行しました。確認日は2026年11月6日です。
同じ環境を作り直せるように、確認した日の最新版にバージョンを固定しました。Dockerのイメージは、タグとdigest(@sha256:...)で固定しています。
| もの | バージョン | 固定する場所 |
|---|---|---|
| プロジェクト作成用のイメージ | composer:2.11.1(Composer公式。PHP 8.5.12、Composer 2.11.1) | コマンド(digest) |
Laravelのひな形(laravel/laravel) | 13.11.0 | コマンド |
Laravel本体(laravel/framework) | 13.40.0 | composer.json |
Laravel Sail(laravel/sail) | 1.69.0 | composer.json |
| Laravel Sanctum(手順6で追加) | 4.3.3 | composer.json |
| MySQL | mysql:9.7.4 | compose.yaml(digest) |
| アプリのコンテナのOS | ubuntu:noble-20261024.1(Ubuntu 24.04.5 LTS) | Dockerfile(digest) |
| アプリのコンテナのComposer | 2.11.1 | Dockerfile |
| Node.js | 24.22.2 | Dockerfile |
| npm、Bun、Corepack | 12.2.2、1.4.4、0.36.0 | Dockerfile |
| pnpm、Yarn | 12.18.0、4.18.1 | Dockerfile(Corepackで固定) |
| cpx、Playwright(ブラウザの依存パッケージを入れるのに使う) | 2.1.0、1.65.0 | Dockerfile |
次のものは、この手順では固定できていません。作った日やビルドした日の版になります。
| もの | 確認時の版 | 固定していない理由 |
|---|---|---|
| アプリのコンテナのPHP | 8.5.12 | SailはPHPを、Ubuntu向けのPHPのリポジトリ(packages.sury.org)から入れます。2026年11月6日に見たとき、このリポジトリには php8.5-cli が最新の1つの版しかなく、古い版を指定できません |
| アプリのコンテナのUbuntuのパッケージ(MySQLのクライアントなど)と、PostgreSQLのリポジトリ(PGDG)から入るPostgreSQLのクライアント | mysql-client 8.0.46、psql 18.6 など | Sailの Dockerfile は、ビルドのたびに apt-get upgrade などで、その日の版を入れます |
| 上の表にないComposerとnpmのパッケージ | 作った日の版 | Composerのパッケージは、作った日に解決された版が composer.lock に記録されます。npmのパッケージも、sail npm install をした日に解決された版になります。あとから同じコマンドで作ると、新しい版になることがあります |
以降の出力は、イメージのダウンロードやビルドのログなど一部を省略しています。
1. プロジェクトを作る
Laravel 13.xの公式ドキュメントでは、Sailは composer require laravel/sail --dev で入れ、php artisan sail:install で設定します。ここでは、PCにPHPとComposerがなくても進められるように、Composer公式のDockerイメージ(composer)の中で、プロジェクトの作成からこの2つまでを実行します。
$ docker run --rm -u "$(id -u):$(id -g)" -v "$(pwd)":/app -w /app composer:2.11.1@sha256:8de2184c6de224f4689e8f80ed5f5edaf0030b6b8b7839a22a2bcb6722ac87d0 sh -c "composer create-project laravel/laravel:13.11.0 example-app && cd example-app && composer require laravel/framework:13.40.0 && composer require laravel/sail:1.69.0 --dev && php artisan sail:install --with=mysql"
(省略)
Creating a "laravel/laravel:13.11.0" project at "./example-app"
Installing laravel/laravel (v13.11.0)
(省略)
- Locking laravel/framework (v13.40.0)
(省略)
./composer.json has been updated
Running composer update laravel/framework
Loading composer repositories with package information
Updating dependencies
Nothing to modify in lock file
(省略)
- Locking laravel/sail (v1.69.0)
(省略)
INFO Sail scaffolding installed successfully. You may run your Docker containers using Sail's "up" command.
➜ ./vendor/bin/sail up
WARN A database service was installed. Run "artisan migrate" to prepare your database:
➜ ./vendor/bin/sail artisan migrate
-u "$(id -u):$(id -g)": 自分のユーザーとして実行し、作られるファイルの所有者を自分にします。composer:2.11.1@sha256:...、laravel/laravel:13.11.0、laravel/sail:1.69.0: イメージとひな形とSailのバージョンを固定しています。composer require laravel/framework:13.40.0: ひな形のcomposer.jsonでは、Laravel本体は^13.17(13.17以上の13.x)と範囲で指定されていて、作った日の最新が入ります。このコマンドで13.40.0ちょうどに固定します。今回は作った時点の最新が13.40.0だったので、Nothing to modify in lock file(入っている版は変わらない)と出ました。--with=mysql: Sailで使うサービスを、MySQLだけにします。- Laravelは、同じ流れを1行で行うスクリプト(
curl -s "https://laravel.build/example-app?with=mysql" | bash)も配信しています。2026年11月5日に中身を確認したところ、Laravelのイメージlaravelsail/php84-composer:latestでlaravel newなどを実行したあと、doas(なければsudo)でファイルの所有者を直していました。認証が必要な環境では、パスワードを聞かれます。13.xのドキュメントには載っておらず、バージョンも固定されないので、この記事では実行していません。
composer.json には固定した版が入り、.env にはMySQLにつなぐ設定が入りました。この時点の compose.yaml では、アプリのコンテナはSailの中のPHP 8.5の定義から作られ、MySQLは mysql:8.4 です。
$ cd example-app
$ grep -E "\"laravel/(framework|sail)\"" composer.json
"laravel/framework": "13.40.0",
"laravel/sail": "1.69.0",
$ grep -E "^(APP_URL|DB_|SESSION_DRIVER)" .env
APP_URL=http://localhost:8000
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=password
SESSION_DRIVER=database
$ grep -E "image:|context:" compose.yaml
context: './vendor/laravel/sail/runtimes/8.5'
image: 'sail-8.5/app'
image: 'mysql:8.4'
2. バージョンを固定する
Sailの初期の設定のままだと、MySQLは mysql:8.4(8.4系の、取得した日の最新)になり、アプリのコンテナはビルドした日の版で作られます。ここでは、MySQLを9.7.4にし、アプリのコンテナで固定できるものを固定します。この章を飛ばして手順3に進めば、公式の手順どおりの初期の設定で動きます。
SailのDockerfileを取り出す
アプリのコンテナの定義(Dockerfile)は、vendor の中のSailのパッケージにあります。公式ドキュメントのカスタマイズの手順のとおり、sail:publish でプロジェクトの docker ディレクトリに取り出します。まだSailを起動していないので、手順1と同じイメージで実行します。
$ docker run --rm -u "$(id -u):$(id -g)" -v "$(pwd)":/app -w /app composer:2.11.1@sha256:8de2184c6de224f4689e8f80ed5f5edaf0030b6b8b7839a22a2bcb6722ac87d0 php artisan sail:publish
INFO Publishing [sail-docker] assets.
Copying directory [vendor/laravel/sail/runtimes] to [docker] .......... DONE
INFO Publishing [sail-database] assets.
Copying directory [vendor/laravel/sail/database] to [docker] .......... DONE
$ ls docker
8.0
8.1
8.2
8.3
8.4
8.5
mariadb
mysql
pgsql
$ grep -E "image:|context:" compose.yaml
context: './docker/8.5'
image: 'sail-8.5/app'
image: 'mysql:8.4'
compose.yaml のアプリのコンテナの定義の場所(context)が、./docker/8.5 に変わりました。
compose.yaml のMySQLとイメージの名前を変える
compose.yaml の2か所を書き換えます。
- MySQLのイメージを
mysql:9.7.4にし、digestもつけて固定します。digestは、Docker Hubで同じタグのイメージが作り直されても、同じものを取得するためです。 - アプリのイメージの名前を
example-app/appにします。公式ドキュメントでは、Sailをカスタマイズしたらイメージの名前を変えるとよいとしていて、1台のPCで複数のLaravelのアプリを作るときは、名前を分けることが特に大事だとしています。
ここでは sed で書き換えていますが、エディタで書き換えても同じです。Macの標準の sed では、-i の後に '' が必要です(sed -i '' "s|...|...|" compose.yaml。Appleの sed のマニュアル。未確認)。
$ sed -i "s|image: 'mysql:8.4'|image: 'mysql:9.7.4@sha256:df90258da46f6e7ff8574ff84f17618aba0765cac749928299c69fd4e7cb8ad8'|" compose.yaml
$ sed -i "s|image: 'sail-8.5/app'|image: 'example-app/app'|" compose.yaml
$ grep -E "image:|context:" compose.yaml
context: './docker/8.5'
image: 'example-app/app'
image: 'mysql:9.7.4@sha256:df90258da46f6e7ff8574ff84f17618aba0765cac749928299c69fd4e7cb8ad8'
Dockerfile のバージョンを固定する
取り出した docker/8.5/Dockerfile を、エディタで次のように書き換えます。下は、書き換えたあとに元のファイル(vendor の中)と比べた結果です。< の行が元の内容、> の行が書き換えた内容です。確認では、同じ書き換えを sed で行いました(コマンドは省略)。
$ diff vendor/laravel/sail/runtimes/8.5/Dockerfile docker/8.5/Dockerfile
1c1
< FROM ubuntu:24.04
---
> FROM ubuntu:noble-20261024.1@sha256:fe81560990fae86dc4743202b2cb4d3df98d0bcf949173cecef15ce1127ef852
18a19
> ENV COREPACK_HOME=/usr/local/share/corepack
60,61c61,62
< && curl -sLS https://getcomposer.org/installer | php -- --install-dir=/usr/bin/ --filename=composer \
< && COMPOSER_HOME=/usr/local/share/composer composer global require cpx/cpx:^2.0 \
---
> && curl -sLS https://getcomposer.org/installer | php -- --install-dir=/usr/bin/ --filename=composer --version=2.11.1 \
> && COMPOSER_HOME=/usr/local/share/composer composer global require cpx/cpx:2.1.0 \
64,65c65,66
< && apt-get install -y nodejs \
< && npm install -g npm pnpm bun corepack \
---
> && apt-get install -y nodejs=24.22.2-1nodesource1 \
> && npm install -g npm@12.2.2 pnpm@12.18.0 bun@1.4.4 corepack@0.36.0 \
67,68c68,69
< && corepack prepare yarn@stable --activate \
< && npx -y playwright install-deps \
---
> && corepack prepare yarn@4.18.1 pnpm@12.18.0 --activate && pnpm --version \
> && npx -y playwright@1.65.0 install-deps \
FROM: ベースのUbuntuのイメージを、日付つきのタグ(nobleはUbuntu 24.04の名前)とdigestで固定します。--version=2.11.1: Composerのインストーラーで、入れる版を指定します。nodejs=24.22.2-1nodesource1: Node.jsは、NodeSourceのリポジトリから入ります。このリポジトリには24.x系の古い版も残っていて(2026年11月6日に見たときは31個)、版を指定できます。@12.2.2など: npmで入れるツールと、cpx、Playwrightの版を指定します。COREPACK_HOMEとcorepack prepare yarn@4.18.1 pnpm@12.18.0 --activate && pnpm --version: YarnとpnpmはCorepack(Node.jsのパッケージマネージャーの版を管理するツール)を通して動き、npmで入れたpnpmもCorepackの起動用のファイルに置き換わります。Corepackは、準備した版をCOREPACK_HOMEの場所に記録し、既定ではユーザーごとの場所になります。もとの設定では、ビルドのとき(root)に準備したYarnの版が、Sailがコマンドを実行するユーザー(sail)には使われません。Node.js公式のイメージで同じ順に試したところ、一般ユーザーでは、YarnもpnpmもCorepackが通信して版を決めようとしました。そこでCOREPACK_HOMEを全ユーザー共通の場所にし、Yarnとpnpmの版を準備して、pnpmの本体もビルドのときに取得しておきます。もとのyarn@stableは、その日の安定版になります。- PHPの行(
php8.5-cliなど)は変えていません。上の「動作確認した環境」のとおり、PHPのリポジトリには最新の版しかないためです。
この先で Dockerfile を変えたときは、公式ドキュメントのとおり sail build --no-cache でイメージを作り直します。
3. 起動する
-d をつけると、裏で起動します。初回はアプリのイメージのビルドがあるので時間がかかり、今回の環境では7分54秒でした。
$ time ./vendor/bin/sail up -d
Image example-app/app Pulling
Image mysql:9.7.4@sha256:df90258da46f6e7ff8574ff84f17618aba0765cac749928299c69fd4e7cb8ad8 Pulling
Image example-app/app pull access denied for example-app/app, repository does not exist or may require 'docker login'
(省略)
Image mysql:9.7.4@sha256:df90258da46f6e7ff8574ff84f17618aba0765cac749928299c69fd4e7cb8ad8 Pulled
Image example-app/app Building
(省略)
Image example-app/app Built
(省略)
Container example-app-mysql-1 Started
Container example-app-laravel.test-1 Starting
Container example-app-laravel.test-1 Started
real 7m54.328s
最初の pull access denied は、example-app/app という名前のイメージをDocker Hubから取得しようとして、見つからなかったという表示です。そのあとで Dockerfile からビルドされ(Building、Built)、起動しました。
コンテナが起動しても、MySQLの準備にはさらに時間がかかります。sail ps で、MySQLの状態が (healthy) になるまで待ちます。確認では、起動から30秒ほどで (healthy) になってから次に進みました。
$ ./vendor/bin/sail ps --format "table {{.Name}}\t{{.Status}}"
NAME STATUS
example-app-laravel.test-1 Up 30 seconds
example-app-mysql-1 Up 30 seconds (healthy)
$ ./vendor/bin/sail ps --format "table {{.Name}}\t{{.Image}}\t{{.Ports}}"
NAME IMAGE PORTS
example-app-laravel.test-1 example-app/app 0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:5173->5173/tcp, [::]:5173->5173/tcp
example-app-mysql-1 mysql:9.7.4@sha256:df90258da46f6e7ff8574ff84f17618aba0765cac749928299c69fd4e7cb8ad8 0.0.0.0:3306->3306/tcp, [::]:3306->3306/tcp, 33060/tcp
4. sail と打つだけで動かす
公式ドキュメントのエイリアスを設定すると、./vendor/bin/sail を sail と打てます。ずっと使うなら、~/.zshrc(Mac)や ~/.bashrc(WSL2のUbuntu)に書きます。
$ alias sail="sh \$([ -f sail ] && echo sail || echo vendor/bin/sail)"
$ sail artisan --version
Laravel Framework 13.40.0
ここでは、$(...) を打った時点ではなく使うたびに展開させるため、ダブルクォートの中で \$ と書いています。公式ドキュメントの書き方(シングルクォート)でも同じ意味です。
5. ブラウザで開く
ブラウザで http://localhost を開きます。確認では、ブラウザの代わりに curl を使いました。起動した直後は、500エラーになりました。
$ curl -s -o /dev/null -w "HTTP %{http_code}\n" http://localhost/
HTTP 500
$ grep -o "SQLSTATE\[42S02\][^(]*" storage/logs/laravel.log | head -1
SQLSTATE[42S02]: Base table or view not found: 1146 Table 'laravel.sessions' doesn't exist
.env の SESSION_DRIVER=database で、セッションをデータベースに保存する設定ですが、MySQLにはまだテーブルがありません。手順1の最後の案内のとおり、マイグレーションを実行すると開けました。
$ sail artisan migrate
INFO Preparing database.
Creating migration table ...................................... 16.00ms DONE
INFO Running migrations.
0001_01_01_000000_create_users_table .......................... 63.65ms DONE
0001_01_01_000001_create_cache_table .......................... 37.55ms DONE
0001_01_01_000002_create_jobs_table ........................... 64.78ms DONE
$ curl -s -o /dev/null -w "HTTP %{http_code}\n" http://localhost/
HTTP 200
6. PHP、Composer、npmを実行する
PHP、Composer、Node.js、npmは、PCではなくアプリのコンテナに入っています。先頭に sail をつけて実行します。Composer、Node.js、npm、pnpm、Yarn、Bunは、手順2で固定した版になっています(sail pnpm などは、sail ユーザーで実行されます)。パッケージを追加するときも、版を指定して入れます。
$ sail php --version
PHP 8.5.12 (cli) (built: Oct 21 2026 08:06:50) (NTS)
(省略)
$ sail composer --version
Composer version 2.11.1 2026-10-30 14:52:10
(省略)
$ sail node --version
v24.22.2
$ sail npm --version
12.2.2
$ sail pnpm --version
12.18.0
$ sail yarn --version
4.18.1
$ sail bun --version
1.4.4
$ sail composer require laravel/sanctum:4.3.3
(省略)
- Installing laravel/sanctum (v4.3.3): Extracting archive
(省略)
$ sail npm install
added 96 packages, and audited 103 packages in 8s
(省略)
$ sail npm run build
(省略)
✓ built in 386ms
7. データベースに接続する
接続の設定とMySQLの版は、sail artisan db:show で確かめられます。
$ sail artisan db:show
MySQL ................................................................ 9.7.4
Connection ........................................................... mysql
Database ........................................................... laravel
Host ................................................................. mysql
Port .................................................................. 3306
Username .............................................................. sail
(省略)
sail mysql で、.env のユーザーとデータベースでMySQLに入れます。ターミナルから実行すると対話の画面になり、exit で抜けます。確認は端末なしで実行したので、対話の代わりにSQLを標準入力で渡しました。testing は、Sailがテスト用に作るデータベースです。
$ echo "SHOW DATABASES;" | sail mysql
Database
information_schema
laravel
performance_schema
testing
なお、Sail v1.69.0のスクリプトでは、sail mysql は引数を使わずにMySQLのクライアントを起動します。sail mysql -e "SELECT 1;" の -e も使われません。確認(端末なし)では、何も表示されずに終わりました。ターミナルから実行した場合は、-e を無視して対話の画面に入ると考えられます(未確認)。SQLを1つだけ実行したいときは、上のように標準入力で渡します。
$ sail mysql -e "SELECT 1;"
$
PCのデータベースのツール(TablePlusなど)からは、127.0.0.1 の3306番に、.env の DB_USERNAME と DB_PASSWORD(初期値は sail と password)で接続します。
確認では、PCのツールの代わりに、Sailを動かしているLinuxの上で、同じMySQL 9.7.4のイメージのクライアントから接続しました。--network host は、この検証用のLinuxでは追加の設定なしで使えましたが、Docker Desktopでは4.34以降で、設定(Settings > Resources > Network の Enable host networking)を有効にした場合だけ使えます(Dockerの公式ドキュメント)。MacやWindowsでは、PCのツールで接続するほうが簡単です。
$ docker run --rm --network host mysql:9.7.4@sha256:df90258da46f6e7ff8574ff84f17618aba0765cac749928299c69fd4e7cb8ad8 mysql -h 127.0.0.1 -P 3306 -u sail -ppassword -e "SELECT DATABASE(), CURRENT_USER(), VERSION();" laravel
mysql: [Warning] Using a password on the command line interface can be insecure.
DATABASE() CURRENT_USER() VERSION()
laravel sail@% 9.7.4
MySQLをSailの初期の8.4から9.7.4に変えても、この記事の範囲(MySQLのヘルスチェック、testing データベースの作成、マイグレーション、sail mysql、外からの接続)では、違いは出ませんでした。
8. 止める
sail stop は、コンテナを止めるだけで消しません。sail ps には、動いているコンテナだけが出ます。
$ sail stop
Container example-app-laravel.test-1 Stopping
Container example-app-laravel.test-1 Stopped
Container example-app-mysql-1 Stopping
Container example-app-mysql-1 Stopped
$ sail ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
sail down はコンテナとネットワークを消し、sail down -v はMySQLのデータを入れたボリュームも消します。どちらの出力も、下の「ハマりやすい点」に載せています。
ハマりやすい点
80番ポートが使われていると起動できない
公式ドキュメントにも、Sailを起動する前に、ほかのWebサーバーやデータベースを止めておくようにとあります。ここでは、ほかのWebサーバーの代わりに、80番ポートを使うコンテナ(busybox のWebサーバー)を先に起動して確かめました。
$ docker run -d --name sail-port80 -p 80:80 busybox:1.38.0@sha256:a46257e06c82ad85242d0d38077d0a52d9896389ca60a1a59d3463db586e5fa4 httpd -f
(省略)
$ sail up -d
Container example-app-mysql-1 Starting
Container example-app-mysql-1 Started
Container example-app-laravel.test-1 Starting
(省略)
Error response from daemon: failed to set up container networking: driver failed programming external connectivity on endpoint example-app-laravel.test-1 (5c0aafb6da1420297deaf2fceeda0540a7c7ea92c5bb69180a47ee8364c801dd): Bind for 0.0.0.0:80 failed: port is already allocated
Sail v1.69.0の compose.yaml のひな形では、PCの側のポートを APP_PORT(アプリ、既定は80)、VITE_PORT(Vite、既定は5173)、FORWARD_DB_PORT(MySQL、既定は3306)で変えられます。.env に APP_PORT=8080 を足すと起動でき、応答を数秒待ってから http://localhost:8080 で開けました。
$ echo "APP_PORT=8080" >> .env
$ sail up -d
Container example-app-mysql-1 Running
Container example-app-laravel.test-1 Recreate
Container example-app-laravel.test-1 Recreated
Container example-app-laravel.test-1 Starting
Container example-app-laravel.test-1 Started
$ curl -s -o /dev/null -w "HTTP %{http_code}\n" http://localhost:8080/
HTTP 200
$ docker rm -f sail-port80
sail-port80
一度起動したあとに DB_PASSWORD を変えると、接続できなくなる
.env の DB_PASSWORD を変えてから起動し直すと、MySQLに接続できなくなりました。ここでは sed で書き換えていますが、エディタで書き換えても同じです(Macの sed の書き方は、手順2のとおりです)。
$ sail down
(省略)
Network example-app_sail Removed
$ sed -i "s/^DB_PASSWORD=.*/DB_PASSWORD=newpassword/" .env
$ sail up -d
(省略)
$ sail ps --format "table {{.Name}}\t{{.Status}}"
NAME STATUS
example-app-laravel.test-1 Up 30 seconds
example-app-mysql-1 Up 30 seconds (healthy)
$ sail artisan migrate:status 2>&1 | grep -o "SQLSTATE\[HY000\] \[1045\][^(]*"
SQLSTATE[HY000] [1045] Access denied for user 'sail'@'172.19.0.3'
MySQLのユーザーとパスワードは、ボリュームが空の状態で初めて起動したときに作られます。Docker公式のMySQLのイメージの説明にも、データが入っている場合は環境変数が効かないとあります。sail down ではボリュームが残るので、古いパスワードのままでした。
sail down -v でボリュームを消して起動し直すと、新しいパスワードで接続できました。ボリュームを消すと、データベースの中身はすべて消えます。テーブルも空になるので、マイグレーションをやり直します。
$ sail down -v
(省略)
Volume example-app_sail-mysql Removed
Network example-app_sail Removed
$ sail up -d
(省略)
$ sail ps --format "table {{.Name}}\t{{.Status}}"
NAME STATUS
example-app-laravel.test-1 Up 30 seconds
example-app-mysql-1 Up 30 seconds (healthy)
$ sail artisan migrate:status
ERROR Migration table not found.
$ sail artisan migrate
(省略)
0001_01_01_000002_create_jobs_table ........................... 65.04ms DONE
データを残したいときは、ボリュームを消さずに、MySQLの中でユーザーのパスワードを変える方法もあります。この方法は確認していません。
参考
- Laravel Sail – Laravel 13.x
- laravel/sail v1.69.0(GitHub)
- composer – Official Image | Docker Hub
- mysql – Official Image | Docker Hub
- ubuntu – Official Image | Docker Hub
- Docker Desktop WSL 2 backend on Windows | Docker Docs
- Host network driver | Docker Docs
- Working across file systems | Microsoft Learn

コメント