Laravelとの出会いMeet Laravel
Laravelは、表現力豊かでエレガントな構文を備えたWebアプリケーションフレームワークです。Webフレームワークは、アプリケーションを作成するための構造と開始点を提供します。これにより、細部に気を配りながら、すばらしいものの作成に集中できます。Laravel is a web application framework with expressive, elegant syntax. A web framework provides a structure and starting point for creating your application, allowing you to focus on creating something amazing while we sweat the details.
Laravelは、すばらしい開発者エクスペリエンスの提供に努めています。同時に完全な依存注入、表現力豊かなデータベース抽象化レイヤー、キューとジョブのスケジュール、ユニットと統合テストなど、強力な機能もLaravelは提供しています。Laravel strives to provide an amazing developer experience while providing powerful features such as thorough dependency injection, an expressive database abstraction layer, queues and scheduled jobs, unit and integration testing, and more.
PHP Webフレームワークをはじめて使用する場合も、長年の経験を持っている場合でも、Laravelは一緒に成長できるフレームワークです。私たちは皆さんがWeb開発者として最初の一歩を踏み出すのを支援したり、専門知識を次のレベルに引き上げる後押しをしたりしています。あなたが何を作り上げるのか楽しみにしています。Whether you are new to PHP web frameworks or have years of experience, Laravel is a framework that can grow with you. We'll help you take your first steps as a web developer or give you a boost as you take your expertise to the next level. We can't wait to see what you build.
Laravel Bootcampでは、Laravelのフレームワークを実際に体験しながら、Laravelアプリケーションを構築できます。[!NOTE]
Note: Laravelは初めてですか?
New to Laravel? Check out the Laravel Bootcamp[https://bootcamp.laravel.com] for a hands-on tour of the framework while we walk you through building your first Laravel application.
なぜLaravelなのか?Why Laravel?
Webアプリケーションを構築するときに利用できるさまざまなツールとフレームワークがあります。そうした状況でも、Laravelは最新のフルスタックWebアプリケーションを構築するために最良の選択であると私たちは信じています。There are a variety of tools and frameworks available to you when building a web application. However, we believe Laravel is the best choice for building modern, full-stack web applications.
前進するフレームワークA Progressive Framework
私たちはLaravelを「進歩的な」フレームワークと呼んでいます。つまり、Laravelはあなたと一緒に成長するという意味です。もしあなたが、Web開発の最初の一歩を踏み出したばかりの方であれば、Laravelの膨大なドキュメント、ガイド、およびビデオチュートリアルのライブラリが、圧倒されず骨子を学ぶのに役立つでしょう。We like to call Laravel a "progressive" framework. By that, we mean that Laravel grows with you. If you're just taking your first steps into web development, Laravel's vast library of documentation, guides, and video tutorials[https://laracasts.com] will help you learn the ropes without becoming overwhelmed.
開発の上級者でしたら、Laravelの依存注入、単体テスト、キュー、リアルタイムイベントなど堅牢なツールが役立つでしょう。Laravelは、プロフェッショナルなWebアプリケーションを構築するため調整してあり、エンタープライズにおける作業負荷を処理する準備ができています。If you're a senior developer, Laravel gives you robust tools for dependency injection[/docs/{{version}}/container], unit testing[/docs/{{version}}/testing], queues[/docs/{{version}}/queues], real-time events[/docs/{{version}}/broadcasting], and more. Laravel is fine-tuned for building professional web applications and ready to handle enterprise work loads.
スケーラブルなフレームワークA Scalable Framework
Laravelは素晴らしくスケーラブルです。PHPのスケーリングに適した基本の性質と、Redisなど高速な分散キャッシュシステムに対するLaravelの組み込み済みサポートにより、Laravelを使用した水平スケーリングは簡単です。実際、Laravelアプリケーションは、月あたり数億のリクエストを処理するよう簡単に拡張できます。Laravel is incredibly scalable. Thanks to the scaling-friendly nature of PHP and Laravel's built-in support for fast, distributed cache systems like Redis, horizontal scaling with Laravel is a breeze. In fact, Laravel applications have been easily scaled to handle hundreds of millions of requests per month.
極端なスケーリングが必要ですか? Laravel Vaporのようなプラットフォームを使用すると、AWSの最新のサーバレステクノロジーでほぼ無制限の規模でLaravelアプリケーションを実行できます。Need extreme scaling? Platforms like Laravel Vapor[https://vapor.laravel.com] allow you to run your Laravel application at nearly limitless scale on AWS's latest serverless technology.
コミュニティによるフレームワークA Community Framework
LaravelはPHPエコシステムで最高のパッケージを組み合わせ、もっとも堅牢で開発者に優しいフレームワークとして使用できるように提供しています。さらに、世界中の何千人もの才能ある開発者がフレームワークに貢献しています。多分あなたもLaravelの貢献者になるかもしれませんね。Laravel combines the best packages in the PHP ecosystem to offer the most robust and developer friendly framework available. In addition, thousands of talented developers from around the world have contributed to the framework[https://github.com/laravel/framework]. Who knows, maybe you'll even become a Laravel contributor.
Laravelアプリの生成Creating a Laravel Application
PHPとLaravelインストーラのインストールInstalling PHP and the Laravel Installer
最初のLaravelアプリケーションを作成する前に、ローカルマシンにPHP、Composer、Laravelインストーラがインストール済みであることを確認してください。さらに、アプリケーションのフロントエンドリソースをコンパイルできるように、NodeとNPMかBunもインストールしてください。Before creating your first Laravel application, make sure that your local machine has PHP[https://php.net], Composer[https://getcomposer.org], and the Laravel installer[https://github.com/laravel/installer] installed. In addition, you should install either Node and NPM[https://nodejs.org] or Bun[https://bun.sh/] so that you can compile your application's frontend assets.
ローカルマシンにPHPとComposerをインストールしていない場合は、以下のコマンドでPHP、Composer、LaravelインストーラをmacOS、Windows、Linuxへインストールできます。If you don't have PHP and Composer installed on your local machine, the following commands will install PHP, Composer, and the Laravel installer on macOS, Windows, or Linux:
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.3)"
# 管理者として実行する
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.3'))
/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.3)"
上記のコマンドを実行した後、ターミナルセッションを再起動してください。PHP、Composer、Laravelインストーラをインストールした後に、php.new
によりアップデートするには、ターミナルでコマンドを再実行してください。After running one of the commands above, you should restart your terminal session. To update PHP, Composer, and the Laravel installer after installing them via php.new
, you can re-run the command in your terminal.
すでにPHPとComposerがインストール済みの場合は、Composer経由でLaravelインストーラをインストールしてください。If you already have PHP and Composer installed, you may install the Laravel installer via Composer:
composer global require laravel/installer
Laravel Herdをチェックしてください。[!NOTE]For a fully-featured, graphical PHP installation and management experience, check out Laravel Herd[#local-installation-using-herd].
Note: 全機能を備えたグラフィカルなPHPのインストールと管理については、
アプリケーションの生成Creating an Application
PHP、Composer、Laravelインストーラをインストールしたら、新しいLaravelアプリケーションを作成する準備ができました。Laravelインストーラは、希望するテストフレームワーク、データベース、スターターキットを選択するように促します。After you have installed PHP, Composer, and the Laravel installer, you're ready to create a new Laravel application. The Laravel installer will prompt you to select your preferred testing framework, database, and starter kit:
laravel new example-app
アプリケーションを作成したら、dev
Composerスクリプトを使って、Laravelのローカル開発サーバ、キューワーカ、Vite開発サーバを起動できます。Once the application has been created, you can start Laravel's local development server, queue worker, and Vite development server using the dev
Composer script:
cd example-app
npm install && npm run build
composer run dev
開発サーバを起動すると、アプリケーションはウェブブラウザでhttp://localhost:8000からアクセスできるようになります。これで、Laravelエコシステムへの次のステップを開始する準備が整いました。もちろん、データベースを設定することも必要でしょう。Once you have started the development server, your application will be accessible in your web browser at http://localhost:8000[http://localhost:8000]. Next, you're ready to start taking your next steps into the Laravel ecosystem[#next-steps]. Of course, you may also want to configure a database[#databases-and-migrations].
スターターキットの1つを使用することを検討してください。Laravelのスターターキットは、新しいLaravelアプリケーションのために、バックエンドとフロントエンド側の認証のスカフォールドを提供します。[!NOTE]
Note: Laravelアプリケーションを開発する際に、有利なスタートダッシュを切りたければ、
If you would like a head start when developing your Laravel application, consider using one of our starter kits[/docs/{{version}}/starter-kits]. Laravel's starter kits provide backend and frontend authentication scaffolding for your new Laravel application.
初期設定Initial Configuration
Laravelフレームワークのすべての設定ファイルは、config
ディレクトリへ格納しています。各オプションはコメントによりドキュメント化されていますので、自由にファイルに目を通して、利用可能なオプションに慣れてください。All of the configuration files for the Laravel framework are stored in the config
directory. Each option is documented, so feel free to look through the files and get familiar with the options available to you.
Laravelは初期設定で動き、追加の設定はほぼ必要ありません。すぐに開発を始めることができます!しかし、config/app.php
ファイルとそのコメントの確認をお勧めします。このファイルはtimezone
やlocale
など、アプリケーションに応じて変更したいであろうオプションを含んでいます。。Laravel needs almost no additional configuration out of the box. You are free to get started developing! However, you may wish to review the config/app.php
file and its documentation. It contains several options such as timezone
and locale
that you may wish to change according to your application.
環境ベースの設定Environment Based Configuration
アプリケーションをローカルマシンで実行するか、本番のWebサーバで実行するかにより、Laravelの設定オプション値の多くは異なる可能性があるため、多くの重要な設定値は、アプリケーションのルートに存在する.env
ファイルを使用して定義します。Since many of Laravel's configuration option values may vary depending on whether your application is running on your local machine or on a production web server, many important configuration values are defined using the .env
file that exists at the root of your application.
.env
ファイルはアプリケーションのソース管理下へコミットすべきではありません。なぜなら、アプリケーションを使用する開発者やサーバごとに、異なる環境設定が必要になる可能性があるからです。さらに、侵入者がソース管理リポジトリにアクセスした場合、機密情報が公開されてしまうため、セキュリティ上のリスクとなります。Your .env
file should not be committed to your application's source control, since each developer / server using your application could require a different environment configuration. Furthermore, this would be a security risk in the event an intruder gains access to your source control repository, since any sensitive credentials would be exposed.
Note:
.env
ファイルと環境ベースによる設定の詳細は、完全な設定のドキュメントをチェックしてください。[!NOTE]
For more information about the.env
file and environment based configuration, check out the full configuration documentation[/docs/{{version}}/configuration#environment-configuration].
データベースとマイグレーションDatabases and Migrations
Laravelアプリケーションを作成したら、おそらくデータベースにデータを保存したいと思うでしょう。アプリケーションの.env
設定ファイルはデフォルトで、LaravelがSQLiteデータベースとやり取りする指定をしています。Now that you have created your Laravel application, you probably want to store some data in a database. By default, your application's .env
configuration file specifies that Laravel will be interacting with an SQLite database.
アプリケーション作成時に、Laravelはあなたのためにdatabase/database.sqlite
ファイルを作成し、アプリケーションのデータベーステーブルを作成するために必要なマイグレーションを実行しました。During the creation of the application, Laravel created a database/database.sqlite
file for you, and ran the necessary migrations to create the application's database tables.
MySQLやPostgreSQLなど別のデータベースドライバを使用したい場合は、.env
設定ファイルを更新して、適切なデータベースを使用できるようにしてください。例えば、MySQLを使いたい場合は、.env
設定ファイルのDB_*
変数を以下のように更新します。If you prefer to use another database driver such as MySQL or PostgreSQL, you can update your .env
configuration file to use the appropriate database. For example, if you wish to use MySQL, update your .env
configuration file's DB_*
variables like so:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
SQLite以外のデータベースを使用する場合は、データベースを作成し、アプリケーションのデータベースマイグレーションを実行する必要があります。If you choose to use a database other than SQLite, you will need to create the database and run your application's database migrations[/docs/{{version}}/migrations]:
php artisan migrate
Herd Proの使用を検討してください。[!NOTE]
Note: macOSやWindowsで開発していて、MySQL、PostgreSQL、Redisをローカルにインストールする必要がある場合は、
If you are developing on macOS or Windows and need to install MySQL, PostgreSQL, or Redis locally, consider using Herd Pro[https://herd.laravel.com/#plans].
ディレクトリ設定Directory Configuration
Laravelは常に、Webサーバで設定した「Webディレクトリ」のルートから提供されるべきです。「Webディレクトリ」のサブディレクトリからLaravelアプリケーションを提供しようとしないでください。そうすると、アプリケーション内に存在する機密ファイルが公開されてしまう可能性があります。Laravel should always be served out of the root of the "web directory" configured for your web server. You should not attempt to serve a Laravel application out of a subdirectory of the "web directory". Attempting to do so could expose sensitive files present within your application.
Herd使用のローカルインストールLocal Installation Using Herd
Laravel Herdは、macOSとWindowsのための、超高速でネイティブなLaravelとPHPの開発環境です。Herdには、PHPやNginxなど、Laravel開発を始めるために必要なものがすべて含まれています。Laravel Herd[https://herd.laravel.com] is a blazing fast, native Laravel and PHP development environment for macOS and Windows. Herd includes everything you need to get started with Laravel development, including PHP and Nginx.
Herdをインストールすれば、Laravelを使う開発を始める準備ができます。Herdは、php
、composer
、laravel
、expose
、node
、npm
、nvm
用のコマンドラインツールを用意してあります。Once you install Herd, you're ready to start developing with Laravel. Herd includes command line tools for php
, composer
, laravel
, expose
, node
, npm
, and nvm
.
Herd Proは、ローカルのMySQL、Postgres、Redisデータベースを作成・管理する機能や、ローカルのメール閲覧、ログ監視など、Herdをさらに強力な機能で強化します。[!NOTE]
Note:
Herd Pro[https://herd.laravel.com/#plans] augments Herd with additional powerful features, such as the ability to create and manage local MySQL, Postgres, and Redis databases, as well as local mail viewing and log monitoring.
macOSでのHerdHerd on macOS
macOSで開発する場合は、Herd websiteからHerdインストーラをダウンロードできます。このインストーラは自動的に最新バージョンのPHPをダウンロードし、バックグラウンドで常にNginxを実行するようにMacを設定します。If you develop on macOS, you can download the Herd installer from the Herd website[https://herd.laravel.com]. The installer automatically downloads the latest version of PHP and configures your Mac to always run Nginx[https://www.nginx.com/] in the background.
macOS向けHerdは、dnsmasqを使用し、「parked」ディレクトリをサポートします。パークしたディレクトリにあるLaravelアプリケーションは、自動的にHerdが提供します。デフォルトでHerdは、~/Herd
にパークするディレクトリを作成し、そのディレクトリ名を使用して.test
ドメイン上のこのディレクトリ内の任意のLaravelアプリケーションへアクセスできます。Herd for macOS uses dnsmasq[https://en.wikipedia.org/wiki/Dnsmasq] to support "parked" directories. Any Laravel application in a parked directory will automatically be served by Herd. By default, Herd creates a parked directory at ~/Herd
and you can access any Laravel application in this directory on the .test
domain using its directory name.
Herdのインストール後、最も速く新しいLaravelアプリケーションを作成する方法は、Herdにバンドル済みのLaravel CLIを使用します。After installing Herd, the fastest way to create a new Laravel application is using the Laravel CLI, which is bundled with Herd:
cd ~/Herd
laravel new my-app
cd my-app
herd open
もちろん、システムトレイにあるHerdメニューから開くことができるHerdのUIで、いつでもパークしたディレクトリやその他のPHP設定を管理することができます。Of course, you can always manage your parked directories and other PHP settings via Herd's UI, which can be opened from the Herd menu in your system tray.
Herdについての詳細は、Herd documentationをご覧ください。You can learn more about Herd by checking out the Herd documentation[https://herd.laravel.com/docs].
WindowsでのHerdHerd on Windows
Herd websiteから、Windowsインストーラをダウンロードできます。インストールし終えたら、Herdを起動してインストール処理を完了し、Herd UIにアクセスできます。You can download the Windows installer for Herd on the Herd website[https://herd.laravel.com/windows]. After the installation finishes, you can start Herd to complete the onboarding process and access the Herd UI for the first time.
Herdのシステムトレイアイコンを左クリックで、Herd UIへアクセスできます。右クリックするとクイックメニューが開き、日常的に必要なすべてのツールにアクセスできます。The Herd UI is accessible by left-clicking on Herd's system tray icon. A right-click opens the quick menu with access to all tools that you need on a daily basis.
インストール中、Herdはホームディレクトリの%USERPROFILE%\Herd
に、「parked」ディレクトリを作成します。パークしたディレクトリにあるLaravelアプリケーションは、自動的にHerdが提供しますので、ディレクトリ名.test
ドメインで、Laravelアプリケーションへアクセスできます。During installation, Herd creates a "parked" directory in your home directory at %USERPROFILE%\Herd
. Any Laravel application in a parked directory will automatically be served by Herd, and you can access any Laravel application in this directory on the .test
domain using its directory name.
Herdインストール後、最も速く新しいLaravelアプリケーションを作成する方法は、Herdにバンドル済みのLaravel CLIを使用することです。開始するには、Powershellを開き、以下のコマンドを実行します:After installing Herd, the fastest way to create a new Laravel application is using the Laravel CLI, which is bundled with Herd. To get started, open Powershell and run the following commands:
cd ~\Herd
laravel new my-app
cd my-app
herd open
Herdの詳細は、Windows向けHerdドキュメントをご覧ください。You can learn more about Herd by checking out the Herd documentation for Windows[https://herd.laravel.com/docs/windows].
Sailで使用するDockerのインストールDocker Installation Using Sail
皆さんの好みのオペレーティングシステムが何であれ、できるだけ簡単にLaravelを始められるようにしたいと考えています。そのため、ローカルマシンでLaravelアプリケーションを開発・実行するための様々なオプションが用意されています。これらのオプションは後ほど検討していただけますが、LaravelではSailという、Dockerを使用してLaravelアプリケーションを実行する組み込みソリューションを提供しています。We want it to be as easy as possible to get started with Laravel regardless of your preferred operating system. So, there are a variety of options for developing and running a Laravel application on your local machine. While you may wish to explore these options at a later time, Laravel provides Sail[/docs/{{version}}/sail], a built-in solution for running your Laravel application using Docker[https://www.docker.com].
Dockerは、ローカルマシンにインストールしているソフトウェアや構成に干渉しない、小型で軽量の「コンテナ」でアプリケーションとサービスを実行するためのツールです。これはつまり、パーソナルマシン上のWebサーバやデータベースなどの複雑な開発ツールの構成や準備について心配する必要はないことを意味します。開発を開始するには、Docker Desktopをインストールするだけです。Docker is a tool for running applications and services in small, light-weight "containers" which do not interfere with your local machine's installed software or configuration. This means you don't have to worry about configuring or setting up complicated development tools such as web servers and databases on your local machine. To get started, you only need to install Docker Desktop[https://www.docker.com/products/docker-desktop].
Laravel Sailは、LaravelのデフォルトのDocker構成と、操作するための軽量のコマンドラインインターフェイスです。 Sailは、Dockerの経験がなくても、PHP、MySQL、Redisを使用してLaravelアプリケーションを構築するために良い出発点を提供しています。Laravel Sail is a light-weight command-line interface for interacting with Laravel's default Docker configuration. Sail provides a great starting point for building a Laravel application using PHP, MySQL, and Redis without requiring prior Docker experience.
Note: すでにDockerのエキスパートですか?ご心配なく!Laravelが提供する
docker-compose.yml
ファイルを使用して、Sailに関するすべてをカスタマイズできます。[!NOTE]
Already a Docker expert? Don't worry! Everything about Sail can be customized using thedocker-compose.yml
file included with Laravel.
macOSでのSailSail on macOS
Macで開発していて、Docker Desktopがすでにインストールされているならば、簡単なターミナルコマンドを使用して新しいLaravelアプリケーションを作成できます。たとえば、「example-app」という名前のディレクトリに新しいLaravelアプリケーションを作成するには、ターミナルで以下のコマンドを実行します。If you're developing on a Mac and Docker Desktop[https://www.docker.com/products/docker-desktop] is already installed, you can use a simple terminal command to create a new Laravel application. For example, to create a new Laravel application in a directory named "example-app", you may run the following command in your terminal:
curl -s "https://laravel.build/example-app" | bash
もちろん、このURLの"example-app"は好きなように変更できます。ただし、アプリケーション名は英数字とハイフン、アンダーバーだけで構成してください。Laravelアプリケーションのディレクトリは、コマンドを実行したディレクトリ内に作成されます。Of course, you can change "example-app" in this URL to anything you like - just make sure the application name only contains alpha-numeric characters, dashes, and underscores. The Laravel application's directory will be created within the directory you execute the command from.
Sailのインストールは、Sailのアプリケーションコンテナをローカルマシン上に構築するため、数分かかる場合があります。Sail installation may take several minutes while Sail's application containers are built on your local machine.
アプリケーションを作成したら、アプリケーションディレクトリに移動してLaravel Sailを起動してください。Laravel Sailは、LaravelのデフォルトのDocker構成を操作するためのシンプルなコマンドラインインターフェイスを提供しています。After the application has been created, you can navigate to the application directory and start Laravel Sail. Laravel Sail provides a simple command-line interface for interacting with Laravel's default Docker configuration:
cd example-app
./vendor/bin/sail up
アプリケーションのDockerコンテナが起動したら、アプリケーションのデータベースマイグレーションを実行します。Once the application's Docker containers have started, you should run your application's database migrations[/docs/{{version}}/migrations]:
./vendor/bin/sail artisan migrate
これで、http://localhostにより、ウェブブラウザからアプリケーションへアクセスできます。Finally, you can access the application in your web browser at: http://localhost[http://localhost].
完全なドキュメントで確認してください。[!NOTE]
Note: Laravel Sailの詳細は、
To continue learning more about Laravel Sail, review its complete documentation[/docs/{{version}}/sail].
WindowsでのSailSail on Windows
Windowsマシンに新しいLaravelアプリケーションを作成する前に、必ずDocker Desktopをインストールしてください。次に、Windows Subsystem for Linux 2(WSL2)がインストールされ、有効になっていることを確認する必要があります。 WSLを使用すると、Linuxバイナリ実行可能ファイルをWindows 10でネイティブに実行できます。WSL2をインストールして有効にする方法については、Microsoftの開発者環境ドキュメントを参照してください。Before we create a new Laravel application on your Windows machine, make sure to install Docker Desktop[https://www.docker.com/products/docker-desktop]. Next, you should ensure that Windows Subsystem for Linux 2 (WSL2) is installed and enabled. WSL allows you to run Linux binary executables natively on Windows 10. Information on how to install and enable WSL2 can be found within Microsoft's developer environment documentation[https://docs.microsoft.com/en-us/windows/wsl/install-win10].
WSL2バックエンドを使用するように構成されていることを確認する必要があります。[!NOTE]
Note: WSL2をインストールして有効にした後、Dockerデスクトップが
After installing and enabling WSL2, you should ensure that Docker Desktop is configured to use the WSL2 backend[https://docs.docker.com/docker-for-windows/wsl/].
これで、最初のLaravelアプリケーションを作成する準備が整いました。Windowsターミナルを起動し、WSL2 Linuxオペレーティングシステムの新しいターミナルセッションを開始します。次に、簡単なターミナルコマンドを使用して新しいLaravelアプリケーションを作成してみましょう。たとえば、"example-app"という名前のディレクトリに新しいLaravelアプリケーションを作成するには、ターミナルで以下のコマンドを実行します。Next, you are ready to create your first Laravel application. Launch Windows Terminal[https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701?rtc=1&activetab=pivot:overviewtab] and begin a new terminal session for your WSL2 Linux operating system. Next, you can use a simple terminal command to create a new Laravel application. For example, to create a new Laravel application in a directory named "example-app", you may run the following command in your terminal:
curl -s https://laravel.build/example-app | bash
もちろん、このURLの"example-app"は好きなように変更できます。ただし、アプリケーション名は英数字とハイフン、アンダーバーだけで構成してください。Laravelアプリケーションのディレクトリは、コマンドを実行したディレクトリ内に作成されます。Of course, you can change "example-app" in this URL to anything you like - just make sure the application name only contains alpha-numeric characters, dashes, and underscores. The Laravel application's directory will be created within the directory you execute the command from.
Sailのインストールは、Sailのアプリケーションコンテナをローカルマシン上に構築するため、数分かかる場合があります。Sail installation may take several minutes while Sail's application containers are built on your local machine.
アプリケーションを作成したら、アプリケーションディレクトリに移動してLaravel Sailを起動してください。Laravel Sailは、LaravelのデフォルトのDocker構成を操作するためのシンプルなコマンドラインインターフェイスを提供しています。After the application has been created, you can navigate to the application directory and start Laravel Sail. Laravel Sail provides a simple command-line interface for interacting with Laravel's default Docker configuration:
cd example-app
./vendor/bin/sail up
アプリケーションのDockerコンテナが起動したら、アプリケーションのデータベースマイグレーションを実行します。Once the application's Docker containers have started, you should run your application's database migrations[/docs/{{version}}/migrations]:
./vendor/bin/sail artisan migrate
これで、http://localhostにより、ウェブブラウザからアプリケーションへアクセスできます。Finally, you can access the application in your web browser at: http://localhost[http://localhost].
完全なドキュメントで確認してください。[!NOTE]
Note: Laravel Sailの詳細は、
To continue learning more about Laravel Sail, review its complete documentation[/docs/{{version}}/sail].
WSL2内での開発Developing Within WSL2
もちろん、WSL2インストール内で作成されたLaravelアプリケーションファイルを変更する必要があります。これを実現するには、MicrosoftのVisual Studio Codeエディターとリモート開発用のファーストパーティ拡張機能を使用することをお勧めします。Of course, you will need to be able to modify the Laravel application files that were created within your WSL2 installation. To accomplish this, we recommend using Microsoft's Visual Studio Code[https://code.visualstudio.com] editor and their first-party extension for Remote Development[https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack].
これらのツールをインストールしたら、Windowsターミナルを使用してアプリケーションのルートディレクトリから code .
コマンドを実行することで、任意のLaravelアプリケーションを開けます。Once these tools are installed, you may open any Laravel application by executing the code .
command from your application's root directory using Windows Terminal.
LinuxでのSailSail on Linux
Linuxで開発しており、Docker Composeを既にインストールしている場合は、簡単なターミナルコマンドで新しいLaravelアプリケーションを作成できます。If you're developing on Linux and Docker Compose[https://docs.docker.com/compose/install/] is already installed, you can use a simple terminal command to create a new Laravel application.
まず、Docker Desktop for Linuxを使用している場合は、以下のコマンドを実行してください。Docker Desktop for Linuxを使用していない場合は、このステップを飛ばしてください。First, if you are using Docker Desktop for Linux, you should execute the following command. If you are not using Docker Desktop for Linux, you may skip this step:
docker context use default
次に、"example-app "ディレクトリへ新しいLaravelアプリケーションを作成するために、ターミナルで以下のコマンドを実行します。Then, to create a new Laravel application in a directory named "example-app", you may run the following command in your terminal:
curl -s https://laravel.build/example-app | bash
もちろん、このURLの"example-app"は好きなように変更できます。ただし、アプリケーション名は英数字とハイフン、アンダーバーだけで構成してください。Laravelアプリケーションのディレクトリは、コマンドを実行したディレクトリ内に作成されます。Of course, you can change "example-app" in this URL to anything you like - just make sure the application name only contains alpha-numeric characters, dashes, and underscores. The Laravel application's directory will be created within the directory you execute the command from.
Sailのインストールは、Sailのアプリケーションコンテナをローカルマシン上に構築するため、数分かかる場合があります。Sail installation may take several minutes while Sail's application containers are built on your local machine.
アプリケーションを作成したら、アプリケーションディレクトリに移動してLaravel Sailを起動してください。Laravel Sailは、LaravelのデフォルトのDocker構成を操作するためのシンプルなコマンドラインインターフェイスを提供しています。After the application has been created, you can navigate to the application directory and start Laravel Sail. Laravel Sail provides a simple command-line interface for interacting with Laravel's default Docker configuration:
cd example-app
./vendor/bin/sail up
アプリケーションのDockerコンテナが起動したら、アプリケーションのデータベースマイグレーションを実行します。Once the application's Docker containers have started, you should run your application's database migrations[/docs/{{version}}/migrations]:
./vendor/bin/sail artisan migrate
これで、http://localhostにより、ウェブブラウザからアプリケーションへアクセスできます。Finally, you can access the application in your web browser at: http://localhost[http://localhost].
完全なドキュメントで確認してください。[!NOTE]
Note: Laravel Sailの詳細は、
To continue learning more about Laravel Sail, review its complete documentation[/docs/{{version}}/sail].
Sailサービスの選択Choosing Your Sail Services
Sailで新しいLaravelアプリケーションを作成する際に、with
というクエリ文字列変数を使って、新しいアプリケーションのdocker-compose.yml
ファイルで設定するサービスを選択できます。利用可能なサービスは、mysql
、pgsql
、mariadb
、redis
、memcached
、meilisearch
、typesence
、minio
、selenium
、mailpit
です。When creating a new Laravel application via Sail, you may use the with
query string variable to choose which services should be configured in your new application's docker-compose.yml
file. Available services include mysql
, pgsql
, mariadb
, redis
, memcached
, meilisearch
, typesense
, minio
, selenium
, and mailpit
:
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash
設定したいサービスを指定しない場合は、mysql
、redis
、meilisearch
、mailpit
、selenium
のデフォルトのスタックが設定されます。If you do not specify which services you would like configured, a default stack of mysql
, redis
, meilisearch
, mailpit
, and selenium
will be configured.
URLへdevcontainer
パラメータを追加し、デフォルトのDevcontainerをインストールするよう、Sailに指示できます。You may instruct Sail to install a default Devcontainer[/docs/{{version}}/sail#using-devcontainers] by adding the devcontainer
parameter to the URL:
curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash
IDEサポートIDE Support
Laravelアプリケーションを開発するときに、どのようなコードエディタを使用するかは自由ですが、PhpStormは、Laravel Pintを含むLaravelとそのエコシステムを幅広くサポートしています。You are free to use any code editor you wish when developing Laravel applications; however, PhpStorm[https://www.jetbrains.com/phpstorm/laravel/] offers extensive support for Laravel and its ecosystem, including Laravel Pint[https://www.jetbrains.com/help/phpstorm/using-laravel-pint.html].
さらに、コミュニティがメンテナンスしているLaravel Idea PhpStormプラグインは、コード生成、Eloquent構文補完、バリデーションルール補完など、IDEに役立つ様々な拡張機能を提供しています。In addition, the community maintained Laravel Idea[https://laravel-idea.com/] PhpStorm plugin offers a variety of helpful IDE augmentations, including code generation, Eloquent syntax completion, validation rule completion, and more.
次のステップNext Steps
Laravelアプリケーションを設定し終えて、次に何を学ぶべきか迷っているかもしれません。まず、以下のドキュメントを読み、Laravelの仕組みを理解することを強く推奨いたします。Now that you have created your Laravel application, you may be wondering what to learn next. First, we strongly recommend becoming familiar with how Laravel works by reading the following documentation:
- リクエストのライフサイクルRequest Lifecycle[/docs/{{version}}/lifecycle]
- 設定Configuration[/docs/{{version}}/configuration]
- ディレクトリ構成Directory Structure[/docs/{{version}}/structure]
- フロントエンドFrontend[/docs/{{version}}/frontend]
- サービスコンテナService Container[/docs/{{version}}/container]
- ファサードFacades[/docs/{{version}}/facades]
Laravelをどのように使用するかにより、旅の次の行き先も決まります。Laravelを使用するにはさまざまな方法があります。以下では、フレームワークの2つの主要なユースケースについて説明します。How you want to use Laravel will also dictate the next steps on your journey. There are a variety of ways to use Laravel, and we'll explore two primary use cases for the framework below.
Laravel Bootcampでは、Laravelのフレームワークを実際に体験しながら、Laravelアプリケーションを構築できます。[!NOTE]
Note: Laravelは初めてですか?
New to Laravel? Check out the Laravel Bootcamp[https://bootcamp.laravel.com] for a hands-on tour of the framework while we walk you through building your first Laravel application.
LaravelフルスタックフレームワークLaravel the Full Stack Framework
Laravelは、フルスタックフレームワークとして機能させることができます。「フルスタック」フレームワークとは、Laravelを使用して、アプリケーションへのリクエストをルーティングし、BladeテンプレートやInertiaなどのシングルページアプリケーションハイブリッド技術でフロントエンドをレンダすることを意味します。これは、Laravelフレームワークの最も一般的な使用方法であり、私たちの意見では、Laravelを使用する最も生産的な方法です。Laravel may serve as a full stack framework. By "full stack" framework we mean that you are going to use Laravel to route requests to your application and render your frontend via Blade templates[/docs/{{version}}/blade] or a single-page application hybrid technology like Inertia[https://inertiajs.com]. This is the most common way to use the Laravel framework, and, in our opinion, the most productive way to use Laravel.
この方法でLaravelの使用を計画している場合は、フロントエンド開発、ルーティング、ビュー、Eloquent ORMについてのドキュメントをチェックすると良いかも知れません。さらに、Livewire(和訳)やInertiaといったコミュニティパッケージについても学ぶことに興味があるかもしれません。これらのパッケージにより、Laravelをフルスタックフレームワークとして使用しながら、シングルページのJavaScriptアプリケーションが提供するUIの、利点をたくさん享受できます。If this is how you plan to use Laravel, you may want to check out our documentation on frontend development[/docs/{{version}}/frontend], routing[/docs/{{version}}/routing], views[/docs/{{version}}/views], or the Eloquent ORM[/docs/{{version}}/eloquent]. In addition, you might be interested in learning about community packages like Livewire[https://livewire.laravel.com] and Inertia[https://inertiajs.com]. These packages allow you to use Laravel as a full-stack framework while enjoying many of the UI benefits provided by single-page JavaScript applications.
Laravelをフルスタックフレームワークとして使用している場合、Viteを使用してアプリケーションのCSSとJavaScriptをコンパイルする方法を学ぶのも強く推奨します。If you are using Laravel as a full stack framework, we also strongly encourage you to learn how to compile your application's CSS and JavaScript using Vite[/docs/{{version}}/vite].
アプリケーションスターターキットの1つをチェックしてください。[!NOTE]
Note: アプリケーションの構築をすぐに始めたい場合は、公式の
If you want to get a head start building your application, check out one of our official application starter kits[/docs/{{version}}/starter-kits].
Laravel APIバックエンドLaravel the API Backend
Laravelは、JavaScriptシングルページアプリケーションまたはモバイルアプリケーションへのAPIバックエンドとしても機能させることもあります。たとえば、Next.jsアプリケーションのAPIバックエンドとしてLaravelを使用できます。こうした使い方では、Laravelでアプリケーションに認証とデータの保存/取得を提供すると同時に、キュー、メール、通知などのLaravelの強力なサービスを利用できます。Laravel may also serve as an API backend to a JavaScript single-page application or mobile application. For example, you might use Laravel as an API backend for your Next.js[https://nextjs.org] application. In this context, you may use Laravel to provide authentication[/docs/{{version}}/sanctum] and data storage / retrieval for your application, while also taking advantage of Laravel's powerful services such as queues, emails, notifications, and more.
この方法でLaravelの使用を計画している場合は、ルーティング、Laravel Sanctum、Eloquent ORMに関するドキュメントを確認することをお勧めします。If this is how you plan to use Laravel, you may want to check out our documentation on routing[/docs/{{version}}/routing], Laravel Sanctum[/docs/{{version}}/sanctum], and the Eloquent ORM[/docs/{{version}}/eloquent].
APIスタックとNext.jsフロントエンド実装を提供しているため、すぐに開始できます。[!NOTE]
Note: LaravelのバックエンドとNext.jsのフロントエンドのスカフォールドから始める必要がありますか?Laravel Breezeは、
Need a head start scaffolding your Laravel backend and Next.js frontend? Laravel Breeze offers an API stack[/docs/{{version}}/starter-kits#breeze-and-next] as well as a Next.js frontend implementation[https://github.com/laravel/breeze-next] so you can get started in minutes.