Release Notes

• Versioning Scheme
• Support Policy
• Laravel 13

Versioning Scheme

Laravel and its other first-party packages follow Semantic Versioning. 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.

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

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

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.

(*) 支持的 PHP 版本

Laravel 13

Laravel 13 延续了 Laravel 的年度发布节奏，重点聚焦 AI 原生工作流、更强的默认设置以及更具表现力的开发者 API。此版本包含第一方 AI 原语、JSON:API 资源、语义 / 向量搜索功能，并在队列、缓存和安全性方面带来了增量改进。

极少的破坏性变更

在此发布周期中，我们的主要精力放在了尽量减少破坏性变更上。相反，我们致力于全年持续交付不破坏现有应用的质量改进。

因此，Laravel 13 在升级所需的工作量上相对较小，同时仍提供了大量的新能力。有鉴于此，大多数 Laravel 应用可以在无需大量修改应用代码的情况下升级到 Laravel 13。

PHP 8.3

Laravel 13.x 要求最低 PHP 版本为 8.3。

Laravel AI SDK

Laravel 13 引入了第一方 Laravel AI SDK，为文本生成、工具调用代理、嵌入、音频、图像和向量存储集成提供了统一的 API。

借助 AI SDK，你可以构建与提供商无关的 AI 功能，同时保持一致的原生 Laravel 开发体验。

例如，一个基本代理可以通过一次调用进行提示：

use App\Ai\Agents\SalesCoach;

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

return (string) $response;

Laravel AI SDK 还可以生成图像、音频和嵌入：

对于视觉生成用例，SDK 提供了简洁的 API，可通过自然语言提示创建图像：

use Laravel\Ai\Image;

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

$rawContent = (string) $image;

JaguarJack 翻译于 3周前

0 重译

由 Labea 审阅

对于语音体验，你可以从文本中合成自然流畅的音频，用于语音助手、旁白和无障碍功能：

use Laravel\Ai\Audio;

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

$rawContent = (string) $audio;

对于语义搜索和检索工作流，你可以直接从字符串生成嵌入：

use Illuminate\Support\Str;

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

JSON:API 资源

Laravel 现在包含第一方 JSON:API 资源，可轻松返回符合 JSON:API 规范的响应。

JSON:API 资源负责处理资源对象序列化、关系包含、稀疏字段集、链接以及符合 JSON:API 的响应头。

请求伪造保护

在安全方面，Laravel 的请求伪造保护中间件已得到增强并正式命名为 PreventRequestForgery，增加了基于来源的请求验证，同时保持与基于令牌的 CSRF 保护兼容。

队列路由

Laravel 13 通过 Queue::route(...) 增加了按类进行队列路由的功能，允许你在一个中心位置为特定任务定义默认的队列 / 连接路由规则：

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

扩展的 PHP 属性

Laravel 13 继续在整个框架中扩展第一方 PHP 属性的支持，使常见的配置和行为关注点更具声明性，并与你的类和方法放在一起。

值得注意的新增内容有控制器和授权属性，如 #[Middleware] 和 #[Authorize]，以及面向队列的任务控制属性，如 #[Tries]、#[Backoff]、#[Timeout] 和 #[FailOnTimeout]。

JaguarJack 翻译于 3周前

0 重译

由 Labea 审阅

举个例子，现在你可以直接在类的方法中声明控制器中间件和策略检查了：

<?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 中同样可用，这为你提供了一个在框架更多地方可用的属性优先的选择。

缓存 TTL 扩展

Laravel 引入了 Cache::touch(...) 方法, 它使你可以延长现有的缓存项目而无需重新检索和存储。

语义化 /向量搜索

Laravel 13 运用原生支持的向量搜索, Embedding 工作流和 搜索，查询和 AI SDK 文档中相关的 API 深化其语义搜索功能。

这些功能使得基于 PostgreSQL + pgvector 构建 AI 赋能搜索的体验更简洁直接 ，比如对直接从字符串生成的 Embedding 进行相似性搜索。

比如，你可以直接从查询构造器发起语义相似性搜索：

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

laobinghu 翻译于 1周前

0 重译

由 JaguarJack 审阅