サイトを更新しています。 数日間、レイアウトや翻訳に不具合が出ることがあります。ドキュメントは引き続きご利用いただけます。表示が崩れている場合は、後ほど再読み込みしてください。

ホーム Laravel 10.x インストール

インストール

10.x 2026年3月7日

#Laravelの紹介

Laravelは表現力豊かでエレガントな構文を持つウェブアプリケーションフレームワークです。ウェブフレームワークはアプリケーション作成のための構造と出発点を提供し、細かい部分を気にせず素晴らしいものを作ることに集中できます。

Laravelは優れた開発者体験を提供しつつ、徹底した依存性注入、表現力豊かなデータベース抽象レイヤー、キューやスケジュールジョブ、ユニット・統合テストなどの強力な機能を備えています。

PHPのウェブフレームワークが初めての方も、経験豊富な方も、Laravelは成長に合わせて使い続けられるフレームワークです。ウェブ開発者としての最初の一歩をサポートし、スキルを次のレベルに引き上げる手助けをします。あなたが作るものを見るのが楽しみです。

Примечание

Laravelが初めての方は、Laravel Bootcampでフレームワークの実践的なツアーを体験しながら、最初のLaravelアプリケーションの作成を学べます。

#なぜLaravelなのか?

ウェブアプリケーションを作る際には様々なツールやフレームワークがありますが、Laravelはモダンなフルスタックウェブアプリケーションを作るのに最適な選択だと考えています。

#進化するフレームワーク

Laravelは「進化する」フレームワークと呼んでいます。これは、Laravelがあなたの成長に合わせて進化するという意味です。ウェブ開発の最初の一歩を踏み出す方には、豊富なドキュメント、ガイド、ビデオチュートリアルが学習をサポートし、迷わずに進められます。

経験豊富な開発者には、Laravelは依存性注入ユニットテストキューリアルタイムイベントなどの強力なツールを提供します。Laravelはプロフェッショナルなウェブアプリケーション構築に最適化されており、エンタープライズの負荷にも対応できます。

#スケーラブルなフレームワーク

Laravelは非常にスケーラブルです。PHPのスケーリングに適した特性と、Redisのような高速で分散型のキャッシュシステムを標準サポートしているため、Laravelでの水平スケーリングは簡単です。実際にLaravelアプリケーションは月間数億リクエストを処理する規模にスケールしています。

さらに大規模なスケーリングが必要な場合は、Laravel Vaporのようなプラットフォームを使い、AWSの最新サーバーレス技術でほぼ無制限のスケールでLaravelアプリケーションを運用できます。

#コミュニティに支えられたフレームワーク

LaravelはPHPエコシステムの優れたパッケージを組み合わせ、最も堅牢で開発者に優しいフレームワークを提供します。さらに、世界中の何千人もの才能ある開発者がフレームワークに貢献しています。あなたもLaravelのコントリビューターになるかもしれません。

#Laravelプロジェクトの作成

最初のLaravelプロジェクトを作成する前に、ローカルマシンにPHPとComposerがインストールされていることを確認してください。macOSで開発する場合は、Laravel Herdを使えば数分でPHPとComposerをインストールできます。さらに、NodeとNPMのインストールも推奨します。

PHPとComposerをインストールしたら、Composerのcreate-projectコマンドで新しいLaravelプロジェクトを作成できます:

composer create-project "laravel/laravel:^10.0" example-app

または、ComposerでLaravelインストーラーをグローバルにインストールして、新しいLaravelプロジェクトを作成することもできます:

composer global require laravel/installer

laravel new example-app

プロジェクトが作成されたら、Laravel Artisanのserveコマンドでローカル開発サーバーを起動します:

cd example-app

php artisan serve

Artisan開発サーバーを起動すると、ブラウザでhttp://localhost:8000にアクセスできます。次に、Laravelエコシステムでの次のステップに進みましょう。もちろん、データベースの設定も行えます。

Примечание

Laravelアプリケーションの開発をスムーズに始めたい場合は、スターターキットの利用を検討してください。Laravelのスターターキットはバックエンドとフロントエンドの認証スキャフォールドを提供します。

#初期設定

Laravelフレームワークの設定ファイルはすべてconfigディレクトリに保存されています。各オプションはドキュメント化されているので、ファイルを見て利用可能な設定を確認してください。

Laravelはほとんど追加設定なしでそのまま使えます。すぐに開発を始められますが、config/app.phpファイルとそのドキュメントを確認することをおすすめします。timezonelocaleなど、アプリケーションに合わせて変更したいオプションが含まれています。

#環境に応じた設定

Laravelの多くの設定値は、アプリケーションがローカルマシンか本番サーバーかによって異なるため、重要な設定値はアプリケーションのルートにある.envファイルで定義されています。

.envファイルはアプリケーションのソース管理にコミットしないでください。開発者やサーバーごとに異なる環境設定が必要になるためです。また、侵入者がソース管理リポジトリにアクセスした場合に機密情報が漏れるリスクもあります。

Примечание

.envファイルと環境に応じた設定の詳細は、設定ドキュメントをご覧ください。

#データベースとマイグレーション

Laravelアプリケーションを作成したら、データを保存するためのデータベースが必要になるでしょう。デフォルトでは、アプリケーションの.env設定ファイルでLaravelはMySQLデータベースを使い、127.0.0.1でアクセスするよう指定されています。

Примечание

macOSでMySQL、Postgres、Redisをローカルにインストールする必要がある場合は、DBnginの利用を検討してください。

ローカルマシンにMySQLやPostgresをインストールしたくない場合は、SQLiteデータベースを使うこともできます。SQLiteは小さく高速で自己完結型のデータベースエンジンです。始めるには、.env設定ファイルを更新してLaravelのsqliteデータベースドライバーを使うようにし、他のデータベース設定は削除してください:

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

SQLiteデータベースを設定したら、アプリケーションのデータベースマイグレーションを実行して、データベーステーブルを作成できます:

php artisan migrate

アプリケーション用のSQLiteデータベースが存在しない場合、Laravelはデータベースを作成するかどうか尋ねます。通常、SQLiteデータベースファイルはdatabase/database.sqliteに作成されます。

#ディレクトリ設定

Laravelは常にウェブサーバーで設定された「ウェブディレクトリ」のルートから配信されるべきです。Laravelアプリケーションを「ウェブディレクトリ」のサブディレクトリから配信しようとすると、アプリケーション内の機密ファイルが露出する恐れがあります。

#Sailを使ったDockerインストール

LaravelはどのOSでもできるだけ簡単に始められるようにしたいと考えています。そのため、ローカルマシンでLaravelプロジェクトを開発・実行するための様々な選択肢があります。後でこれらの選択肢を試すこともできますが、LaravelはDockerを使ってLaravelプロジェクトを実行するための組み込みソリューションであるSailを提供しています。

Dockerはアプリケーションやサービスを小さく軽量な「コンテナ」で実行するツールで、ローカルマシンのソフトウェアや設定に影響を与えません。つまり、ローカルマシンに複雑な開発ツール(ウェブサーバーやデータベースなど)を設定・構築する必要がありません。始めるにはDocker Desktopをインストールするだけです。

Laravel SailはLaravelのデフォルトDocker設定とやり取りするための軽量CLIです。Dockerの経験がなくても、PHP、MySQL、Redisを使ったLaravelアプリケーションの構築を簡単に始められます。

Примечание

すでにDockerに詳しい方も安心してください。SailはLaravelに含まれるdocker-compose.ymlファイルを使って自由にカスタマイズできます。

#macOSでのSail

Macで開発していてDocker Desktopがインストール済みの場合、簡単なターミナルコマンドで新しいLaravelプロジェクトを作成できます。例えば、"example-app"という名前のディレクトリに新しいLaravelアプリケーションを作成するには、ターミナルで次のコマンドを実行します:

curl -s "https://laravel.build/example-app" | bash

もちろん、このURLの"example-app"は好きな名前に変更できます。ただし、アプリケーション名は英数字、ダッシュ、アンダースコアのみを含むようにしてください。Laravelアプリケーションのディレクトリはコマンドを実行したディレクトリ内に作成されます。

Sailのインストールは、Sailのアプリケーションコンテナがローカルマシンでビルドされるため数分かかる場合があります。

プロジェクトが作成されたら、アプリケーションディレクトリに移動してLaravel Sailを起動できます。Laravel SailはLaravelのデフォルトDocker設定とやり取りするためのシンプルなCLIを提供します:

cd example-app

./vendor/bin/sail up

アプリケーションのDockerコンテナが起動したら、ブラウザで http://localhost にアクセスしてアプリケーションを利用できます。

Примечание

Laravel Sailについてさらに学びたい場合は、完全なドキュメントを参照してください。

#WindowsでのSail

Windowsマシンで新しいLaravelアプリケーションを作成する前に、Docker Desktopをインストールしてください。次に、Windows Subsystem for Linux 2(WSL2)がインストールされ有効になっていることを確認します。WSLはWindows 10上でLinuxのバイナリエグゼキュータブルをネイティブに実行できる機能です。WSL2のインストールと有効化方法はMicrosoftの開発者環境ドキュメントにあります。

Примечание

WSL2をインストール・有効化した後は、Docker DesktopがWSL2バックエンドを使うよう設定されていることを確認してください。

次に、最初のLaravelプロジェクトを作成する準備が整いました。Windows Terminalを起動し、WSL2 Linux OS用の新しいターミナルセッションを開始します。次に、簡単なターミナルコマンドで新しいLaravelプロジェクトを作成できます。例えば、"example-app"という名前のディレクトリに新しいLaravelアプリケーションを作成するには、ターミナルで次のコマンドを実行します:

curl -s https://laravel.build/example-app | bash

もちろん、このURLの"example-app"は好きな名前に変更できます。ただし、アプリケーション名は英数字、ダッシュ、アンダースコアのみを含むようにしてください。Laravelアプリケーションのディレクトリはコマンドを実行したディレクトリ内に作成されます。

Sailのインストールは、Sailのアプリケーションコンテナがローカルマシンでビルドされるため数分かかる場合があります。

プロジェクトが作成されたら、アプリケーションディレクトリに移動して Laravel Sail を起動できます。Laravel Sail は、Laravel のデフォルト Docker 設定とやり取りするためのシンプルなコマンドラインインターフェイスを提供します。

cd example-app

./vendor/bin/sail up

アプリケーションの Docker コンテナが起動したら、ウェブブラウザで http://localhost にアクセスしてアプリケーションを利用できます。

Примечание

Laravel Sail についてさらに学びたい場合は、完全なドキュメントをご覧ください。

#WSL2 内での開発

もちろん、WSL2 環境内で作成された Laravel アプリケーションのファイルを編集できる必要があります。そのために、Microsoft の Visual Studio Code エディターと、公式の Remote Development 拡張機能の使用を推奨します。

これらのツールをインストールしたら、Windows Terminal でアプリケーションのルートディレクトリから code . コマンドを実行して、任意の Laravel プロジェクトを開けます。

#Linux での Sail

Linux で開発していて、すでに Docker Compose がインストールされている場合は、簡単なターミナルコマンドで新しい Laravel プロジェクトを作成できます。

まず、Linux 用 Docker Desktop を使用している場合は、以下のコマンドを実行してください。Docker Desktop を使用していない場合は、このステップはスキップできます。

docker context use default

次に、"example-app" という名前のディレクトリに新しい Laravel アプリケーションを作成するには、ターミナルで以下のコマンドを実行します。

curl -s https://laravel.build/example-app | bash

もちろん、この URL の "example-app" は任意の名前に変更できます。ただし、アプリケーション名は英数字、ダッシュ、アンダースコアのみを含むようにしてください。Laravel アプリケーションのディレクトリは、コマンドを実行したディレクトリ内に作成されます。

Sail のインストールは、Sail のアプリケーションコンテナがローカルマシン上でビルドされるため、数分かかる場合があります。

プロジェクトが作成されたら、アプリケーションディレクトリに移動して Laravel Sail を起動できます。Laravel Sail は、Laravel のデフォルト Docker 設定とやり取りするためのシンプルなコマンドラインインターフェイスを提供します。

cd example-app

./vendor/bin/sail up

アプリケーションの Docker コンテナが起動したら、ウェブブラウザで http://localhost にアクセスしてアプリケーションを利用できます。

Примечание

Laravel Sail についてさらに学びたい場合は、完全なドキュメントをご覧ください。

#Sail サービスの選択

Sail を使って新しい Laravel アプリケーションを作成する際、with クエリ文字列変数を使って、新しいアプリケーションの docker-compose.yml ファイルに設定するサービスを選択できます。利用可能なサービスには、mysqlpgsqlmariadbredismemcachedmeilisearchtypesenseminioseleniummailpit があります。

curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

設定するサービスを指定しない場合は、デフォルトで mysqlredismeilisearchmailpitselenium のスタックが設定されます。

URL に devcontainer パラメータを追加すると、Sail によるデフォルトの Devcontainer のインストールを指示できます。

curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash

#IDE サポート

Laravel アプリケーションの開発には任意のコードエディターを使えますが、PhpStorm は Laravel とそのエコシステムを幅広くサポートしており、Laravel Pint も利用できます。

さらに、コミュニティがメンテナンスする Laravel Idea PhpStorm プラグインは、コード生成、Eloquent の構文補完、バリデーションルールの補完など、多彩な IDE 機能を提供します。

#Laravel と AI

Laravel Boost は、AI コーディングエージェントと Laravel アプリケーションの橋渡しをする強力なツールです。Boost は AI エージェントに Laravel 固有のコンテキスト、ツール、ガイドラインを提供し、Laravel の慣習に沿ったより正確でバージョン特有のコード生成を可能にします。

Boost を Laravel アプリケーションにインストールすると、AI エージェントは使用中のパッケージの把握、データベースへのクエリ、Laravel ドキュメントの検索、ブラウザログの読み取り、テスト生成、Tinker を使ったコード実行など、15以上の専門的なツールにアクセスできます。

さらに、Boost はインストール済みパッケージのバージョンに特化した 17,000 点以上のベクトル化された Laravel エコシステムのドキュメントにも AI エージェントがアクセスできるようにします。これにより、プロジェクトで使っている正確なバージョンに合わせたガイダンスを提供できます。

Boost には、Laravel が管理する AI ガイドラインも含まれており、エージェントがフレームワークの慣習に従い、適切なテストを書き、Laravel コード生成時の一般的な落とし穴を避けるよう促します。

#Laravel Boost のインストール

Boost は PHP 8.1 以上で動作する Laravel 10、11、12 アプリケーションにインストールできます。まずは開発依存として Boost をインストールしてください。

composer require laravel/boost --dev

インストール後、対話型インストーラーを実行します。

php artisan boost:install

インストーラーは IDE と AI エージェントを自動検出し、プロジェクトに適した機能を選択できます。Boost は既存のプロジェクト慣習を尊重し、デフォルトで強制的なスタイルルールは適用しません。

Примечание

Boost について詳しくは、Laravel Boost の GitHub リポジトリをご覧ください。

#次のステップ

Laravel プロジェクトを作成したら、次に何を学ぶべきか気になるかもしれません。まずは Laravel の仕組みを理解するために、以下のドキュメントを読むことを強くおすすめします。

Laravel の使い方によって、次に進むべき道も変わります。Laravel の利用方法は多様ですが、ここでは代表的な2つのユースケースを紹介します。

Примечание

Laravel が初めての方は、Laravel Bootcamp を利用して、実際に手を動かしながらフレームワークの基本を学び、最初の Laravel アプリケーションを作成してみてください。

#フルスタックフレームワークとしての Laravel

Laravel はフルスタックフレームワークとして利用できます。ここでいう「フルスタック」とは、Laravel を使ってリクエストをルーティングし、Blade テンプレートInertia のようなシングルページアプリケーションハイブリッド技術でフロントエンドをレンダリングすることを指します。これは Laravel を使う最も一般的で、生産性の高い方法です。

この使い方をする場合は、フロントエンド開発ルーティングビューEloquent ORM のドキュメントを参照するとよいでしょう。また、LivewireInertia のようなコミュニティパッケージもおすすめです。これらのパッケージを使うと、Laravel をフルスタックフレームワークとして利用しつつ、シングルページ JavaScript アプリケーションの多くの UI 利点を享受できます。

Laravel をフルスタックフレームワークとして使う場合は、Vite を使った CSS と JavaScript のコンパイル方法もぜひ学んでください。

Примечание

アプリケーションの構築をすぐに始めたい場合は、公式の アプリケーションスターターキット をご覧ください。

#API バックエンドとしての Laravel

Laravel は JavaScript のシングルページアプリケーションやモバイルアプリケーションの API バックエンドとしても利用できます。例えば、Next.js アプリケーションの API バックエンドとして Laravel を使うことが考えられます。この場合、Laravel を使って 認証 やデータの保存・取得を行い、キュー、メール、通知などの強力なサービスも活用できます。

この使い方をする場合は、ルーティングLaravel SanctumEloquent ORM のドキュメントを参照するとよいでしょう。

Примечание

Laravel バックエンドと Next.js フロントエンドのスキャフォールドをすぐに始めたい場合は、Laravel Breeze の API スタックNext.js フロントエンド実装 をご利用ください。数分でセットアップできます。