Windows10にLaravel 8.x/Dockerの環境を作成するにあたっての備忘録です。
Laravel 8.x 公式ドキュメントのインストール手順には、
Docker上にLaravel環境を構築する方法が紹介されています。
その手順に従い、Windows10にLaravel環境を作成するにあたっての備忘録。

Docker Desktopをインストール

ダイアログに従って普通にインストール。
Docker Desktop
https://www.docker.com/products/docker-desktop

Windows Subsystem for Linux 2（WSL2）インストール

以下URLの「Manual Installation Steps」を参考に。
https://docs.microsoft.com/en-us/windows/wsl/install-win10

PowerShellを管理者権限で起動

Windows SubsystemforLinuxオプション機能の有効化

WindowsでLinuxサブシステムを使えるようにするための設定。
PowerShell上で次のコマンドを実行し、マシンを再起動する。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

仮想マシン機能の有効化

仮想マシン利用を有効にするための設定。
PowerShellで次のコマンドを実行し、マシンを再起動。

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

WSL2 Linuxカーネルアップデートパッケージをダウンロード

リンク先の「WSL2 Linux kernel update package for x64 machines」から
ダウンロードしてインストール。
https://docs.microsoft.com/en-us/windows/wsl/install-win10

WSL2をデフォルトバージョンとして設定

これからインストールするLinuxサブシステムで、WSL2をデフォルトとして使用するための設定。
PowerShell上で次のコマンドを実行。

wsl --set-default-version 2

Linuxサブシステムのインストールと設定

サブシステムのインストール

Windows上で動作するLinuxサブシステムをインストールする。
色々あるが、今回は深く考えずにKali-linuxをインストールした。

MicrosoftStoreから、
各Linuxサブシステムをダウンロード＆インストール。
各サブシステムへのリンクは下記リンクの「Step 6 - Install your Linux distribution of choice」参照。
https://docs.microsoft.com/en-us/windows/wsl/install-win10

サブシステムのユーザー、パスワードを設定

サブシステムをインストールし、初回起動すると
ユーザー名とパスワードの設定を求められるので、設定する。

以上でWindows上にLinuxサブシステムがセットアップされる。

PowerShell上から次のコマンドを打ってみて、エラーなどが出なければ正しくセットアップされているはず。

Linuxサブシステムに割り当てられているWSLの確認

wsl --list --verbose

Docker Desktopの設定

DockerがWSL2をベースに動き、またインストールしたLinuxサブシステムを認識するための設定。

Docker Desktopを起動し、メニューバーの「Settings」（歯車のアイコン）をクリック。

左メニューの「General」が選択された状態で、
「Use the WSL 2 based engine」が有効になっていることを確認。

左メニューの「Resources」→「WSL INTEGRATION」で、
インストールしたLinuxサブシステムにチェックを入れ（自分の場合はkaki-linuxです）、
Apply ＆ RestartをクリックしてDockerを再起動。

PowerShellでLinuxサブシステムを起動する。
自分の場合はkali-linuxの起動コマンド「kali」。

PS C:\Users\azumak> kali

起動したLinuxサブシステム上で、「docker -v」などと打ってみて
Dockerを認識しているか確認する。

Laravelインストール

Linuxサブシステム上で、以下コマンドを実行してLaravel最新版をインストールする。

 sudo curl -s https://laravel.build/<プロジェクト名>| bash

ここで、「Docker is not running」と表示されて先に進まないようであれば、
Dockerが起動していないか、LinuxサブシステムがDockerを認識していない・・・かも。
自分の場合はDockerとkali-linuxの関連付けができていなかった。

うまくいけば、指定したフォルダにLaravel最新版がインストールされる。

Laravel Sail起動

インストールが成功すると指定したフォルダにLaravelプロジェクトが作成されるので、
プロジェクトフォルダに移動してSailコマンドを実行する。

cd <プロジェクト名>
./vendor/bin/sail up

初回はとても時間がかかる。
build成功のログが出たらhttp://localhostにアクセスし、
LaravelのTOページが表示されれば成功！

参考

https://readouble.com/laravel/8.x/ja/installation.html
https://docs.microsoft.com/en-us/windows/wsl/install-win10