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

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を始める前に、以下の環境が必要です。
  • PHP 8.3以上
  • Composer(PHPのパッケージマネージャー)
  • Laravelインストーラー(任意だが推奨)
Node.js/npmまたはBunも、フロントエンドアセットをコンパイルするために必要です。

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

PHPとComposerとLaravelインストーラーをまとめてインストールする最も簡単な方法は、OSに合わせた次のコマンドを実行することです。
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/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 コマンドを実行すると、以下のスターターキットからいずれかを選択できます。
Inertia を使ったReactフロントエンドのスターターキットです。React 19・TypeScript・Tailwind・shadcn/ui を採用しており、SPAとサーバーサイドルーティングを組み合わせたモダンな構成を提供します。
Inertia を使ったVueフロントエンドのスターターキットです。Vue Composition API・TypeScript・Tailwind・shadcn-vue を採用しています。
Inertia を使ったSvelteフロントエンドのスターターキットです。Svelte 5・TypeScript・Tailwind・shadcn-svelte を採用しています。
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サポート

公式のLaravel VS Code Extensionをインストールすると、シンタックスハイライト・スニペット・Artisanコマンド統合・EloquentモデルのスマートオートコンプリートなどのLaravelサポートが利用できます。
PhpStormはLaravelフレームワークの組み込みサポートを持ち、Bladeテンプレート・Eloquentモデル・ルート・ビュー・翻訳のスマートオートコンプリートを提供します。

次のステップ

ディレクトリ構造

Laravelプロジェクトの主要なディレクトリとファイルを理解します。
Last modified on May 27, 2026