Laravel のインストール手順まとめ — composer / Sail / Valet / Herd と初期設定

前提となる必須環境

必要な PHP 拡張: BCMath / Ctype / cURL / DOM / Fileinfo / JSON / Mbstring / OpenSSL / PCRE / PDO / Tokenizer / XML。

方法 1: composer create-project（最もシンプル）

# 最新版で myapp を作成
composer create-project laravel/laravel myapp

# 特定バージョンを指定
composer create-project laravel/laravel:^10.0 myapp

# プロジェクト内に入って動作確認
cd myapp
php artisan serve
# → http://127.0.0.1:8000

方法 2: Laravel Installer（速い / 推奨）

# 一度だけ Installer をグローバルインストール
composer global require laravel/installer

# PATH に Composer の bin を通す (まだなら)
# Mac/Linux:
export PATH="$PATH:$HOME/.composer/vendor/bin"
# Windows:
# %USERPROFILE%\AppData\Roaming\Composer\vendor\bin を環境変数 PATH に追加

# プロジェクト生成
laravel new myapp

# starter kit を選びたい (Laravel 10+)
laravel new myapp --breeze --stack=blade
laravel new myapp --jet --stack=livewire

方法 3: Laravel Sail（Docker ベース・公式推奨）

# Mac/Linux/WSL2 で Docker Desktop が動いていれば 1 行
curl -s "https://laravel.build/myapp" | bash

# サービスを指定して作成 (mysql, redis, mailpit, minio, selenium 等)
curl -s "https://laravel.build/myapp?with=mysql,redis,mailpit" | bash

# 起動
cd myapp
./vendor/bin/sail up -d
./vendor/bin/sail artisan migrate
# → http://localhost (ポートは APP_PORT で変更可)

方法 4: Laravel Valet（Mac 向けローカル開発）

# Homebrew で PHP / Valet を入れる
brew install php composer
composer global require laravel/valet
valet install

# プロジェクトを置くディレクトリに park
mkdir ~/Sites
cd ~/Sites
valet park

# 通常通りプロジェクト作成
laravel new myapp
# → http://myapp.test がすぐに動く

方法 5: Laravel Herd（Mac / Windows GUI）

2023 年以降に登場した GUI 版環境。herd.laravel.com からインストーラを落としてダブルクリックするだけで、PHP / Nginx / mkcert / Node.js が揃います。Mac だけでなく Windows 版もあるため初心者に最適です。

初回セットアップで必ずやる 5 つ

cd myapp

# 1) 環境変数を編集
cp .env.example .env
# DB_CONNECTION, DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD などを設定

# 2) APP_KEY を生成 (32 byte ランダム)
php artisan key:generate

# 3) シンボリックリンク (public/storage → storage/app/public)
php artisan storage:link

# 4) DB マイグレーション
php artisan migrate

# 5) フロントエンド資産のビルド (Vite)
npm install
npm run dev      # 開発時 (HMR)
npm run build    # 本番用

典型的なディレクトリ構成

myapp/
├── app/                    アプリケーションコード
│   ├── Http/Controllers/
│   ├── Models/
│   └── Providers/
├── bootstrap/              起動シーケンス
├── config/                 設定ファイル
├── database/
│   ├── migrations/         マイグレーション
│   └── seeders/
├── public/                 Web 公開ルート (index.php)
├── resources/
│   ├── views/              Blade テンプレート
│   ├── css/  js/           Vite 入力ソース
├── routes/
│   ├── web.php             Web ルート
│   ├── api.php             API ルート
├── storage/                ログ・キャッシュ・アップロード
├── tests/                  Pest / PHPUnit
├── .env                    環境変数 (.gitignore 対象)
├── artisan                 CLI エントリポイント
└── composer.json

動作確認

# 内蔵 PHP サーバ (本番用ではない)
php artisan serve --host=0.0.0.0 --port=8000
# → http://127.0.0.1:8000 にウェルカム画面

# よく使う artisan
php artisan --version          # バージョン確認
php artisan route:list         # ルート一覧
php artisan tinker             # REPL
php artisan make:model Post -m # モデル + マイグレーション

インストール直後のエラーあるある

FAQ

Q: composer が遅い
A: composer self-update で最新化、composer config --global process-timeout 600 で長めに。日本国内なら国内プロキシは原則不要。

Q: バージョンを途中で上げたい
A: composer.json の laravel/framework を ^11.0 に書き換え、composer update。breaking change は 公式アップグレードガイドを参照。

Q: PHP 複数バージョンを切り替えたい
A: Mac は brew install php@8.2 + brew link。Windows は php.net から zip 解凍 + PATH 切替、または Herd が PHP のバージョンを GUI 切替可能。