インストール

LaravelのインストールとPHP環境のセットアップ方法を解説します。

​

必要な環境

Laravelを始める前に、以下の環境が必要です。

• PHP 8.3以上
• Composer（PHPのパッケージマネージャー）
• Laravelインストーラー（任意だが推奨）

Node.js/npmまたはBunも、フロントエンドアセットをコンパイルするために必要です。

​

PHPとLaravelインストーラーのインストール

PHPとComposerとLaravelインストーラーをまとめてインストールする最も簡単な方法は、OSに合わせた次のコマンドを実行することです。

macOS

/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"

コマンドを実行後、ターミナルセッションを再起動してください。 PHPやComposerをすでにインストール済みの場合は、Composerを使ってLaravelインストーラーだけをインストールできます。

composer global require laravel/installer

グラフィカルなPHP管理ツールを求めるなら、Laravel Herdも確認してください。

​

新しいLaravelアプリケーションの作成

PHPとComposerとLaravelインストーラーの準備ができたら、新しいLaravelアプリケーションを作成します。 インストーラーがテストフレームワーク・データベース・スターターキットの選択を促します。

laravel new example-app

アプリケーションが作成されたら、dev Composerスクリプトで開発サーバーを起動します。

cd example-app
npm install && npm run build
composer run dev

開発サーバーが起動したら、ブラウザで http://localhost:8000 にアクセスします。

スターターキットを使うと、認証機能を含むベースの足場が自動生成されます。Laravel 13では、React・Vue・Svelte・Livewireの4種類から選択できます。

​

スターターキットの選択肢

laravel new コマンドを実行すると、以下のスターターキットからいずれかを選択できます。

React

Inertia を使ったReactフロントエンドのスターターキットです。React 19・TypeScript・Tailwind・shadcn/ui を採用しており、SPAとサーバーサイドルーティングを組み合わせたモダンな構成を提供します。

Vue

Inertia を使ったVueフロントエンドのスターターキットです。Vue Composition API・TypeScript・Tailwind・shadcn-vue を採用しています。

Svelte

Inertia を使ったSvelteフロントエンドのスターターキットです。Svelte 5・TypeScript・Tailwind・shadcn-svelte を採用しています。

Livewire

Laravel Livewire を使ったスターターキットです。PHPだけで動的なUIを構築でき、Bladeテンプレートを主に使うチームに最適です。Tailwind・Flux UI を採用しています。

どの構成を選ぶべきか迷ったら、フロントエンド で Blade・Livewire・Inertia・SPA の違いを先に整理しておくと判断しやすくなります。

​

Laravel Herd を使ったインストール

Laravel Herd は、macOSとWindows向けのネイティブなLaravel/PHP開発環境です。 PHP・Nginx・Laravel CLIをまとめてインストールできます。

​

macOS

1. Herdのウェブサイトからインストーラーをダウンロードします。
2. インストーラーを実行するとPHPが自動的に設定されます。
3. ~/Herd ディレクトリがパークディレクトリとして設定されます。

cd ~/Herd
laravel new my-app
cd my-app
herd open

​

Windows

1. HerdのウェブサイトからWindowsインストーラーをダウンロードします。
2. インストール後、Herdを起動してオンボーディングを完了させます。
3. %USERPROFILE%\Herd がパークディレクトリになります。

cd ~\Herd
laravel new my-app
cd my-app
herd open

​

初期設定

​

環境設定

Laravelの設定値の多くは、環境によって異なる場合があります。 そのため、アプリケーションのルートにある .env ファイルで重要な設定値を管理します。

.env ファイルはソースコントロールにコミットしないでください。 機密情報が漏れるリスクがあります。

​

データベースの設定

デフォルトでは、LaravelはSQLiteを使用するように設定されています。 MySQLやPostgreSQLを使う場合は、.env ファイルを更新してください。

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

SQLite以外のデータベースを使う場合は、マイグレーションを実行してテーブルを作成します。

php artisan migrate

​

IDEサポート

VS Code / Cursor

公式のLaravel VS Code Extensionをインストールすると、シンタックスハイライト・スニペット・Artisanコマンド統合・EloquentモデルのスマートオートコンプリートなどのLaravelサポートが利用できます。

PhpStorm

PhpStormはLaravelフレームワークの組み込みサポートを持ち、Bladeテンプレート・Eloquentモデル・ルート・ビュー・翻訳のスマートオートコンプリートを提供します。

​

次のステップ

ディレクトリ構造

Laravelプロジェクトの主要なディレクトリとファイルを理解します。