はじめに
Laravel Folioは、Bladeファイルを配置するだけでルートを定義できるページベースのルーターです。
従来の routes/web.php 中心の定義と違い、ファイルシステムの構造をそのままURLに反映できます。
コンテンツ中心のサイトや、画面ごとに素早くページを追加したい管理画面で特に有効です。
APIのように細かいHTTP制御が必要な領域は、通常のルーティングと併用するのが実践的です。
インストール
まずはComposerでFolioを追加します。
composer require laravel/folio
php artisan folio:install
folio:install はFolioのサービスプロバイダーを登録します。
デフォルトでは resources/views/pages/ がページディレクトリになります。
複数のページディレクトリやベースURIを使い分ける場合は、サービスプロバイダーの boot で Folio::path() と uri() を設定します。
use Laravel\Folio\Folio;
Folio::path(resource_path('views/pages/guest'))->uri('/');
Folio::path(resource_path('views/pages/admin'))
->uri('/admin');
ルートの作成
Folioは、マウントされたディレクトリ配下のBladeファイル名からURLを自動生成します。
resources/views/pages/schedule.blade.php -> /schedule
ネストされたルート
ディレクトリをネストすると、URLも同じ構造でネストされます。
php artisan folio:page user/profile
# pages/user/profile.blade.php -> /user/profile
インデックスルート
index.blade.php は、そのディレクトリのルートにマッピングされます。
php artisan folio:page index
# pages/index.blade.php -> /
php artisan folio:page users/index
# pages/users/index.blade.php -> /users
ルートパラメーター
ファイル名の [] でURLセグメントを受け取れます。
php artisan folio:page "users/[id]"
# pages/users/[id].blade.php -> /users/1
<div>User {{ $id }}</div>
... を使います。
php artisan folio:page "users/[...ids]"
# pages/users/[...ids].blade.php -> /users/1/2/3
@foreach ($ids as $id)
<li>User {{ $id }}</li>
@endforeach
ルートモデルバインディング
[User].blade.php のようにモデル名を使うと、自動でモデル解決されます。
php artisan folio:page "users/[User]"
# pages/users/[User].blade.php -> /users/1
<div>User {{ $user->id }}</div>
withTrashed() を呼び出します。
<?php
use function Laravel\Folio\withTrashed;
withTrashed();
[Post:slug].blade.php のように書くと、id 以外のキー（例: slug）でもモデル解決できます。
ミドルウェア
特定ページにだけ適用する場合は、ページテンプレート内で middleware() を使います。
<?php
use function Laravel\Folio\middleware;
middleware(['auth', 'verified']);
Folio::path(...)->middleware() を使います。
<?php
use Laravel\Folio\Folio;
Folio::path(resource_path('views/pages'))->middleware([
'admin/*' => ['auth', 'verified'],
]);
名前付きルート
Folioページにも name() でルート名を付けられます。
<?php
use function Laravel\Folio\name;
name('users.index');
users/[User].blade.php のような個別ページ側で name('users.show') を定義すると、パラメーター付きURLを route('users.show', ['user' => $user]) で生成できます。
route() ヘルパーでURL生成できます。
route('users.index');
route('users.show', ['user' => $user]);
ファイルとURLの対応
従来のルーティングとの比較
| 特徴 | 通常ルーティング | Folio |
|---|
| ルート定義 | routes/web.php | ファイル名で自動 |
| コントローラー | 必要（またはクロージャ） | 不要（Bladeに直接） |
| 向いているケース | APIやSPA、複雑なHTTP制御 | コンテンツサイト、管理画面 |
Folioを使う場合でも、php artisan route:cache でルートキャッシュを有効にすると本番性能を最適化できます。
