概要

Laravel Sail のドキュメントを見ると、php コマンドと composer コマンドが導入されていることが前提で説明されています。

ですが、私のローカルPCの環境には Laravel が動作するために必要な以下のコマンド群を導入してません。

php
composer
laravel/installer
node / npm / npx
yarn

ということで、本記事ではこれらのコマンドをインストールせずに Laravel Sail を動かしてみようと思います。

動作検証環境

Ubuntu: 22.04

$ grep PRETTY_NAME /etc/os-release 
PRETTY_NAME="Ubuntu 22.04.5 LTS"

Docker: 29.2.0

$ docker --version
Docker version 29.2.0, build 0b9d198

Laravel のインストール方法について

Laravel のアプリケーションを作成する場合、 laravel new example-app のようなコマンドを実行しますが、前述のとおり laravel コマンドがインストールされていません。
なので composer create-project laravel/laravel example-app を実行したいわけですが、 composer コマンドもインストールされていません。

そこで、今回は Composer の Docker Official Imageを利用します。

Laravel のアプリケーションを作成する際、前述のとおり以前であれば以下のようなコマンドを実行していました。

$ composer create-project laravel/laravel example-app

しかし、公式のインストールガイドでは、こちらの手順のみが掲載されています。

$ composer global require laravel/installer
$ laravel new example-app

laravel new example-app が何を行っているのかを追っていくと、結局は composer create-project laravel/laravel example-app だとわかります。

なので、以下のように Composer の Docker イメージを利用して実行することもできます。

$ docker container run \
--rm \
-u $(id -u):$(id -g) \
-v $(pwd):/app \
-it composer:latest \
composer create-project laravel/laravel my-laravel-sail

今回は、以下のように Composer の Docker コンテナ内で laravel/installer をインストールして laravel コマンドを実行してみます。

$ docker container run \
--rm \
-u $(id -u):$(id -g) \
-v $(pwd):/app \
-it composer:latest \
sh -c "composer global require laravel/installer \
&& export PATH=\$PATH:/tmp/vendor/bin \
&& laravel new my-laravel-sail"

/tmp/vendor/bin に対してパスを通している理由は、 Composer の Docker イメージで COMPOSER_HOME が /tmp になっているためです。
これにより /tmp/vendor/bin/laravel ではなく laravel で実行可能となります。

Laravel のインストール

それでは先程紹介した Laravel のインストールコマンドを参考にしつつ、 node と npm コマンドも利用可能な形で実行します。

$ cd /PATH_TO/作業ディレクトリ
$ docker container run \
--rm \
-v $(pwd):/app \
-it composer:latest \
sh -c "
apk add --no-cache nodejs npm \
&& composer global require laravel/installer \
&& export PATH=\$PATH:/tmp/vendor/bin \
&& laravel new my-laravel-sail \
&& chown -R $(id -u):$(id -g) my-laravel-sail
"

まず、 starter kit の選択肢が表示されますので、今回は None を選択します。

(1/7) Installing ada-libs (3.3.0-r0)
(2/7) Installing icu-data-en (76.1-r1)
  Executing icu-data-en-76.1-r1.post-install
  * 
  * If you need ICU with non-English locales and legacy charset support, install
  * package icu-data-full.
  * 
(3/7) Installing icu-libs (76.1-r1)
(4/7) Installing simdjson (3.12.0-r0)
(5/7) Installing simdutf (7.5.0-r1)
(6/7) Installing nodejs (24.13.0-r1)
(7/7) Installing npm (11.6.3-r0)
Executing busybox-1.37.0-r30.trigger
OK: 169.3 MiB in 93 packages
Changed current directory to /tmp
./composer.json has been created
Running composer update laravel/installer
Loading composer repositories with package information
Updating dependencies
Lock file operations: 32 installs, 0 updates, 0 removals
  - Locking carbonphp/carbon-doctrine-types (3.2.0)
  - Locking doctrine/inflector (2.1.0)
  - Locking illuminate/collections (v12.52.0)
・
・
省略
・
・
  - Installing symfony/finder (v7.4.5): Extracting archive
  - Installing illuminate/filesystem (v12.52.0): Extracting archive
  - Installing laravel/installer (v5.24.6): Extracting archive
22 package suggestions were added by new dependencies, use `composer suggest` to see details.
Generating autoload files
20 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
No security vulnerability advisories found.
Using version ^5.24 for laravel/installer

 ██╗       █████╗  ██████╗   █████╗  ██╗   ██╗ ███████╗ ██╗
 ██║      ██╔══██╗ ██╔══██╗ ██╔══██╗ ██║   ██║ ██╔════╝ ██║
 ██║      ███████║ ██████╔╝ ███████║ ██║   ██║ █████╗   ██║
 ██║      ██╔══██║ ██╔══██╗ ██╔══██║ ╚██╗ ██╔╝ ██╔══╝   ██║
 ███████╗ ██║  ██║ ██║  ██║ ██║  ██║  ╚████╔╝  ███████╗ ███████╗
 ╚══════╝ ╚═╝  ╚═╝ ╚═╝  ╚═╝ ╚═╝  ╚═╝   ╚═══╝   ╚══════╝ ╚══════╝

 ┌ Which starter kit would you like to install? ────────────────┐
 │ › ● None                                                     │
 │   ○ React                                                    │
 │   ○ Svelte                                                   │
 │   ○ Vue                                                      │
 │   ○ Livewire                                                 │
 └──────────────────────────────────────────────────────────────┘

testing framework の選択肢が表示されますので、今回は PHPUnit を選択します。

 ┌ Which starter kit would you like to install? ────────────────┐
 │ None                                                         │
 └──────────────────────────────────────────────────────────────┘

 ┌ Which testing framework do you prefer? ──────────────────────┐
 │   ○ Pest                                                     │
 │ › ● PHPUnit                                                  │
 └──────────────────────────────────────────────────────────────┘

AIアシスタントである Laravel Boost のインストールが必要か求められますので、今回は No を選択します。

 ┌ Which starter kit would you like to install? ────────────────┐
 │ None                                                         │
 └──────────────────────────────────────────────────────────────┘

 ┌ Which testing framework do you prefer? ──────────────────────┐
 │ PHPUnit                                                      │
 └──────────────────────────────────────────────────────────────┘

 ┌ Do you want to install Laravel Boost to improve AI assisted coding? ┐
 │ ○ Yes / ● No                                                        │
 └─────────────────────────────────────────────────────────────────────┘

データベースの選択肢が表示されますので、今回は SQLite を選択します。

 ┌ Which starter kit would you like to install? ────────────────┐
 │ None                                                         │
 └──────────────────────────────────────────────────────────────┘

 ┌ Which testing framework do you prefer? ──────────────────────┐
 │ PHPUnit                                                      │
 └──────────────────────────────────────────────────────────────┘

 ┌ Do you want to install Laravel Boost to improve AI assisted coding? ┐
 │ No                                                                  │
 └─────────────────────────────────────────────────────────────────────┘

Creating a "laravel/laravel" project at "./my-laravel-sail"
Installing laravel/laravel (v12.11.2)
  - Downloading laravel/laravel (v12.11.2)
  - Installing laravel/laravel (v12.11.2): Extracting archive
Created project in /app/my-laravel-sail
Loading composer repositories with package information
Updating dependencies
Lock file operations: 111 installs, 0 updates, 0 removals
  - Locking brick/math (0.14.8)
  - Locking carbonphp/carbon-doctrine-types (3.2.0)
  - Locking dflydev/dot-access-data (v3.0.3)
・
・
省略
・
・
  - Installing phar-io/manifest (2.0.4): Extracting archive
  - Installing myclabs/deep-copy (1.13.4): Extracting archive
  - Installing phpunit/phpunit (11.5.55): Extracting archive
70 package suggestions were added by new dependencies, use `composer suggest` to see details.
Generating optimized autoload files
81 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
No security vulnerability advisories found.
> @php -r "file_exists('.env') || copy('.env.example', '.env');"

   INFO  Application key set successfully.  

 ┌ Which database will your application use? ───────────────────┐
 │ › ● SQLite                                                   │
 │   ○ MySQL (Missing PDO extension)                            │
 │   ○ MariaDB (Missing PDO extension)                          │
 │   ○ PostgreSQL (Missing PDO extension)                       │
 │   ○ SQL Server (Missing PDO extension)                       │
 └──────────────────────────────────────────────────────────────┘

npm install と npm run build の実行を求められますので、今回は Yes を選択します。

 ┌ Which database will your application use? ───────────────────┐
 │ SQLite                                                       │
 └──────────────────────────────────────────────────────────────┘


   INFO  Preparing database.  

  Creating migration table ...................................... 28.19ms DONE

   INFO  Running migrations.  

  0001_01_01_000000_create_users_table ......................... 106.30ms DONE
  0001_01_01_000001_create_cache_table .......................... 67.00ms DONE
  0001_01_01_000002_create_jobs_table ........................... 91.32ms DONE

 ┌ Would you like to run npm install and npm run build? ────────┐
 │ ● Yes / ○ No                                                 │
 └──────────────────────────────────────────────────────────────┘

以上で Laravel のインストール作業は完了となります。

 ┌ Would you like to run npm install and npm run build? ────────┐
 │ Yes                                                          │
 └──────────────────────────────────────────────────────────────┘


added 82 packages, and audited 83 packages in 10s

21 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities

> build
> vite build

vite v7.3.1 building client environment for production...
✓ 53 modules transformed.
public/build/manifest.json             0.33 kB │ gzip:  0.16 kB
public/build/assets/app-Cg9bk4C0.css  34.04 kB │ gzip:  8.47 kB
public/build/assets/app-CKl8NZMC.js   36.69 kB │ gzip: 14.71 kB
✓ built in 443ms
   INFO  Application ready in [my-laravel-sail]. You can start your local development using:

➜ cd my-laravel-sail
➜ composer run dev

  New to Laravel? Check out our documentation. Build something amazing!

実行ユーザーと作成された Laravel のアプリケーションのディレクトリの所有者が一致していることを確認します。

$ echo $USER
akase244
$ ls -ld my-laravel-sail/
drwxr-xr-x 13 akase244 akase244 4096  2月 23 13:35 my-laravel-sail/

Laravel アプリケーションのディレクトリ内に以下のようなファイル群が作成されました。

$ cd my-laravel-sail
$ ls -la
合計 492
drwxr-xr-x  13 akase244 akase244   4096  2月 23 13:35 .
drwxrwxr-x 121 akase244 akase244   4096  2月 23 13:31 ..
-rw-r--r--   1 akase244 akase244    252  1月 20 02:57 .editorconfig
-rw-r--r--   1 akase244 akase244   1142  2月 23 13:33 .env
-rw-r--r--   1 akase244 akase244   1086  2月 23 13:33 .env.example
-rw-r--r--   1 akase244 akase244    186  1月 20 02:57 .gitattributes
-rw-r--r--   1 akase244 akase244    283  1月 20 02:57 .gitignore
-rw-r--r--   1 akase244 akase244   3911  1月 20 02:57 README.md
drwxr-xr-x   5 akase244 akase244   4096  1月 20 02:57 app
-rwxr-xr-x   1 akase244 akase244    425  1月 20 02:57 artisan
drwxr-xr-x   3 akase244 akase244   4096  1月 20 02:57 bootstrap
-rw-r--r--   1 akase244 akase244   2869  2月 23 13:33 composer.json
-rw-r--r--   1 akase244 akase244 309333  2月 23 13:31 composer.lock
drwxr-xr-x   2 akase244 akase244   4096  1月 20 02:57 config
drwxr-xr-x   5 akase244 akase244   4096  2月 23 13:33 database
drwxr-xr-x  77 akase244 akase244   4096  2月 23 13:35 node_modules
-rw-r--r--   1 akase244 akase244  93952  2月 23 13:35 package-lock.json
-rw-r--r--   1 akase244 akase244    414  1月 20 02:57 package.json
-rw-r--r--   1 akase244 akase244   1284  1月 20 02:57 phpunit.xml
drwxr-xr-x   3 akase244 akase244   4096  2月 23 13:35 public
drwxr-xr-x   5 akase244 akase244   4096  1月 20 02:57 resources
drwxr-xr-x   2 akase244 akase244   4096  1月 20 02:57 routes
drwxr-xr-x   5 akase244 akase244   4096  1月 20 02:57 storage
drwxr-xr-x   4 akase244 akase244   4096  1月 20 02:57 tests
drwxr-xr-x  39 akase244 akase244   4096  2月 23 13:32 vendor
-rw-r--r--   1 akase244 akase244    436  1月 20 02:57 vite.config.js

node_modules ディレクトリ内に以下のように npm のパッケージがインストールされていることを確認します。

$ ls -la node_modules/
合計 360
drwxr-xr-x 77 akase244 akase244  4096  2月 23 13:35 .
drwxr-xr-x 13 akase244 akase244  4096  2月 23 13:35 ..
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 .bin
-rw-r--r--  1 akase244 akase244 50085  2月 23 13:35 .package-lock.json
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 .vite-temp
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 @esbuild
drwxr-xr-x  7 akase244 akase244  4096  2月 23 13:35 @jridgewell
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 @rollup
drwxr-xr-x  6 akase244 akase244  4096  2月 23 13:35 @tailwindcss
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 @types
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 ansi-regex
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 ansi-styles
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 asynckit
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 axios
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 call-bind-apply-helpers
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 chalk
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 cliui
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 color-convert
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 color-name
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 combined-stream
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 concurrently
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 delayed-stream
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 detect-libc
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 dunder-proto
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 emoji-regex
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 enhanced-resolve
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 es-define-property
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 es-errors
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 es-object-atoms
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 es-set-tostringtag
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 esbuild
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 escalade
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 fdir
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 follow-redirects
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 form-data
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 function-bind
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 get-caller-file
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 get-intrinsic
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 get-proto
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 gopd
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 graceful-fs
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 has-flag
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 has-symbols
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 has-tostringtag
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 hasown
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 is-fullwidth-code-point
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 jiti
drwxr-xr-x  5 akase244 akase244  4096  2月 23 13:35 laravel-vite-plugin
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 lightningcss
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 lightningcss-linux-x64-musl
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 magic-string
drwxr-xr-x  5 akase244 akase244  4096  2月 23 13:35 math-intrinsics
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 mime-db
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 mime-types
drwxr-xr-x  6 akase244 akase244  4096  2月 23 13:35 nanoid
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 picocolors
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 picomatch
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 postcss
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 proxy-from-env
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 require-directory
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 rollup
drwxr-xr-x  9 akase244 akase244  4096  2月 23 13:35 rxjs
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 shell-quote
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 source-map-js
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 string-width
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 strip-ansi
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 supports-color
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 tailwindcss
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 tapable
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 tinyglobby
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 tree-kill
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 tslib
drwxr-xr-x  6 akase244 akase244  4096  2月 23 13:35 vite
drwxr-xr-x  4 akase244 akase244  4096  2月 23 13:35 vite-plugin-full-reload
drwxr-xr-x  2 akase244 akase244  4096  2月 23 13:35 wrap-ansi
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 y18n
drwxr-xr-x  6 akase244 akase244  4096  2月 23 13:35 yargs
drwxr-xr-x  3 akase244 akase244  4096  2月 23 13:35 yargs-parser

それでは公式のインストールガイドに従って、 composer run dev を実行して Laravel のアプリケーションを起動してみます。

Laravel のアプリケーションを composer run dev のように実行すると 127.0.0.1:8000 でポートを開放するため、コンテナ環境で実行するとローカルPCからアクセスできません。
これに対応するため、以下のように composer.json の php artisan serve に --host と --port のオプションを追加します。
※これによりローカル環境で直接 composer run dev を実行すると 0.0.0.0:8000 で開放することになるので、取り扱いにはご注意ください。

$ cp composer.json composer.json.orig.$(date +'%Y%m%d%H%M%S')
$ vim composer.json
$ diff composer.json composer.json.orig.20260223152708 
48c48
<             "npx concurrently -c \"#93c5fd,#c4b5fd,#fb7185,#fdba74\" \"php artisan serve --host=0.0.0.0 --port=8000\" \"php artisan queue:listen --tries=1 --timeout=0\" \"php artisan pail --timeout=0\" \"npm run dev\" --names=server,queue,logs,vite --kill-others"
---
>             "npx concurrently -c \"#93c5fd,#c4b5fd,#fb7185,#fdba74\" \"php artisan serve\" \"php artisan queue:listen --tries=1 --timeout=0\" \"php artisan pail --timeout=0\" \"npm run dev\" --names=server,queue,logs,vite --kill-others"

同様に、 Vite が 127.0.0.1:5173 でポートを開放するため、コンテナ環境で実行するとローカルPCからアクセスできません。

これに対応するため、以下のように vite.config.js の export default defineConfig 内の server に以下の指定を追加します。
※これによりローカル環境で直接 composer run dev を実行すると 0.0.0.0:5173 で開放することになるので、取り扱いにはご注意ください。

$ cp vite.config.js vite.config.js.orig.$(date +'%Y%m%d%H%M%S')
$ vim vite.config.js
$ diff vite.config.js vite.config.js.orig.20260223152840 
14,19d13
<         host: '0.0.0.0',
<         port: 5173,
<         strictPort: true,
<         hmr: {
<             host: 'localhost',
<         },

起動時に実行される php artisan pail により pcntl が必要となりますので、 Composer の Docker イメージではなく、 PHP の Docker Official Image を利用します。

$ docker container run \
--rm \
-v $(pwd):/app \
-w /app \
-p 127.0.0.1:8000:8000 \
-p 127.0.0.1:5173:5173 \
-it php:8.5-cli-alpine \
sh -c "
apk add --no-cache nodejs npm \
&& docker-php-ext-install pcntl \
&& curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer \
&& composer run dev
"

Laravel アプリケーションの起動の処理に成功すると、以下のようなログが表示されます。

・
・
省略
・
・
> npx concurrently -c "#93c5fd,#c4b5fd,#fb7185,#fdba74" "php artisan serve --host=0.0.0.0 --port=8000" "php artisan queue:listen --tries=1 --timeout=0" "php artisan pail --timeout=0" "npm run dev" --names=server,queue,logs,vite --kill-others
[queue] 
[queue]    INFO  Processing jobs from the [default] queue.  
[queue] 
[vite] 
[vite] > dev
[vite] > vite
[vite] 
[logs] 
[logs]    INFO  Tailing application logs.                        Press Ctrl+C to exit  
[logs]                                                Use -v|-vv to show more details  
[vite] 
[vite]   VITE v7.3.1  ready in 394 ms
[vite] 
[vite]   ➜  Local:   http://localhost:5173/
[vite]   ➜  Network: http://172.17.0.2:5173/
[server] 
[server]    INFO  Server running on [http://0.0.0.0:8000].  
[server] 
[server]   Press Ctrl+C to stop the server
[server] 
[vite] 
[vite]   LARAVEL v12.52.0  plugin v2.1.0
[vite] 
[vite]   ➜  APP_URL: http://localhost:8000

ローカル環境で意図通りにポート番号が開放されていることを確認します。

$ ss -lnpt |grep -E '(:8000|:5173)'
LISTEN 0      4096            127.0.0.1:8000       0.0.0.0:*                           
LISTEN 0      4096            127.0.0.1:5173       0.0.0.0:*

ブラウザで http://localhost:8000 にアクセスすると Laravel のデフォルト画面が表示されます。

同様にブラウザで http://localhost:5173/ にアクセスすると Vite のデフォルト画面が表示されます。

Laravel Sail のインストール

Laravel Sail のドキュメントに従って、先程作成した Laravel アプリケーションに対して composer require laravel/sail --dev を実行して、 Laravel Sail をインストールします。

$ cd /PATH_TO/my-laravel-sail
$ docker container run \
--rm \
-u $(id -u):$(id -g) \
-v $(pwd):/app \
-it composer:latest \
composer require laravel/sail --dev

Laravel Sail のインストール工程が進むと、以下のようなメッセージが表示されて完了します。

・
・
省略
・
・
   INFO  Discovering packages.  

  laravel/pail ............................................................. DONE
  laravel/sail ............................................................. DONE
  laravel/tinker ........................................................... DONE
  nesbot/carbon ............................................................ DONE
  nunomaduro/collision ..................................................... DONE
  nunomaduro/termwind ...................................................... DONE

81 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
> @php artisan vendor:publish --tag=laravel-assets --ansi --force

   INFO  No publishable resources for tag [laravel-assets].  

No security vulnerability advisories found.
Using version ^1.53 for laravel/sail

.env のバックアップを取得します。

$ cp .env .env.orig.$(date +'%Y%m%d%H%M%S')
$ ls -l .env.orig.20260223153140 
-rw-r--r-- 1 akase244 akase244 1142  2月 23 15:31 .env.orig.20260223153140

次に php artisan sail:install を実行して、 compose.yaml の作成や .env の更新を行います。

$ docker container run \
--rm \
-u $(id -u):$(id -g) \
-v $(pwd):/app \
-it composer:latest \
php artisan sail:install

データベースの選択肢が表示されるので mysql を選択します。
※なぜ SQLite の選択肢が無いのか。。。

 ┌ Which services would you like to install? ───────────────────┐
 │ › ◼ mysql                                                  ┃ │
 │   ◻ pgsql                                                  │ │
 │   ◻ mariadb                                                │ │
 │   ◻ mongodb                                                │ │
 │   ◻ redis                                                  │ │
 └────────────────────────────────────────────────── 1 selected ┘
  Use the space bar to select options.

以下のように表示されたら php artisan sail:install の実行は完了です。

 ┌ Which services would you like to install? ───────────────────┐
 │ mysql                                                        │
 └──────────────────────────────────────────────────────────────┘



   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

php artisan sail:install の実行により .env が更新されているはずなので差分を確認すると、データベースの接続先が SQLite から MySQL に変更されています。

$ diff .env .env.orig.20260223153140 
14c14
< PHP_CLI_SERVER_WORKERS=4
---
> # PHP_CLI_SERVER_WORKERS=4
23,28c23,28
< DB_CONNECTION=mysql
< DB_HOST=mysql
< DB_PORT=3306
< DB_DATABASE=laravel
< DB_USERNAME=sail
< DB_PASSWORD=password
---
> DB_CONNECTION=sqlite
> # DB_HOST=127.0.0.1
> # DB_PORT=3306
> # DB_DATABASE=laravel
> # DB_USERNAME=root
> # DB_PASSWORD=

作成された compose.yaml を参照すると ports に以下のような指定があります。

$ cat compose.yaml 
services:
    laravel.test:
        ・
        ・
        ports:
            - '${APP_PORT:-80}:80'
            - '${VITE_PORT:-5173}:${VITE_PORT:-5173}'
        ・
        ・
    mysql:
        image: 'mysql:8.4'
        ports:
            - '${FORWARD_DB_PORT:-3306}:3306'
        ・
        ・

compose.yaml のバックアップファイルを作成して、以下のように修正します。

$ cp compose.yaml compose.yaml.orig.$(date +'%Y%m%d%H%M%S')
$ vim compose.yaml
$ diff compose.yaml compose.yaml.orig.20260223155130 
12,13c12,13
<             - '127.0.0.1:${APP_PORT:-80}:80'
<             - '127.0.0.1:${VITE_PORT:-5173}:${VITE_PORT:-5173}'
---
>             - '${APP_PORT:-80}:80'
>             - '${VITE_PORT:-5173}:${VITE_PORT:-5173}'
29c29
<             - '127.0.0.1:${FORWARD_DB_PORT:-3306}:3306'
---
>             - '${FORWARD_DB_PORT:-3306}:3306'

Laravel Sail を起動します。

$ ./vendor/bin/sail up

ローカル環境で意図通りにポート番号が開放されていることを確認します。

$ ss -lnpt |grep -E '(:80|:5173|:3306)'
LISTEN 0      4096            127.0.0.1:3306       0.0.0.0:*                           
LISTEN 0      4096            127.0.0.1:80         0.0.0.0:*                           
LISTEN 0      4096            127.0.0.1:5173       0.0.0.0:*

Laravel Sail を起動した状態でデータベースのマイグレーションを実行してみると、すべて適用済みのようです。

$ ./vendor/bin/sail artisan migrate

   INFO  Nothing to migrate.

マイグレーションのファイルを確認します。全部で3ファイル存在するようです。

$ ls -l database/migrations/
合計 12
-rw-r--r-- 1 akase244 akase244 1473  1月 20 02:57 0001_01_01_000000_create_users_table.php
-rw-r--r-- 1 akase244 akase244  867  1月 20 02:57 0001_01_01_000001_create_cache_table.php
-rw-r--r-- 1 akase244 akase244 1812  1月 20 02:57 0001_01_01_000002_create_jobs_table.php

マイグレーションが本当に適用済みなのかを Docker コンテナ内に直接入って調べるため、データベースの接続情報を確認します。

$ grep DB_ .env
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=password

起動中の MySQL の Docker コンテナのIDを調べます。

$ docker container ls |grep mysql
d18b30780d8d   mysql:8.4      "docker-entrypoint.s…"   16 minutes ago   Up 10 minutes (healthy)   127.0.0.1:3306->3306/tcp, 33060/tcp              my-laravel-sail-mysql-1

Docker コンテナに入ります。

$ docker exec -it d18b30780d8d bash
bash-5.1#

事前に調べておいた接続情報で MySQL に接続します。

bash-5.1# mysql -u sail -p laravel
Enter password: 
・
・
省略
・
・
mysql>

laravel データベースのテーブル一覧を確認すると、 MySQL 内に正常に作成されていることがわかります。

mysql> show tables;
+-----------------------+
| Tables_in_laravel     |
+-----------------------+
| cache                 |
| cache_locks           |
| failed_jobs           |
| job_batches           |
| jobs                  |
| migrations            |
| password_reset_tokens |
| sessions              |
| users                 |
+-----------------------+
9 rows in set (0.00 sec)

migrations を参照して、マイグレーションの実行状況を確認してみると、 batch 列の値が 1 になっているので、すべて実行済みのようです。

mysql> select * from migrations;
+----+--------------------------------------+-------+
| id | migration                            | batch |
+----+--------------------------------------+-------+
|  1 | 0001_01_01_000000_create_users_table |     1 |
|  2 | 0001_01_01_000001_create_cache_table |     1 |
|  3 | 0001_01_01_000002_create_jobs_table  |     1 |
+----+--------------------------------------+-------+
3 rows in set (0.00 sec)

ブラウザで http://localhost にアクセスすると Laravel のデフォルト画面が表示されます。
※Laravel Sail ではポート番号が80に変更になっているため、「:8000」の指定は不要です。

Sail-SSL のインストール

Sail-SSL を利用することでHTTPS接続が簡単に行えますので、これを導入します。

Laravel Sail を起動します。

$ cd /PATH_TO/my-laravel-sail
$ ./vendor/bin/sail up -d

sail composer コマンドで ryoluo/sail-ssl を導入します。

$ ./vendor/bin/sail composer require ryoluo/sail-ssl --dev

以下のように表示されれば導入完了です。

・
・
省略
・
・
   INFO  Discovering packages.  

  laravel/pail ......................................................... DONE
  laravel/sail ......................................................... DONE
  laravel/tinker ....................................................... DONE
  nesbot/carbon ........................................................ DONE
  nunomaduro/collision ................................................. DONE
  nunomaduro/termwind .................................................. DONE
  ryoluo/sail-ssl ...................................................... DONE

81 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
> @php artisan vendor:publish --tag=laravel-assets --ansi --force

   INFO  No publishable resources for tag [laravel-assets].  

No security vulnerability advisories found.
Using version ^1.4 for ryoluo/sail-ssl

compose.yaml のバックアップを取得します。

$ cp compose.yaml compose.yaml.orig.$(date +'%Y%m%d%H%M%S')
$ ls -l compose.yaml.orig.20260223165024 
-rw-r--r-- 1 akase244 akase244 1780  2月 23 16:50 compose.yaml.orig.20260223165024

sail artisan コマンドで sail-ssl:install を実行すると、 docker-compose.yml が存在しないため処理が終了してしまいました。

$ ./vendor/bin/sail artisan sail-ssl:install

   ErrorException 

  file_get_contents(/var/www/html/docker-compose.yml): Failed to open stream: No such file or directory

  at vendor/ryoluo/sail-ssl/src/Console/InstallCommand.php:29
     25▕      * @return void
     26▕      */
     27▕     public function handle()
     28▕     {
  ➜  29▕         $dockerCompose = file_get_contents($this->laravel->basePath('docker-compose.yml'));
     30▕         if (str_contains($dockerCompose, 'nginx:')) {
     31▕             $this->info('Nginx container is already installed. Do nothing.');
     32▕             return;
     33▕         }

      +14 vendor frames 

  15  artisan:16
      Illuminate\Foundation\Application::handleCommand()

Laravel Sail では docker-compose.yml ではなく compose.yaml を作成する構成になっています。
なので、 Sail-SSL が現状の構成に追いついてない部分があるようです。

以下を参照する限り、うまいこと動くような気がしなくもないですが。。。

仕方がないので、 compose.yaml を docker-compose.yml にコピーして再度 sail-ssl:install を実行してみます。
実行時のメッセージでは my-laravel-sail ディレクトリ配下の compose.yaml を利用しているように見えます。

$ cp compose.yaml docker-compose.yml
$ ./vendor/bin/sail artisan sail-ssl:install
WARN[0000] Found multiple config files with supported names: /home/akase244/repos/my-laravel-sail/compose.yaml, /home/akase244/repos/my-laravel-sail/docker-compose.yml 
WARN[0000] Using /home/akase244/repos/my-laravel-sail/compose.yaml 
WARN[0000] Found multiple config files with supported names: /home/akase244/repos/my-laravel-sail/compose.yaml, /home/akase244/repos/my-laravel-sail/docker-compose.yml 
WARN[0000] Using /home/akase244/repos/my-laravel-sail/compose.yaml 
WARN[0000] Found multiple config files with supported names: /home/akase244/repos/my-laravel-sail/compose.yaml, /home/akase244/repos/my-laravel-sail/docker-compose.yml 
WARN[0000] Using /home/akase244/repos/my-laravel-sail/compose.yaml 
Nginx container successfully installed in Docker Compose.

事前に取得してた compose.yaml のバックアップと比較してみると、差分は発生していません。

$ diff compose.yaml compose.yaml.orig.20260223165024
(何も表示されない)

どうやら、 docker-compose.yml の方に Nginx の設定が追加されているようです。

$ diff docker-compose.yml compose.yaml.orig.20260223165024
2,20d1
<     nginx:
<         image: 'nginx:latest'
<         ports:
<             - '${HTTP_PORT:-8000}:80'
<             - '${SSL_PORT:-443}:443'
<         environment:
<             - SSL_PORT=${SSL_PORT:-443}
<             - APP_SERVICE=${APP_SERVICE:-laravel.test}
<             - SERVER_NAME=${SERVER_NAME:-localhost}
<             - SSL_DOMAIN=${SSL_DOMAIN:-localhost}
<             - SSL_ALT_NAME=${SSL_ALT_NAME:-DNS:localhost}
<         volumes:
<             - 'sail-nginx:/etc/nginx/certs'
<             - './vendor/ryoluo/sail-ssl/nginx/templates:/etc/nginx/templates'
<             - './vendor/ryoluo/sail-ssl/nginx/generate-ssl-cert.sh:/docker-entrypoint.d/99-generate-ssl-cert.sh'
<         depends_on:
<             - ${APP_SERVICE:-laravel.test}
<         networks:
<             - sail
74,75d54
<     sail-nginx:
<         driver: local

なので、 docker-compose.yml の内容を compose.yaml に反映します。

$ cp docker-compose.yml compose.yaml

Nginx が 0.0.0.0 で起動するようになっているので修正します。

$ cp compose.yaml compose.yaml.orig.$(date +'%Y%m%d%H%M%S')
$ vim compose.yaml
$ diff compose.yaml compose.yaml.orig.20260223171425 
5,6c5,6
<             - '127.0.0.1:${HTTP_PORT:-8000}:80'
<             - '127.0.0.1:${SSL_PORT:-443}:443'
---
>             - '${HTTP_PORT:-8000}:80'
>             - '${SSL_PORT:-443}:443'

Sail-SSL のドキュメントに従って、 Laravel Sail を停止して、起動します。

$ ./vendor/bin/sail down
$ ./vendor/bin/sail up

ブラウザで http://localhost にアクセスすると Laravel のデフォルト画面が表示されます。

ブラウザで https://localhost にアクセスすると証明書の警告が表示されます。

「詳細設定」から「localhost にアクセスする（安全ではありません）」をクリックします。

HTTPS接続で Laravel のデフォルト画面が表示されます。

Sail-SSL のドキュメントに従って、 Nginx のコンテナからルート証明書を取り出そうとすると失敗しました。

$ ./vendor/bin/sail cp nginx:/etc/nginx/certs/root-ca.crt .
WARN[0000] Found multiple config files with supported names: /home/akase244/repos/my-laravel-sail/compose.yaml, /home/akase244/repos/my-laravel-sail/docker-compose.yml 
WARN[0000] Using /home/akase244/repos/my-laravel-sail/compose.yaml 
WARN[0000] Found multiple config files with supported names: /home/akase244/repos/my-laravel-sail/compose.yaml, /home/akase244/repos/my-laravel-sail/docker-compose.yml 
WARN[0000] Using /home/akase244/repos/my-laravel-sail/compose.yaml 
[+] copy 0/1
 ⠋ my-laravel-sail-nginx-1 Copying my-laravel-sail-nginx-1:/etc/nginx/certs/root-ca.crt to .                                               0.0s
Error response from daemon: Could not find the file /etc/nginx/certs/root-ca.crt in container b4ea155c739d415c8bd220f55110d55350c9485c80684f18d01cf453b018b9de

起動中の Nginx の Docker コンテナのIDを調べます。

$  docker container ls |grep nginx
b4ea155c739d   nginx:latest   "/docker-entrypoint.…"   8 minutes ago    Up 8 minutes             127.0.0.1:443->443/tcp, 127.0.0.1:8000->80/tcp   my-laravel-sail-nginx-1

Docker コンテナに入ります。

$ docker exec -it b4ea155c739d bash
root@b4ea155c739d:/#

/etc/nginx/certs/ 配下にはサーバー証明書しかなさそうです。

root@b4ea155c739d:/# ls -l /etc/nginx/certs/
total 8
-rw------- 1 root root 1704 Feb 23 08:11 server.key
-rw-r--r-- 1 root root 1143 Feb 23 08:11 server.pem

Sail-SSL のソースコードを参照するとたしかに root-ca.crt で作成されてそうに見えるんですが。。。

後処理で削除されていませんし、通常であれば root-ca.crt を取り出す形が正しいかと思います。

server.pem がルート証明書としても利用可能なサーバー証明書なのか確認してみたところ、「CA:TRUE」となっているため、これは「CA証明書（ルート証明書）」兼「サーバー証明書」の形で発行されているようです。

root@b4ea155c739d:/# openssl x509 -in /etc/nginx/certs/server.pem -noout -text | grep -A 1 "Basic Constraints"
            X509v3 Basic Constraints: critical
                CA:TRUE

しかし、Sail-SSL のソースコードを参照すると CA:FALSE が指定されています。謎。。。

まぁ、ということで、 /etc/nginx/certs/server.pem を取り出します。

$ ./vendor/bin/sail cp nginx:/etc/nginx/certs/server.pem .
WARN[0000] Found multiple config files with supported names: /home/akase244/repos/my-laravel-sail/compose.yaml, /home/akase244/repos/my-laravel-sail/docker-compose.yml 
WARN[0000] Using /home/akase244/repos/my-laravel-sail/compose.yaml 
WARN[0000] Found multiple config files with supported names: /home/akase244/repos/my-laravel-sail/compose.yaml, /home/akase244/repos/my-laravel-sail/docker-compose.yml 
WARN[0000] Using /home/akase244/repos/my-laravel-sail/compose.yaml 
[+] copy 1/1
 ✔ my-laravel-sail-nginx-1 Copied my-laravel-sail-nginx-1:/etc/nginx/certs/server.pem to .                                                 0.0s
$ ls -l server.pem 
-rw-r--r-- 1 akase244 akase244 1143  2月 23 17:11 server.pem

Chrome で「 chrome://settings/certificates 」を入力して「証明書マネージャ」を開きます。

「カスタム」→「自分でインストール」を選択し、「信頼できる証明書」に Nginx のコンテナから取り出したルート証明書をインポートします。

ブラウザで https://localhost にアクセスすると証明書の警告は表示されずにアクセスすることができました。
※証明書インポート後も警告が消えない場合は、一旦開いてるブラウザをすべて閉じてからアクセスしなおすと解消するはずです。（多分）

いかがだったでしょうか。
Docker コンテナを駆使することで、ローカル環境に追加でコマンド類をインストールすることなく Laravel Sail の環境を構築できることがわかったのではないでしょうか。

参考記事