メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://kawax.biz/llms.txt

Use this file to discover all available pages before exploring further.

​
はじめに

Laravel チームは初心者向けに Herd や php.new を用意していますが、シニアエンジニアはパッケージマネージャーで各ツールを個別に管理することを好みます。自分でバージョンを制御でき、複数プロジェクトで異なる PHP バージョンを切り替えるのも簡単です。 このガイドでは Homebrew を使って PHP・Composer・Node.js(nvm 経由)をインストールし、laravel new が動く状態にするまでを解説します。
対象環境: macOS 13 Ventura 以降。Apple Silicon(M1/M2/M3)・Intel どちらにも対応しています。

​
Homebrew のインストール

Homebrew は macOS 向けのパッケージマネージャーです。まだインストールしていない場合は、ターミナルで以下を実行します。 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
インストール後、Apple Silicon の場合はシェル設定ファイル(~/.zprofile など)に以下の行が自動追加されます。手動で追加した場合は、設定を再読み込みしてください。 
eval "$(/opt/homebrew/bin/brew shellenv)"
インストールを確認します。 
brew --version

​
PHP のインストール

1

最新の PHP をインストールする

Homebrew の php フォーミュラは常に最新の安定バージョンを指しています。Laravel 13 は PHP 8.3 以上が必要です。
brew install php
2

バージョンを確認する

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

(任意)特定バージョンを使う

複数の PHP バージョンを管理したい場合は、バージョン付きフォーミュラをインストールします。
brew install [email protected]
バージョンを切り替えるには brew link を使います。
brew unlink php
brew link [email protected] --force --overwrite
現在リンクされているバージョンを確認します。
php --version

​
Composer のインストール

1

Composer をインストールする

Homebrew から直接インストールできます。
brew install composer
2

バージョンを確認する

composer --version
3

グローバルインストールのパスを設定する

composer global require でインストールしたパッケージ(Laravel インストーラーなど)を使えるように、~/.composer/vendor/bin を PATH に追加します。~/.zshrc(または ~/.bashrc)に以下を追記します。
export PATH="$HOME/.composer/vendor/bin:$PATH"
設定を反映します。
source ~/.zshrc

​
nvm のインストール

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

nvm をインストールする

最新のインストールスクリプトは nvm の GitHub リポジトリ で確認できます。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
2

シェル設定ファイルに追記する

インストールスクリプトは自動的に ~/.zshrc(または ~/.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 ~/.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 のウェルカムページが表示されれば完了です。

​
Herd との使い分け

Homebrew 手動構築Herd
対象者バージョン管理や設定を細かく制御したい開発者手早く始めたい初心者・個人開発者
PHP バージョン切り替えbrew link で手動GUI で簡単に切り替え
ローカルドメイン/etc/hosts を手動編集自動で .test ドメインを設定
サービス管理brew servicesGUI から起動・停止
カスタマイズ性高い限定的
チーム開発や CI 環境と設定を合わせたい場合や、複数バージョンの PHP を頻繁に切り替える場合は Homebrew による手動構築が適しています。
Last modified on March 30, 2026