Laravel 13.x リリースノート

バージョニング規約Versioning Scheme

Laravelとファーストパーティパッケージは、セマンティックバージョニングにしたがっています。メジャーなフレームのリリースは、毎年（第１四半期に）リリースします。マイナーとパッチリリースはより頻繁に毎週リリースします。マイナーとパッチリリースは、決してブレーキングチェンジを含みませんLaravel and its other first-party packages follow Semantic Versioning[https://semver.org]. Major framework releases are released every year (~Q1), while minor and patch releases may be released as often as every week. Minor and patch releases should never contain breaking changes.

アプリケーションやパッケージからLaravelフレームワークやそのコンポーネントを参照する場合、Laravelのメジャーリリースには互換性のない変更が含まれるため、常に^13.0のようなバージョン制約を使用してください。しかしながら、私たちは常に１日以内に新しいメジャーリリースへ更新できるように努めています。When referencing the Laravel framework or its components from your application or package, you should always use a version constraint such as ^13.0, since major releases of Laravel do include breaking changes. However, we strive to always ensure you may update to a new major release in one day or less.

名前付き引数Named Arguments

名前付き引数は、Laravelの下位互換性ガイドラインの対象外です。Laravelコードベースを改善するために、必要に応じて関数の引数の名前を変更することもできます。したがって、Laravelメソッドを呼び出すときに名前付き引数を使用する場合は、パラメータ名が将来変更される可能性があることを理解した上で、慎重に行う必要があります。Named arguments[https://www.php.net/manual/en/functions.arguments.php#functions.named-arguments] are not covered by Laravel's backwards compatibility guidelines. We may choose to rename function arguments when necessary in order to improve the Laravel codebase. Therefore, using named arguments when calling Laravel methods should be done cautiously and with the understanding that the parameter names may change in the future.

サポートポリシーSupport Policy

Laravelのすべてのリリースは、バグフィックスは１８ヶ月、セキュリティフィックスは２年です。その他の追加ライブラリでは、最新のメジャーリリースのみでバグフィックスを受け付けています。また、Laravelがサポートするデータベースのサポートについても確認してください。For all Laravel releases, bug fixes are provided for 18 months and security fixes are provided for 2 years. For all additional libraries, only the latest major release receives bug fixes. In addition, please review the database versions supported by Laravel[/docs/{{version}}/database#introduction].

(*) 対応PHPバージョン(*) Supported PHP versions

Laravel 13Laravel 13

Laravel 13は、AIネイティブのワークフロー、より強力なデフォルト設定、そしてより表現力豊かな開発者向けAPIに焦点を当て、Laravelの年次リリースサイクルを継続しています。このリリースには、ファーストパーティのAIプリミティブ、JSON:APIリソース、セマンティック／ベクトル検索機能が含まれており、キュー、キャッシュ、セキュリティにわたって段階的な改善が行われています。Laravel 13 continues Laravel's annual release cadence with a focus on AI-native workflows, stronger defaults, and more expressive developer APIs. This release includes first-party AI primitives, JSON:API resources, semantic / vector search capabilities, and incremental improvements across queues, cache, and security.

最低限のブレイキングチェンジMinimal Breaking Changes

このリリースサイクルでは、ブレイキングチェンジを最小限に抑えることに重点を置いてきました。その代わりに、既存のアプリケーションを壊さないようなクオリティ・オブ・ライフの改善を年間を通して継続的に行うことに専念してきました。Much of our focus during this release cycle has been minimizing breaking changes. Instead, we have dedicated ourselves to shipping continuous quality-of-life improvements throughout the year that do not break existing applications.

したがって、Laravel 13のリリースは、労力の面では比較的小規模なアップグレードでありながら、実質的な新機能を提供しています。このため、ほとんどのLaravelアプリケーションは、アプリケーションコードを大きく変更することなく、Laravel 13へアップグレードできるでしょう。Therefore, the Laravel 13 release is a relatively minor upgrade in terms of effort, while still delivering substantial new capabilities. In light of this, most Laravel applications may upgrade to Laravel 13 without changing much application code.

PHP8.3PHP 8.3

Laravel13.xは、最低でもPHP8.3のバージョンを必要とします。Laravel 13.x requires a minimum PHP version of 8.3.

Laravel AI SDKLaravel AI SDK

Laravel13では、ファーストパーティのLaravel AI SDKが導入され、テキスト生成、ツール呼び出しエージェント、埋め込み、オーディオ、画像、およびベクトルストア統合のための統一されたAPIを提供します。Laravel 13 introduces the first-party Laravel AI SDK[https://laravel.com/ai], providing a unified API for text generation, tool-calling agents, embeddings, audio, images, and vector-store integrations.

AI SDKを使用すると、一貫したLaravelネイティブの開発者体験を維持しながら、プロバイダに依存しないAI機能を構築できます。With the AI SDK, you can build provider-agnostic AI features while keeping a consistent, Laravel-native developer experience.

たとえば、基本的なエージェントは１回の呼び出しでプロンプトを実行できます。For example, a basic agent can be prompted with a single call:

use App\Ai\Agents\SalesCoach;

$response = SalesCoach::make()->prompt('Analyze this sales transcript...');

return (string) $response;

Laravel AI SDKは、画像、オーディオ、埋め込みを生成することもできます。The Laravel AI SDK can also generate images, audio, and embeddings:

画像生成のユースケースでは、このSDKは簡単な言葉のプロンプトから画像を生成するためのクリーンなAPIを提供します。For visual generation use cases, the SDK offers a clean API for creating images from plain-language prompts:

use Laravel\Ai\Image;

$image = Image::of('A donut sitting on the kitchen counter')->generate();

$rawContent = (string) $image;

音声体験については、アシスタント、ナレーション、アクセシビリティ機能のために、テキストから自然な響きのオーディオを合成できます。For voice experiences, you can synthesize natural-sounding audio from text for assistants, narrations, and accessibility features:

use Laravel\Ai\Audio;

$audio = Audio::of('I love coding with Laravel.')->generate();

$rawContent = (string) $audio;

また、セマンティック検索や検索ワークフローのために、文字列から直接埋め込みを生成できます。And for semantic search and retrieval workflows, you can generate embeddings directly from strings:

use Illuminate\Support\Str;

$embeddings = Str::of('Napa Valley has great wine.')->toEmbeddings();

JSON:APIリソースJSON:API Resources

LaravelはファーストパーティのJSON:APIリソースを含むようになり、JSON:API仕様に準拠したレスポンスを簡単に返せるようになりました。Laravel now includes first-party JSON:API resources[/docs/{{version}}/eloquent-resources#jsonapi-resources], making it straightforward to return responses compliant with the JSON:API specification.

JSON:APIリソースは、リソースオブジェクトのシリアライズ、リレーションの含め方（inclusion）、特定のフィールドのみの取得（sparse fieldsets）、リンク、およびJSON:API準拠のレスポンスヘッダを処理します。JSON:API resources handle resource object serialization, relationship inclusion, sparse fieldsets, links, and JSON:API-compliant response headers.

リクエストフォージェリ保護Request Forgery Protection

セキュリティ面では、Laravelのリクエストフォージェリ保護ミドルウェアを強化し、PreventRequestForgeryとして正式に定義しました。これにより、トークンベースのCSRF保護との互換性を保ちつつ、オリジンを認識したリクエスト検証を追加しました。For security, Laravel's request forgery protection[/docs/{{version}}/csrf#preventing-csrf-requests] middleware has been enhanced and formalized as PreventRequestForgery, adding origin-aware request verification while preserving compatibility with token-based CSRF protection.

キューのルート指定Queue Routing

Laravel 13で、Queue::route(...)によるクラスごとのキューのルート指定を追加しました。これにより、特定のジョブに対するデフォルトのキュー／接続のルート指定ルールを一箇所で定義できます。Laravel 13 adds queue routing by class[/docs/{{version}}/queues#queue-routing] via Queue::route(...), allowing you to define default queue / connection routing rules for specific jobs in a central place:

Queue::route(ProcessPodcast::class, connection: 'redis', queue: 'podcasts');

PHP属性の拡張Expanded PHP Attributes

Laravel 13では、フレームワーク全体でファーストパーティのPHP属性のサポートを引き続き拡大しており、一般的な設定や動作に関する関心をより宣言的にし、クラスやメソッドと同じ場所に配置できるようになりました。Laravel 13 continues to expand first-party PHP attribute support across the framework, making common configuration and behavioral concerns more declarative and colocated with your classes and methods.

注目すべき追加要素には、#[Middleware]や#[Authorize]のようなコントローラおよび認可属性のほか、#[Tries]、#[Backoff]、#[Timeout]、#[FailOnTimeout]といったキュー指向のジョブ制御を含みます。Notable additions include controller and authorization attributes like #[Middleware][/docs/{{version}}/controllers#controller-middleware] and #[Authorize][/docs/{{version}}/controllers#authorize-attribute], as well as queue-oriented job controls like #[Tries][/docs/{{version}}/queues#max-job-attempts-and-timeout], #[Backoff][/docs/{{version}}/queues#dealing-with-failed-jobs], #[Timeout][/docs/{{version}}/queues#max-job-attempts-and-timeout], and #[FailOnTimeout][/docs/{{version}}/queues#failing-on-timeout].

たとえば、コントローラのミドルウェアやポリシーのチェックを、クラスやメソッドに直接宣言できるようになりました。For example, controller middleware and policy checks can now be declared directly on classes and methods:

<?php

namespace App\Http\Controllers;

use App\Models\Comment;
use App\Models\Post;
use Illuminate\Routing\Attributes\Controllers\Authorize;
use Illuminate\Routing\Attributes\Controllers\Middleware;

#[Middleware('auth')]
class CommentController
{
    #[Middleware('subscribed')]
    #[Authorize('create', [Comment::class, 'post'])]
    public function store(Post $post)
    {
        // ...
    }
}

さらに、Eloquent、イベント、通知、バリデーション、テスト、およびリソースシリアライズAPI全体でも追加の属性を導入し、フレームワークのより多くの領域で一貫した属性優先のオプションが選択できるようになりました。Additional attributes have also been introduced across Eloquent, events, notifications, validation, testing, and resource serialization APIs, giving you a consistent attribute-first option in more areas of the framework.

キャッシュTTLの延長Cache TTL Extension

LaravelにCache::touch(...)を導入しました。これにより、既存のキャッシュアイテムの値を再取得して保存し直すことなく、そのTTLを延長できます。Laravel now includes Cache::touch(...)[/docs/{{version}}/cache], which lets you extend an existing cache item's TTL without retrieving and re-storing its value.

セマンティック／ベクトル検索Semantic / Vector Search

Laravel 13は、ネイティブのベクトルクエリサポート、埋め込みワークフロー、および検索、クエリ、AI SDKのドキュメントに記載している関連APIにより、セマンティック検索の機能を強化しています。Laravel 13 deepens its semantic search story with native vector query support, embedding workflows, and related APIs documented across search[/docs/{{version}}/search#semantic-vector-search], queries[/docs/{{version}}/queries#vector-similarity-clauses], and the AI SDK[/docs/{{version}}/ai-sdk#embeddings].

これらの機能により、PostgreSQL+pgvectorを使用して、文字列から直接生成した埋め込みに対する類似性検索を含む、AI駆動の検索体験を簡単に構築できます。These features make it straightforward to build AI-powered search experiences using PostgreSQL + pgvector, including similarity search against embeddings generated directly from strings.

たとえば、クエリビルダから直接セマンティック類似性検索を実行できます。For example, you may run semantic similarity searches directly from the query builder:

$documents = DB::table('documents')
    ->whereVectorSimilarTo('embedding', 'Best wineries in Napa Valley')
    ->limit(10)
    ->get();