Installation
Table of Contents
Meet Laravel
Laravel は、表現豊かでエレガントな syntax を持つ web application フレームワークです。 web フレームワークは、あなたの application 作成のための構造とスタートポイントを提供します。私たちが細部に汗を流すことにより、あなたは素晴らしい何かを作り出すことに集中できます。
Laravel は、徹底的な dependency injection 、表現豊かな database abstraction レイヤー、 queues と定期的な jobs 、単体と統合 testing などの強力な features を提供しながら、驚くべき開発者体験を提供しようと努めています。以上です。
あなたが PHP の web フレームワークに新しいのか、それとも何年もの経験を持っているのかに関係なく、 Laravel はあなたと共に成長するフレームワークです。私たちはあなたが初めて web 開発者としての一歩を踏み出すのを手助けし、またはあなたがあなたの専門知識を次のレベルに引き上げるのを後押しします。あなたが build するものを待つことができません。
NOTE
Laravel に初めて触れるなら、Laravel Bootcamp をチェックしてみてください。フレームワークの操作方法を手取り足取り教えつつ、あなたが初めての Laravel application を build するお手伝いをします。
なぜ Laravel なのか？
web application application を構築する際には、さまざまなツールやフレームワークが利用可能です。しかし、私たちは Laravel が最も適した選択で、モダンなフル stack web application を構築するための最善の選択肢だと考えています。
プログレッシブフレームワーク
我々は、 "progressive"なフレームワークとして Laravel を呼ぶことを好みます。それは、"Laravel"があなたと共に成長することを意味します。もしあなたが webdevelopment の最初のステップを踏み出しているなら、Laravel の広大な"library"のドキュメンテーション、ガイド、ビデオチュートリアル が、圧倒されることなくロープを学ぶのに役立つでしょう。
もしあなたがシニアデベロッパーであるならば、 Laravel はdependency injection、unit testing、queues、real-time eventsなどの堅牢なツールを提供します。 Laravel はプロフェッショナルな web アプリケーションを構築するために微調整されており、エンタープライズのワークロードを handle する準備が整っています。
スケーラブルなフレームワーク
Laravel は信じられないほどスケーラブルです。PHP のスケーリングに優れた性質と Laravel の組み込みサポートが Redis のような高速分散 typescache システムに対応しているおかげで、Laravel での水平スケーリングは breeze です。事実、Laravelapplications は、毎月数億回の requests を handle するために容易にスケーリングされています。
極端なスケーリングが必要ですか？Laravel Vapor のようなプラットフォームを使用すると、AWS の最新のサーバーレス技術でほぼ無制限のスケールであなたの Laravel application を実行することができます。
コミュニティフレームワーク
Laravel は、PHP エコシステムの最高のパッケージを組み合わせて、最も堅牢で開発者に優しいフレームワークを提供しています。さらに、世界中の数千人もの優れた開発者たちがフレームワークに貢献 してきました。誰かにとっては、あなた自身が Laravel の貢献者になるかもしれません。
Creating a Laravel Project
first Laravel project を作成する前に、ローカルマシンに PHP と Composer がインストールされていることを確認してください。macOS や Windows で開発している場合、PHP と Composer は Laravel Herd を via して数分でインストールできます。さらに、Node と NPM のインストール を推奨します。
PHP と Composer をインストールした後で、Composer のcreate-project command を使って新しい Laravel project を作成することができます：
composer create-project laravel/laravel example-app
あるいは、グローバルにLaravel インストーラ を Composer 経由でインストールして新しい Laravel プロジェクトを作成することもできます：
composer global require laravel/installer
laravel new example-app
project が作成されたら、Laravel Artisan の serve command を使用して Laravel のローカル development server を起動します：
cd example-app
php artisan serve
Artisan 開発サーバーを起動すると、あなたの application はあなたの web ブラウザで http://localhost:8000 にアクセス可能になります。次に、あなたは Laravel エコシステムへの次のステップを進める 準備ができています。もちろん、 database を設定する こともできます。
NOTE
Laravel application の開発をスタートさせたい場合は、starter kitsの一つを使用することを検討してみてください。Laravel のスターターキットは、新しい Laravel application のバックエンドとフロントエンドの authentication スキャフォールディングを提供します。
Initial Configuration
すべての設定ファイルは、 Laravel フレームワークのconfigディレクトリに保存されています。各オプションは文書化されているので、ファイルを自由に見て、利用可能な options に慣れてください。
Laravel は、基本的に追加の設定が必要ありません。すぐに development を始めることができます！ただし、config/app.php ファイルとそのドキュメンテーションを確認してみると良いでしょう。timezoneやlocaleなど、 application に合わせて変更することを検討したいいくつかの options が含まれています。
Environment ベースの設定
Laravel の設定オプションの values の多くは、あなたの application が自分のローカルマシーン上で動作しているか、あるいは production web サーバー上で動作しているかによって異なる場合があるため、多くの重要な設定の values は、あなたの application の root に存在する.envファイルを使用して定義されています。
あなたの.env ファイルは、各開発者/サーバーが異なる environment 設定を必要とする可能性があるため、あなたの application のソースコントロールにコミットしてはならない。さらに、これは侵入者がソースコントロールリポジトリにアクセスを得た event に、セキュリティリスクになり得る。というのも、どんなにセンシティブな認証情報も露出するからである。
NOTE
.envファイルや environment に基づく設定についての詳細は、設定のドキュメンテーションをご覧ください。
データベースと Migrations
あなたが Laravel application を作成した今、おそらく data を database に保存したいでしょう。 default では、あなたのアプリケーションの.env設定ファイルは、 Laravel が SQLite の database とやり取りすることを指定しています。
project の作成中に、 Laravel はあなたのためにdatabase/database.sqlite ファイルを作成し、アプリケーションの database テーブルを作成するために必要な migrations を実行しました。
もしご自身の好みで別の database driver を、たとえば MySQL や PostgreSQL を使用する場合、対応する database を使用するために.envの設定ファイルを update することができます。例えば、 MySQL を使用したい場合、.envの設定ファイルのDB_*変数を以下のように update します：
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
SQLite 以外の database を使用することを選んだ場合は、 database を作成し、アプリケーションのdatabase migrationsを実行する必要があります。
php artisan migrate
NOTE
macOS で開発を行い、ローカルに MySQL 、PostgreSQL、または Redis をインストールする必要がある場合は、DBngin の使用を検討してみてください。
ディレクトリ設定
Laravel は常に、webservers で設定された"web directory"の root から配信されるべきです。 "web directory"のサブディレクトリから Laravelapplication を配信しようと試みるべきではありません。それを試みることで、application 内の機密ファイルが露出するおそれがあります。
Docker Installation Using Sail
Laravel を使用して始めることが、ご使用のオペレーティングシステムに関係なく、できるだけ簡単になるようにしたいと考えています。そのため、ローカルマシンで Laravelproject を development し、実行するためのさまざまな options があります。これらの options を後で詳しく探求することもできますが、Laravel はDocker を使用して Laravelproject を実行するための組み込みソリューションであるSailを提供しています。
Docker は、アプリケーションと services を小型で軽量な"containers"で実行するためのツールで、ローカルマシンのインストール済みソフトウェアや設定と干渉しません。これは、ローカルマシン上で web サーバーやデータベースなどの複雑な開発ツールを設定したり、構築したりする心配がないことを意味します。始めるためには、Docker Desktop をインストールするだけで十分です。
Laravel Sail は、Laravel の default の Docker 設定と対話するための軽量 command ラインインターフェースです。 Sail は、PHP、 MySQL 、および Redis を使用した Laravel application の構築を始めるのに最適な出発点を提供し、Docker の経験が事前に必要なくなります。
NOTE
すでに Docker のエキスパートですか？心配しないでください！ Sail に関するすべては、 Laravel に付属の
docker-compose.ymlファイルを使用してカスタマイズできます。
macOS での Sail
Mac で development を行っていて、すでにDocker Desktop がインストールされている場合、シンプルなターミナルの command を使用して新しい Laravel project を作成することができます。たとえば、"example-app"という名前のディレクトリに新しい Laravel application を作成するには、ターミナルで次の command を実行します。
curl -s "https://laravel.build/example-app" | bash
もちろん、「example-app」をこの"URL"の他の名前に変更することができます - ただし、「application」名には英数字、ハイフン、アンダースコアのみが含まれていることを確認してください。「Laravel」application のディレクトリは、「command」を実行するディレクトリ内に作成されます。
Sail のインストールは、Sail の application コンテナがあなたのローカルマシンで構築される間、数分間かかる可能性があります。
project が作成された後、 application ディレクトリに移動して、 Laravel Sail を開始することができます。 Laravel Sail は、Laravel の default Docker 設定と対話するためのシンプルなコマンドラインインターフェイスを提供します：
cd example-app
./vendor/bin/sail up
アプリケーションの Docker コンテナが起動したら、アプリケーションのdatabase migrationsを実行する必要があります：
./vendor/bin/sail artisan migrate
最後に、あなたの web ブラウザーで application にアクセスできます: http://localhost
NOTE
Laravel Sail についてさらに学び続けるには、その完全なドキュメンテーションをご覧ください。
Windows での Sail
あなたの Windows マシンで新しい Laravel application を作成する前に、まずDocker Desktop をインストールしてください。次に、Windows Subsystem for Linux 2(WSL2)がインストールされ、有効化されていることを確認する必要があります。WSL は、Windows 10 上でネイティブに Linux の binary 実行可能ファイルを実行できます。WSL2 のインストール方法と有効化方法についての情報は、Microsoft のdeveloper environment documentation 内で見つけることができます。
NOTE
WSL2 をインストールして有効化した後、Docker Desktop がWSL2 バックエンドを使用するように設定 されていることを確認する必要があります。
次に、あなたは初めての" Laravel project を作成する準備が整いました。Windows Terminal を起動し、WSL2 Linux オペレーティングシステムの新しい" session "を開始します。次に、シンプルなターミナルの" command "を使用して新しい" Laravel project を作成できます。たとえば、"example-app"というディレクトリに新しい" Laravel application を作成するには、ターミナルで次の" command "を実行することができます。
curl -s https://laravel.build/example-app | bash
もちろん、この URL で "example-app" をお好きなものに変更することができます - ただし、 application の名前は、英数字、ダッシュ、アンダースコアのみを含むようにしてください。 Laravel のアプリケーションディレクトリは、 command を実行するディレクトリ内に作成されます。
Sail のインストールは、Sail の application コンテナがあなたのローカルマシンで構築される間、数分かかるかもしれません。
project が作成された後、 application ディレクトリに移動して、 Laravel Sail を開始することができます。 Laravel Sail は、Laravel の default Docker 設定と対話するためのシンプルなコマンドラインインターフェースを提供します：
cd example-app
./vendor/bin/sail up
アプリケーションの Docker コンテナが起動したら、アプリケーションのdatabase migrationsを実行する必要があります。
./vendor/bin/sail artisan migrate
最後に、あなたの web ブラウザーで application にアクセスできます: http://localhost
NOTE
Laravel Sail についてさらに学び続けるためには、その完全なドキュメンテーションをご覧ください。
WSL2 内での開発
もちろん、WSL2 インストール内で作成された Laravel application のファイルを修正できる必要があります。これを達成するために、Microsoft のVisual Studio Code エディタと、リモート開発 のための彼らの第一級のエクステンションを使用することをお勧めします。
これらのツールがインストールされたら、Windows Terminal を使用してアプリケーションの root ディレクトリからcode. command を実行することで、任意の Laravel project を開くことができます。
Linux 上の Sail
Linux 上で開発している場合、すでにDocker Compose がインストールされていれば、新しい Laravel project を作成するためのシンプルなターミナルの command を使用できます。
まず、Linux 用の Docker Desktop を使用している場合は、次の command を実行する必要があります。Linux 用の Docker Desktop を使用していない場合は、このステップを skip できます：
docker context use default
次に、"example-app"という名前のディレクトリに新しい Laravel application を作成するために、ターミナルで次の command を実行することができます：
curl -s https://laravel.build/example-app | bash
もちろん、この URL の "example-app" を好きなものに変更することができます - ただし、 application の名前には英数字、ハイフン、アンダースコアのみを含めるようにしてください。 Laravel アプリケーションのディレクトリは、 command を実行するディレクトリ内に作成されます。
Sail のインストールは、Sail の application コンテナがあなたのローカルマシンで build される間、数分かかる可能性があります。
project が作成された後、 application ディレクトリに移動して、 Laravel Sail を開始することができます。 Laravel Sail は、Laravel の default Docker 設定と対話するためのシンプルなコマンドラインインターフェースを提供します：
cd example-app
./vendor/bin/sail up
アプリケーションの Docker コンテナが起動したら、アプリケーションのdatabase migrationsを実行する必要があります。
./vendor/bin/sail artisan migrate
最後に、あなたの web ブラウザで application にアクセスできます：http://localhost
NOTE
Laravel Sail についてさらに学び続けるためには、その完全なドキュメンテーションをご覧ください。
あなたの Sail Services を選ぶ
Sail を使って新しい Laravel application を作成する際に、新しいアプリケーションのdocker-compose.ymlファイルに設定するべき services を選ぶために、with query string 変数を使用することができます。利用可能な services には、mysql、pgsql、mariadb、redis、memcached、meilisearch、typesense、minio、selenium、およびmailpitが含まれています：
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash
どの services を設定したいかを指定しない場合、mysql、redis、meilisearch、mailpit、およびseleniumの default stack が設定されます。
Sail に default の Devcontainer をインストールするように指示するには、URL に devcontainer パラメータを追加します。
curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash
IDE Support
Laravel アプリケーションを開発する際には、お好きな code エディタを自由に使っていただいて構いません。しかし、PhpStorm は、 Laravel とそのエコシステム、Laravel Pint を含む幅広いサポートを提供しています。
また、コミュニティがメンテナンスしているLaravel Idea PhpStorm プラグインは、 code 生成、 Eloquent syntax 補完、 validation ルール補完など、さまざまな便利な IDE 増強機能を提供しています。
Next Steps
あなたが Laravel project を作成したので、次に何を学ぶべきか疑問に思っているかもしれません。まず、以下のドキュメンテーションを読むことにより Laravel がどのように動作するかを理解することを強くお勧めします:
あなたが Laravel をどのように使用したいかによって、次のステップも決まります。 Laravel の使用方法は様々であり、以下ではフレームワークの 2 つの primary な使用ケースについて探求します。
NOTE
Laravel に初めて触れる方は、フレームワークの実際の使い方を学びながら初めての Laravel application を作成する手引きとなるLaravel Bootcamp をご覧ください。
Laravel Full Stack フレームワーク
Laravel は完全な route フレームワークとして機能するかもしれません。ここでの "Full Stack" フレームワークとは、 Laravel を使用して requests をあなたの application に routing し、フロントエンドをBlade templatesまたは Inertia のようなシングルページ application ハイブリッド技術で rendering することを意味します。これが Laravel フレームワークを利用する最も一般的な方法であり、私たちの意見では、 Laravel を使用する最も生産的な方法です。
もし、 Laravel をこのように使用する計画であれば、私たちのドキュメンテーションでフロントエンド開発、routing、views、またはEloquent ORMについて確認してみてください。また、Livewire や Inertia のようなコミュニティパッケージについて学ぶことに興味があるかもしれません。これらのパッケージを使用すると、 Laravel をフルスタックフレームワークとして使用しながら、シングルページの JavaScript アプリケーションが提供する多くの UI の利点を享受できます。
Laravel をフル stack フレームワークとして使用している場合、アプリケーションの CSS と JavaScript をViteを使ってコンパイルする方法を学ぶことを強くお勧めします。
NOTE
あなたが application の開発を早めに始めたい場合は、私たちの公式application スターターキットのいずれかをご覧ください。
Laravel による API バックエンド
Laravel は、JavaScript のシングルページの application またはモバイル application への API バックエンドとしても機能する可能性があります。例えば、あなたのNext.js の application に対する API バックエンドとして Laravel を使用することができます。この context では、あなたの application のために、authenticationと datastorage/取り出しを提供するために Laravel を使用することができます。また、queues、mail、通知などの Laravel の強力な services を利用することも可能です。
もしこのように Laravel を使用する予定であれば、routing、Laravel Sanctum、そしてEloquent ORMに関する私たちのドキュメンテーションをチェックしてみてください。
NOTE
Laravel のバックエンドと Next.js のフロントエンドのスキャフォールディングに先行して必要ですか？ Laravel Breeze はAPI stackとNext.js のフロントエンドの実装 を提供していますので、数分で始めることができます。