(再翻訳中)Laravel 8.x インストール

Laravelとの出会い

Laravelは、表現力豊かでエレガントな構文を備えたWebアプリケーションフレームワークです。Webフレームワークは、アプリケーションを作成するための構造と開始点を提供します。これにより、細部に気を配りながら、すばらしいものの作成に集中できます。

Laravelは、すばらしい開発者エクスペリエンスの提供に努めています。同時に完全な依存性注入、表現力豊かなデータベース抽象化レイヤー、キューとジョブのスケジュール、ユニットと統合テストなど、強力な機能もLaravelは提供しています。

PHPやWebフレームワークをはじめて使用する場合でも、長年の経験がある場合でも、Laravelは一緒に成長できるフレームワークです。私たちは皆さんがWeb開発者として最初の一歩を踏み出すのを支援したり、専門知識を次のレベルに引き上げる後押しをしたりしています。あなたが何を作り上げるのか楽しみにしています。

なぜLaravelなのか?

Webアプリケーションを構築するときに利用できるさまざまなツールとフレームワークがあります。そうした状況でも、Laravelは最新のフルスタックWebアプリケーションを構築するために最良の選択であると私たちは信じています。

前進するフレームワーク

私たちはLaravelを「前進する」フレームワークと呼んでいます。つまり、Laravelはあなたと一緒に成長するという意味です。Web開発の最初の一歩を踏み出したばかりの場合は、Laravelの膨大なドキュメント、ガイド、およびビデオチュートリアルのライブラリで、圧倒されずにコツを学ぶのに役立ちます。

上級開発者でしたら、Laravelの依存性の注入単体テストキューリアルタイムイベントなどへの堅牢なツールが役立つでしょいう。Laravelは、プロフェッショナルなWebアプリケーションを構築するために調整されており、エンタープライズにおける作業負荷を処理する準備ができています。

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

Laravelは素晴らしくスケーラブルです。PHPのスケーリングに適した性質と、Redisのような高速な分散キャッシュシステムに対するLaravelの組み込み済みサポートにより、Laravelを使用した水平スケーリングは簡単です。実際、Laravelアプリケーションは、月あたり数億のリクエストを処理するよう簡単に拡張できます。

極端なスケーリングが必要ですか? Laravel Vaporのようなプラットフォームを使用すると、AWSの最新のサーバーレステクノロジーでほぼ無制限の規模でLaravelアプリケーションを実行できます。

コミュニティによるフレームワーク

LaravelはPHPエコシステムで最高のパッケージを組み合わせ、もっとも堅牢で開発者に優しいフレームワークとして使用できるように提供しています。さらに、世界中の何千人もの才能ある開発者がフレームワークに貢献しています。多分あなたもLaravelの貢献者になるかもしれませんね。

最初のLaravelプロジェクト

私たちはできるだけLaravelを簡単に使い始められるようにしたいと思っています。自分のコンピューター上でLaravelプロジェクトを開発して実行するためのさまざまな選択肢があります。後でこうしたオプションを検討することもできますが、LaravelはDockerを利用する、Laravelプロジェクトを実行できる組み込みソルーションであるSailを提供しています。

Dockerは、ローカルコンピューターにインストールされているソフトウェアや構成に干渉しない、小型で軽量の「コンテナー」でアプリケーションとサービスを実行するためのツールです。これはつまり、パーソナルコンピュータ上のWebサーバーやデータベースなどの複雑な開発ツールの構成や準備について心配する必要はないことを意味します。開発を開始するには、Docker Desktopをインストールするだけです。

Laravel Sailは、LaravelのデフォルトのDocker構成と、操作するための軽量のコマンドラインインターフェイスです。 Sailは、Dockerの経験がなくても、PHP、MySQL、Redisを使用してLaravelアプリケーションを構築するために良い出発点を提供しています。

Tip!! すでにDockerのエキスパートですか?心配しないでください!Laravelに含まれている docker-compose.ymlファイルを使用して、Sailに関するすべてをカスタマイズできます。

macOSで始める

Macで開発していて、Docker Desktopがすでにインストールされているならば、簡単なターミナルコマンドを使用して新しいLaravelプロジェクトを作成できます。たとえば、「example-app」という名前のディレクトリに新しいLaravelアプリケーションを作成するには、ターミナルで以下のコマンドを実行します。

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

もちろん、このURLの"example-app"は好きなように変更できます。Laravelアプリケーションのディレクトリは、コマンドを実行したディレクトリ内に作成されます。

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

cd example-app

./vendor/bin/sail up

Sailのupコマンドをはじめて実行すると、Sailのアプリケーションコンテナがマシン上に構築されます。これには数分かかるでしょう。心配しないでください。これ以降のSailの開始・起動は、はるかに高速になります。

アプリケーションのDockerコンテナーを開始したら、Webブラウザーでアプリケーションのhttp://localhostにアクセスできます。

Tip!! Laravel Sailの詳細は、完全なドキュメントで確認してください。

Windowsで始める

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

Tip!! WSL2をインストールして有効にした後、DockerデスクトップがWSL2バックエンドを使用するように構成されていることを確認する必要があります。

これで、最初のLaravelプロジェクトを作成する準備が整いました。Windowsターミナルを起動し、WSL2 Linuxオペレーティングシステムの新しいターミナルセッションを開始します。次に、簡単なターミナルコマンドを使用して新しいLaravelプロジェクトを作成してみましょう。たとえば、"example-app"という名前のディレクトリに新しいLaravelアプリケーションを作成するには、ターミナルで以下のコマンドを実行します。

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

もちろん、このURLの「example-app」は好きなように変更できます。Laravelアプリケーションのディレクトリは、コマンドを実行したディレクトリ内に作成されます。

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

cd example-app

./vendor/bin/sail up

Sailのupコマンドをはじめて実行すると、Sailのアプリケーションコンテナがマシン上に構築されます。これには数分かかるでしょう。心配しないでください。これ以降のSailの開始・起動は、はるかに高速になります。

アプリケーションのDockerコンテナーを開始したら、Webブラウザーでアプリケーションのhttp://localhostにアクセスできます。

Tip!! Laravel Sailの詳細は、完全なドキュメントで確認してください。

WSL2内での開発

もちろん、WSL2インストール内で作成されたLaravelアプリケーションファイルを変更する必要があります。これを実現するには、MicrosoftのVisual Studio Codeエディターとリモート開発用のファーストパーティ拡張機能を使用することをお勧めします。

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

Linuxで始める

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

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

もちろん、このURL中の”example-app”は好きなものに変更できます。Laravelアプリケーションのディレクトリは、コマンドを実行したディレクトリ内に作成されます。

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

cd example-app

./vendor/bin/sail up

Sailのupコマンドをはじめて実行すると、Sailのアプリケーションコンテナがマシン上に構築されます。これには数分かかるでしょう。心配しないでください。これ以降のSailの開始・起動は、はるかに高速になります。

アプリケーションのDockerコンテナーを開始したら、Webブラウザーでアプリケーションのhttp://localhostにアクセスできます。

Tip!! Laravel Sailの詳細は、完全なドキュメントで確認してください。

Composerでのインストール

コンピューターにすでにPHPとComposerがインストールされていれば、Composerを直接使用して新しいLaravelプロジェクトを作成できます。アプリケーションを作成したら、Artisan CLIのserveコマンドを使用して、Laravelのローカル開発サーバーを起動できます。

composer create-project laravel/laravel example-app

cd example-app

php artisan serve

Laravelインストーラ

または、LaravelインストーラーをグローバルなComposerのパッケージとしてインストールすることもできます。

composer global require laravel/installer

laravel new example-app

php artisan serve

Composerのシステム全体のvendor/binディレクトリを$PATHに配置して、システムでlaravel実行可能ファイルが見つかるようにしてください。このディレクトリは、オペレーティングシステムに基づいてさまざまな場所に存在します。ただし、一般的には以下の場所にあります。

  • macOS: $HOME/.composer/vendor/bin
  • Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
  • GNU/Linuxディストリビューション: $HOME/.config/composer/vendor/binもしくは$HOME/.composer/vendor/bin

初期設定

Laravelフレームワークのすべての設定ファイルは、configディレクトリに保存されます。各オプションはコメントで説明してますので、ファイルを調べて使用可能なオプションをよく理解してください。

Laravelは最初から、追加の設定をほぼ必要としません。あなたは自由に開発を始めることができます!ただし、config/app.phpファイルとコメントを確認されることを推奨します。timezonelocaleなどのいくつかのオプションが含まれており、アプリケーションに合わせて変更したいはずです。

環境を元にした設定

Laravelの設定オプション値の多くは、アプリケーションがローカルコンピューターで実行されているか、本番Webサーバーで実行されているかにより別の値にする場合があるため、多くの重要な設定値をアプリケーションのルートにある.envファイルを使用して定義しています。

アプリケーションを使用する開発者/サーバーごとに異なる環境設定が必要になる可能性があるため、.envファイルをアプリケーションのソース管理へコミットしないでください。さらに、機密性の高い資格情報が公開されるため、侵入者がソース管理リポジトリにアクセスした場合のセキュリティリスクになります。

Tip!! .envファイルと環境ベースの設定の詳細については、完全な設定ドキュメントで確認してください。

次のステップ

Laravelプロジェクトを設定し終えて、次に何を学ぶべきか迷っているかもしれません。まず、以下のドキュメントを読み、Laravelの仕組みを理解することを強く推奨いたします。

Laravelをどのように使用するかにより、旅の次の行き先も決まります。Laravelを使用するにはさまざまな方法があります。以下では、フレームワークの2つの主要なユースケースについて説明します。

Laravelフルスタックフレームワーク

Laravelはフルスタックフレームワークとして機能します。「フルスタック」フレームワークとは、Laravelを使用してリクエストをアプリケーションにルーティングし、Bladeテンプレートを介して、もしくはInertia.jsのようなシングルページアプリケーションハイブリッド技術を使用してフロントエンドをレンダーすることを意味します。これは、Laravelフレームワークが利用される、最も一般的な方法です。

Laravelをこの方法で使用しようと計画している場合は、ルーティングビュー 、またはEloquent ORMに関するドキュメントを確認するのが良いでしょう。さらに、LivewireInertia.jsなどのコミュニティパッケージについて学ぶこともできます。これらのパッケージを使用すると、Laravelをフルスタックフレームワークとして使用しながら、単一ページのJavaScriptアプリケーションによって提供されるUIの利点の多くを享受できます。

Laravelをフルスタックフレームワークとして使用する場合は、Laravel Mixを使用してアプリケーションのCSSとJavaScriptをコンパイルする方法を学ぶことも強くおすすめします。

Tip!! アプリケーションの構築をすぐに始めたい場合は、公式のアプリケーションスターターキットの1つをチェックしてください。

Laravel APIバックエンド

Laravelは、JavaScriptシングルページアプリケーションまたはモバイルアプリケーションへのAPIバックエンドとしても機能させることもあります。たとえば、Next.jsアプリケーションのAPIバックエンドとしてLaravelを使用できます。こうした使い方では、Laravelでアプリケーションに認証とデータの保存/取得を提供すると同時に、キュー、メール、通知などのLaravelの強力なサービスを利用できます。

この方法でLaravelの使用を計画している場合は、ルーティングLaravel SanctumEloquent ORMに関するドキュメントを確認することをお勧めします。

ドキュメント章別ページ

ヘッダー項目移動

注目:アイコン:ページ内リンク設置(リンクがないヘッダーへの移動では、リンクがある以前のヘッダーのハッシュをURLへ付加します。

移動

クリックで即時移動します。

設定

適用ボタンクリック後に、全項目まとめて適用されます。

カラーテーマ
和文指定 Pagination
和文指定 Scaffold
Largeスクリーン表示幅
インデント
本文フォント
コードフォント
フォント適用確認

フォントの指定フィールドから、フォーカスが外れると、当ブロックの内容に反映されます。EnglishのDisplayもPreviewしてください。

フォント設定時、表示に不具合が出た場合、当サイトのクッキーを削除してください。

バックスラッシュを含むインライン\Code\Blockの例です。

以下はコードブロックの例です。

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * ユーザに関連する電話レコードを取得
     */
    public function phone()
    {
        return $this->hasOne('App\Phone');
    }
}

設定を保存する前に、表示が乱れないか必ず確認してください。CSSによるフォントファミリー指定の知識がない場合は、フォントを変更しないほうが良いでしょう。

キーボード・ショートカット

オープン操作

PDC

ページ(章)移動の左オフキャンバスオープン

HA

ヘッダー移動モーダルオープン

MS

移動/設定の右オフキャンバスオープン

ヘッダー移動

T

最初のヘッダーへ移動

E

最後のヘッダーへ移動

NJ

次ヘッダー(H2〜H4)へ移動

BK

前ヘッダー(H2〜H4)へ移動

その他

?

このヘルプページ表示
閉じる