WSLでPHPとComposerとNode.jsをインストールする(Windows)

Windows 10/11でWSL 2を使いPHP・Composer・Node.jsをインストールし、Laravel開発環境を整えるステップバイステップガイドです。

​

はじめに

Windows で Laravel を開発するには WSL(Windows Subsystem for Linux) を使うのがベストプラクティスです。Linux のツールチェーンをそのまま使えるため、macOS や本番サーバーと同じコマンドが通ります。

このガイドでは WSL 2 上の Ubuntu で PHP・Composer・Node.js(nvm 経由)をインストールし、laravel new が動く状態にするまでを解説します。

対象環境: Windows 10(バージョン 2004 以降)または Windows 11。WSL 2 を使います。

---

​

WSL のインストール

1. PowerShell を管理者として開く

   スタートメニューで「PowerShell」を検索し、「管理者として実行」を選択します。

2. WSL と Ubuntu をインストールする

   wsl --install
   

   このコマンドで WSL 2 と Ubuntu(デフォルトディストリビューション)がインストールされます。完了後、PC を再起動します。

3. Ubuntu をセットアップする

   再起動後、Ubuntu が自動的に起動します。ユーザー名とパスワードを設定してください。このパスワードは sudo コマンドで使います。

   パスワードは入力中に画面に表示されません。正確に入力してください。

4. パッケージリストを更新する

   Ubuntu のターミナルで以下を実行します。

   sudo apt update && sudo apt upgrade -y
   

---

​

PHP のインストール

Ubuntu の標準リポジトリの PHP は古いバージョンが含まれていることがあります。ondrej/php PPA を使って最新バージョンをインストールします。

1. 必要なパッケージをインストールする

   sudo apt install -y software-properties-common
   
2. ondrej/php PPA を追加する

   sudo add-apt-repository ppa:ondrej/php
   sudo apt update
   
3. PHP 8.3 と必要な拡張をインストールする

   Laravel 13 は PHP 8.3 以上が必要です。

   sudo apt install -y php8.3 php8.3-cli php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip php8.3-sqlite3 php8.3-mysql
   
4. バージョンを確認する

   php --version
   

   PHP 8.3.x 以上が表示されれば成功です。

5. (任意)複数バージョンを切り替える

   複数の PHP バージョンが必要な場合は update-alternatives で切り替えられます。

   sudo update-alternatives --config php
   

   インストール済みのバージョン一覧が表示されるので、使用するバージョンの番号を入力します。

---

​

Composer のインストール

Composer は公式インストーラーを使ってインストールします。

1. 必要なパッケージを確認する

   sudo apt install -y curl php8.3-cli unzip
   
2. 公式インストーラーをダウンロードして実行する

   curl -sS https://getcomposer.org/installer -o /tmp/composer-setup.php
   sudo php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer
   
3. バージョンを確認する

   composer --version
   
4. グローバルインストールのパスを設定する

   composer global require でインストールしたパッケージ(Laravel インストーラーなど)を使えるように、~/.composer/vendor/bin を PATH に追加します。

   ~/.bashrc(または ~/.zshrc)に以下を追記します。

   export PATH="$HOME/.composer/vendor/bin:$PATH"
   

   設定を反映します。

   source ~/.bashrc
   

---

​

nvm のインストール

Node.js は nvm(Node Version Manager)を使ってユーザー単位でインストールします。sudo 不要で管理できるため、グローバルな npm パッケージを使う AI ツールや CLI との相性が良いです。

1. nvm をインストールする

   最新のインストールスクリプトは nvm の GitHub リポジトリ で確認できます。

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   
2. シェル設定ファイルに追記する

   インストールスクリプトは自動的に ~/.bashrc に以下を追記します。追記されていない場合は手動で追加してください。

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
   

   設定を反映します。

   source ~/.bashrc
   

   zsh を使っている場合は ~/.zshrc に同様に追記し、source ~/.zshrc で反映します。

3. インストールを確認する

   nvm --version
   

---

​

Node.js のインストール

1. LTS バージョンをインストールする

   nvm install --lts
   
2. デフォルトに設定する

   新しいターミナルセッションでも自動的に使われるよう、デフォルトバージョンを設定します。

   nvm alias default node
   
3. バージョンを確認する

   node --version
   npm --version
   

---

​

Laravel のインストール確認

1. Laravel インストーラーを導入する

   composer global require laravel/installer
   
2. 新しいプロジェクトを作成する

   laravel new my-app
   

   対話的なセットアップが始まります。スターターキットや認証の有無などを選択できます。

3. 開発サーバーを起動する

   cd my-app
   php artisan serve
   

   ブラウザで http://localhost:8000 にアクセスし、Laravel のウェルカムページが表示されれば完了です。

   WSL から Windows のブラウザで localhost にアクセスできない場合は、php artisan serve --host=0.0.0.0 で起動してみてください。

---

​

補足: 開発効率を上げるツール

​

Windows Terminal

Windows Terminal を使うと、複数のタブで WSL・PowerShell・コマンドプロンプトを一元管理できます。Microsoft Store から無料でインストールできます。

• タブで複数のシェルを並行操作
• Ubuntu のシェルをデフォルトに設定可能
• フォントや配色を自由にカスタマイズ

​

VS Code Remote - WSL 拡張

VS Code の Remote - WSL 拡張を使うと、WSL 内のファイルを Windows の VS Code から直接編集できます。

# WSL ターミナルからプロジェクトを VS Code で開く
code .

初回実行時に VS Code サーバーが WSL 内に自動インストールされます。以降はネイティブと同等の操作感で開発できます。