Laravel 13.x 中文文档

主题

发行说明 ​

版本方案 ​

Laravel 及其官方包遵循语义化版本控制。主要框架版本每年发布一次（约第一季度），而次要版本和补丁版本可能每周发布一次。次要版本和补丁版本绝不包含破坏性更改。

当从应用程序或包中引用 Laravel 框架或其组件时，应始终使用版本约束，如 ^13.0，因为 Laravel 的主要版本确实包含破坏性更改。但是，我们努力确保您可以在一天或更短的时间内升级到新的主要版本。

命名参数 ​

命名参数不在 Laravel 的向后兼容性指南范围内。我们可能会在必要时选择重命名函数参数以改进 Laravel 代码库。因此，在调用 Laravel 方法时应谨慎使用命名参数，并理解参数名称将来可能会更改。

支持政策 ​

对于所有 Laravel 版本，错误修复提供 18 个月，安全修复提供 2 年。对于所有其他库，只有最新的主要版本才会收到错误修复。此外，请查看 Laravel 支持的数据库版本。

版本PHP (*)发布日期错误修复截止日期安全修复截止日期
108.1 - 8.32023年2月14日2024年8月6日2025年2月4日
118.2 - 8.42024年3月12日2025年9月3日2026年3月12日
128.2 - 8.52025年2月24日2026年8月13日2027年2月24日
138.3 - 8.52026年第一季度2027年第三季度2028年第一季度
生命周期结束
仅安全修复

(*) 支持的 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 原生的开发体验。

例如，可以通过单次调用提示基本智能体：

php
use App\Ai\Agents\SalesCoach;

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

return (string) $response;

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

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

php
use Laravel\Ai\Image;

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

$rawContent = (string) $image;

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

php
use Laravel\Ai\Audio;

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

$rawContent = (string) $audio;

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

php
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(...) 添加了按类路由队列，允许您在中心位置为特定任务定义默认队列/连接路由规则：

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

扩展的 PHP 属性 ​

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

值得注意的添加包括控制器和授权属性，如 #[Middleware] 和 #[Authorize]，以及面向队列的任务控制，如 #[Tries]、#[Backoff]、#[Timeout] 和 #[FailOnTimeout]。

例如，控制器中间件和策略检查现在可以直接在类和方法上声明：

php
<?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(...)，它允许您扩展现有缓存项的 TTL，而无需检索和重新存储其值。

语义/向量搜索 ​

Laravel 13 通过原生向量查询支持、嵌入工作流程和相关 API 深化了其语义搜索能力，这些功能在搜索、查询和 AI SDK 中有文档记录。

这些功能使使用 PostgreSQL + pgvector 构建 AI 驱动的搜索体验变得简单，包括对直接从字符串生成的嵌入向量进行相似性搜索。

例如，您可以直接从查询构建器运行语义相似性搜索：

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