Laravelのドキュメント完全ガイド｜公式ドキュメントの読み方・日本語版・バージョン選択と自作ドキュメント生成

「Laravel ドキュメント」で検索する目的は、大きく2つに分かれます。ひとつはLaravel本体の公式ドキュメント（laravel.com/docs）を読みたいケース、もうひとつは自分のLaravelプロジェクトの仕様書やAPIドキュメントを作りたいケースです。本記事はこの両方を扱います。前半で公式ドキュメントの構成・日本語で読む方法・バージョンの選び方・効率的な調べ方を、後半でScribeやLaRecipeといった実在ツールでの自作ドキュメント生成を、Laravel 13（2026年3月17日リリース）時点の情報で整理します。

まとめ

• 公式ドキュメントは laravel.com/docs にあり、URLの /docs/13.x/ の部分でバージョンを切り替える。自分が使うLaravelのバージョンに合わせて読むのが鉄則。
• 日本語で読むなら ReaDouble（readouble.com）。公式は英語のみで、ReaDoubleは有志による非公式翻訳。訳が古い箇所は英語版と突き合わせる。
• 自分のAPI仕様書を自動生成するなら Scribe（非推奨になった laravel-apidoc-generator の後継）。アプリ内にMarkdownで手書きするなら LaRecipe、コードのリファレンスは phpDocumentor。
• 目的が「読む」のか「作る」のかで使うものが変わる。まず自分の目的を切り分ける。

以下、公式ドキュメントの読み方から順に見ていきます。

Laravelの「ドキュメント」が指す2つの対象

混同しやすいのが、Laravel本体の公式ドキュメントと、自分のアプリのために作るドキュメントの違いです。前者は言語やフレームワークの使い方を調べる読み物、後者はプロジェクトのAPI仕様や社内手順を残す成果物で、必要な道具がまったく異なります。

重要な前提として、Laravel本体にドキュメントを自動生成する機能はありません。生成にはScribeなど第三者パッケージを使います。組み込みで用意されているのはルート一覧を出す php artisan route:list 程度で、これは登録済みルートの一覧確認には便利ですが、仕様書そのものを作るものではありません。なおLaravel 13ではAPIレスポンスを標準化する一次サポートのJSON:APIリソースが加わりましたが、これもドキュメント生成機能ではありません。

Laravel公式ドキュメントの読み方と入手先

公式サイト（laravel.com/docs）の構成とバージョン切り替え

公式ドキュメントは laravel.com/docs に集約され、左サイドバーが Prologue（前書き）、Getting Started（導入）、Architecture Concepts（アーキテクチャ）、The Basics（基礎）、Digging Deeper（応用）、Security、Database、Eloquent ORM、AI、Testing、Packages の順に並びます。初学者はGetting StartedとThe Basicsだけで一通り動かせます。

URLは /docs/13.x/routing のようにバージョン番号が入る形式で、ページ上部のバージョン切り替えドロップダウンから /docs/12.x/ など過去バージョンへ移動できます。Laravel 13はPHP 8.3〜8.5に対応するため、古いPHP環境の場合は自分の環境で動く版のドキュメントを開く必要があります。

日本語で読むReaDoubleとlaravel-ja翻訳プロジェクト

公式ドキュメントは英語のみで、日本語の公式版はありません。日本語で読む定番が ReaDouble（readouble.com）で、川瀬裕久氏がLaravel 3の頃から継続している非公式の翻訳です。13.xから4.2まで各バージョンを網羅し、サイト内のバージョン切り替えで対応する版の日本語訳を開けます。

翻訳の元になっているのが laravel-ja のGitHubリポジトリ群（ja-docs-13.x など版ごとに分かれる）で、こちらも活発に更新されています。ただしあくまで有志翻訳のため、新しい機能や細かい仕様は英語版への反映が先です。訳文で意味が取りにくい箇所や最新の追加機能は、同じページの英語版を開いて突き合わせるのが安全です。

自分のLaravelバージョンに合ったドキュメントを選ぶ

ドキュメント選びで最も事故が多いのが、環境と違う版を読んでしまうことです。Laravelはメジャー版を毎年およそ第1四半期にリリースし、各版のサポートはバグ修正18ヶ月・セキュリティ修正2年です。Laravel 13のセキュリティ修正は2028年3月17日まで、Laravel 11は2026年3月12日で終了しています。

最新版のドキュメントに載っている書き方を、サポートの切れた古い環境へそのまま適用してはいけません。まず php artisan --version で自分のプロジェクトの版を確認し、その番号に一致するドキュメントを開くのが原則です。バージョンをまたいで挙動が変わる代表例がミドルウェアやスターターキットまわりで、Laravel Breeze・Jetstreamのスターターキットの扱いの変化のように、版が変われば推奨される作法自体が変わります。

公式ドキュメントを効率的に調べるコツ

目的別の入口の選び方

公式ドキュメントは分量が多いため、目的から入口を決めると速く辿り着けます。環境構築やディレクトリ構成を知りたいならGetting Started、ルーティング・コントローラ・ミドルウェアなど日常的に使う機能はThe Basics、キューやイベント・パッケージ開発などの踏み込んだ話題はDigging Deeperにまとまっています。認証・認可はSecurity、クエリビルダやマイグレーションはDatabaseとEloquent ORMが該当します。目次の見出し語で当たりを付けてから読むと、全文を追わずに済みます。

信頼できる情報源の優先順位

Laravelは更新が速く、個人ブログやAIの回答は古い版の書き方が混ざりがちです。情報の確度は、公式ドキュメント（laravel.com/docs）＞ ReaDouble（日本語・非公式訳）＞ コミュニティ記事の順で扱い、実装に落とす前に必ず公式へ戻って裏を取るのが安全です。特にコマンド名や設定キーは版によって変わるため、コピー元の記事がどの版を前提にしているかを確認します。

AIエージェントに開発を任せる場合は、公式が用意する Laravel Boost（composer require laravel/boost --dev）が、ベクトル化した公式ドキュメントをエージェントへ渡す仕組みを提供しています。人が読む場合とは別に、AI向けに公式情報を参照させる導線はLaravel Boostが担います。

自分のプロジェクトのドキュメントを生成・作成するツール

API仕様書を自動生成するScribe

公開APIの仕様書を自動生成する定番が Scribe（最新5.11.0・2026年6月）です。ルート定義とコントローラのコメントを読み取り、単一ページのHTMLドキュメント、Postmanコレクション、OpenAPI仕様（3.0.3／3.1.0）をまとめて出力します。導入は次の3コマンドです。

composer require knuckleswtf/scribe
php artisan vendor:publish --tag=scribe-config
php artisan scribe:generate

2つ目のコマンドで生成される config/scribe.php で出力形式や認証情報を調整します。動作要件はPHP 8.1・Laravel 9以上です。かつて広く使われた laravel-apidoc-generator は非推奨となり、公式に後継として案内されているのがこのScribeです。新規プロジェクトで古いlaravel-apidoc-generatorを採用する理由はありません。

アプリ内にMarkdownで書くLaRecipe

APIの自動生成ではなく、手順書やナレッジをMarkdownで手書きして残したいなら LaRecipe（最新2.9.1）が向きます。Vue＋Tailwindで作られた閲覧UIを持ち、書いたドキュメントはアプリの /docs で配信され、Markdownファイルをアプリと一緒にGit管理できます。

composer require binarytorch/larecipe
php artisan larecipe:install

ソースコードとドキュメントを同じリポジトリで版管理できるため、仕様変更とドキュメント更新のズレを抑えやすいのが利点です。

コードリファレンスを生成するphpDocumentor

クラスやメソッドのリファレンスをコードから起こしたい場合は、DocBlock（/** ... */ 形式のコメント）を読み取る phpDocumentor が定番です。PHP 8.1以上で動作し、API一覧やクラス図を生成できます。類似のDoctum（開発が止まったSamiのフォーク）も選択肢ですが、更新頻度はphpDocumentorのほうが高く、2026年時点で新規に選ぶならphpDocumentorが無難です。生成物の読みやすさはコメントの質に左右されるため、Laravelの命名規則を統一し、DocBlockを丁寧に書くことが前提になります。

用途別のツールの選び方

3つは競合ではなく用途が異なります。外部公開APIの仕様書ならScribe、社内手順書やナレッジならLaRecipe、ライブラリのコードリファレンスならphpDocumentor、と目的で選ぶのが最短です。

避けたいのは、非推奨のlaravel-apidoc-generatorを新規採用することと、手順書用途なのにAPI生成ツールを無理に使うことです。用途とツールを取り違えると、生成物のメンテナンスが破綻します。

よくある質問

Laravelの公式ドキュメントはどこで読めますか？

laravel.com/docs です。URLに /docs/13.x/ のようにバージョン番号が入り、ページ上部のドロップダウンで版を切り替えられます。まずGetting StartedとThe Basicsから読むと全体像をつかめます。日本語で読みたい場合は次項のReaDoubleを使います。

Laravelのドキュメントに日本語版はありますか？

公式の日本語版はありません。日本語で読む定番は非公式翻訳のReaDouble（readouble.com）で、13.xから4.2まで各版を網羅しています。有志翻訳のため最新機能は英語版が先行することがあり、訳が不明瞭な箇所は同じページの英語版と突き合わせるのが安全です。

古いバージョンのLaravelのドキュメントは見られますか？

見られます。laravel.com/docs のバージョン切り替えドロップダウンから /docs/12.x/ などへ移動できます。ReaDoubleも同様に過去版の日本語訳を提供します。ただしセキュリティ修正が終了した版（例：Laravel 11は2026年3月12日終了）は、参照はできても本番環境での継続利用は避けるべきです。

LaravelでAPI仕様書を自動生成するには？

Scribeを使います。composer require knuckleswtf/scribe で導入し、php artisan vendor:publish --tag=scribe-config で設定を公開、php artisan scribe:generate で生成します。HTMLドキュメント、Postmanコレクション、OpenAPI仕様が出力されます。

laravel-apidoc-generatorは今も使えますか？

非推奨です。作者自身が後継としてScribeを案内しており、Scribe側にも移行ガイドがあります。既存プロジェクトは移行を、新規プロジェクトは最初からScribeの採用を推奨します。

関連記事

• Laravel 13で正式安定版になったAI SDKの全体像と導入判断の前提知識
• Laravelの命名規則一覧：統一されたコードスタイルの重要性
• Laravel Breeze・Jetstreamはなぜ非推奨に？スターターキット（React/Vue/Livewire）への移行と代替案