> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026年4月 Laravel アップデート

> 2026年4月のLaravelエコシステムアップデート。Passkeys（パスワードレス認証）、Debounceable Jobs、MCP UI App、Redis Cluster対応など。

2026年4月はフルスタックのパスワードレス認証がLaravelの標準機能となり、バースト的なジョブディスパッチを制御するDebounceableジョブ、MCP UIアプリのサポートなど実用的な機能が多数追加されました。

参照元：[Laravel April Product Updates](https://laravel.com/blog/laravel-april-product-updates)

***

## Laravel Framework

### Debounceable Queued Jobs

バースト的なワークロードに対するクリーンな解決策。`#[DebounceFor]`アトリビュートを使うと、指定時間内の複数ディスパッチを1つにまとめ、最後のディスパッチのみが実行されます。`ShouldBeUnique`の逆の発想で、デバウンスウィンドウ内の連続更新を効率化します。

```php theme={null}
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Queue\Attributes\DebounceFor;

#[DebounceFor(30)]
class RebuildSearchIndex implements ShouldQueue
{
    // ユーザーが30秒以内に10回ドキュメントを更新しても
    // インデックス再構築は1回だけ実行される
}

// 呼び出し側でもデバウンス可能（クラス変更不要）
RebuildSearchIndex::dispatch()->debounceFor(seconds: 30);
```

<Info>
  デバウンスされたジョブは`JobDebounced`イベントを発火するので、スキップされたジョブを可視化できます。
</Info>

### ヘルスルートのJSONレスポンス対応

APIのみのアプリで`/up`からHTMLをスクレイピングする必要がなくなりました。組み込みヘルスルートがJSONリクエストに対してJSONを返すようになります。

```json theme={null}
{ "status": "Application is up" }
```

ロードバランサー、アップタイムモニター、オーケストレーターの連携が簡単になります。設定変更は不要です。

### JsonFormatter

`JsonFormatter`により、カスタム例外の`context()`データが構造化ログに確実に記録されるようになりました。例外チェーン内の前の例外のコンテキストも含まれます。

```php theme={null}
// config/logging.php
'formatter' => Illuminate\Log\Formatters\JsonFormatter::class,
```

### prefersJsonResponses()

APIアプリで`bootstrap/app.php`に1行追加するだけで、広い`Accept`ヘッダーをJSONとして扱い、認証リダイレクト・バリデーションエラー・例外ページがクライアント向けに適切にシリアライズされます。

```php theme={null}
return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(...)
    ->prefersJsonResponses()
    ->create();
```

### Cloudflare Email Serviceサポート

CloudflareのEmail ServiceがLaravelのメーラーとして正式サポートされました。

```php theme={null}
// config/services.php
'cloudflare' => [
    'account_id' => env('CLOUDFLARE_ACCOUNT_ID'),
    'token' => env('CLOUDFLARE_TOKEN'),
],
```

### Redis Clusterの完全サポート

AWS ElastiCache ServerlessなどのRedis Cluster環境でのCROSSSLOTエラーが解消されました。Laravelのキュー、ConcurrencyLimiterがCluster接続を検出すると、キュー名を自動的にハッシュタグでラップします。

```
queues:{default}          # "default"スロット
queues:{default}:delayed  # 同じスロット
queues:{default}:reserved # 同じスロット
```

### Queue ジョブ検査メソッド

ジョブの内容をDBを直接覗かずに確認できる3つのメソッドが追加されました。

```php theme={null}
Queue::pendingJobs();   // 待機中のジョブ
Queue::delayedJobs();   // 遅延ジョブ
Queue::reservedJobs();  // 処理中のジョブ

// InspectedJobインスタンスにアクセス
Queue::reservedJobs('high-priority')->first()->name;
// => 'App\Jobs\SendEmail'
```

### Form Request Strict Mode

未宣言のフィールドがバリデーションを通過しないよう制御できます。`rules()`で宣言されていない受信フィールドはバリデーション失敗になります。

```php theme={null}
// AppServiceProvider
public function boot(): void
{
    FormRequest::failOnUnknownFields(! app()->isProduction());
}
```

***

## Passkeys（パスワードレス認証）

パスワードレス認証がファーストパーティのスタック全体で実現しました。

* **`laravel/passkeys`（サーバーサイド）**: マイグレーション、ログイン/確認/クレデンシャル管理のルート、WebAuthnアクション、イベントを提供
* **`@laravel/passkeys`（クライアントサイド）**: React・Vue・Svelteの各ヘルパーで、ブラウザのWebAuthnセレモニーを処理
* **Fortify統合**: `Features::passkeys()`で有効化するだけで、Fortifyアプリが同じエンドポイントと契約を利用可能

```php theme={null}
// config/fortify.php
'features' => [
    Features::passkeys(),
],
```

***

## MCP UI App サポート

MCPツールがテキストのみでなく、完全なサンドボックス化されたHTMLアプリをiframe内でレンダリングできるようになりました。

```bash theme={null}
php artisan make:mcp-app-resource DashboardApp
```

```php theme={null}
class DashboardApp extends AppResource
{
    #[RendersApp]
    public function handle(Request $request): Response
    {
        return Response::view('mcp.dashboard-app', [
            'title' => 'Dashboard',
        ]);
    }
}
```

***

## Inertia・エコシステム

* **`useHttp`フック**: `onHttpException`、`onNetworkError`コールバックが追加
* **Laravel Echo Svelte 5アダプター**: `useEcho` runeでSvelteからリアルタイム機能を利用可能
* **Dusk**: `clickOnceEnabled()`、`clickOnceVisible()`でフレイキーなテストを防止
* **Horizon**: Redis Clusterの完全サポート（AWS ElastiCache Serverless対応）
* **VS Code拡張**: Laravel 13の新アトリビュートのオートコンプリート・ホバー・ナビゲーション対応

***

## Laravel Cloud・Laravel Forge

| 製品                | 主なアップデート                                                      |
| ----------------- | ------------------------------------------------------------- |
| **Laravel Cloud** | モバイル対応のフルレスポンシブUI、エッジネットワーク強化（トップIP/パス表示、ファイアウォール・キャッシュルール変換） |
| **Laravel Forge** | PHP 8.5サポート、複数SSLサーバーのサポート、証明書更新アラート                          |