Laravel 13 正式发布 使用 Laravel AI 无缝平滑升级
Laravel 13 已正式发布。本次版本将 PHP 8.3 作为最低版本要求，并遵循 Laravel 标准支持周期：Bug 修复支持至 2027 年第三季度，安全更新支持至 2028 年第一季度。
本次发布周期的重点在于尽量减少破坏性变更。与此同时，我们专注于在全年持续交付不影响现有应用的体验优化改进。
Laravel12 升级请查看对应的Laravel 中文文档 - 升级指南
PHP 8.3 成为最低版本要求
Laravel 13 放弃了对 PHP 8.2 的支持，现在要求 PHP 8.3 或更高版本。
PHP 8.3 带来了类型化类常量、改进的 json_validate()、只读属性增强以及 JIT 优化。Laravel 13 同步移除了原本仅为兼容 PHP 8.2 而保留的 polyfill 和向后兼容代码，使框架更精简、更快速。
对 PHP Attributes 的一等支持
这是 Laravel 13 面向开发者最大的改进：在框架多个位置引入了原生 PHP Attributes 语法。
php
// 模型示例
#[Table('users', key: 'user_id', keyType: 'string', incrementing: false)]
#[Hidden(['password'])]
#[Fillable(['name', 'email'])]
class User extends Model {}此前需要通过类属性配置的行为，现在可以直接用 Attribute 内联声明：
- 模型（Models）
- 队列任务（Jobs）
- 控制台命令（Console commands）
- 以及 15 处以上其他位置
该功能完全可选，且向后兼容，现有代码无需修改。
Laravel AI SDK
Laravel 13 引入了官方出品的 Laravel AI SDK，提供统一 API，涵盖文本生成、工具调用 Agent、Embeddings、音频、图像以及向量存储集成。该 SDK 随 Laravel 13 正式从 Beta 转为稳定版，具备完整的队列支持、错误处理以及符合 Laravel 惯例的 API 设计。
JSON:API Resources
Laravel 现在内置了官方 JSON:API Resources，可以方便地返回符合 JSON:API 规范的响应。
JSON:API Resources 处理资源对象序列化、关联关系包含（relationship inclusion）、稀疏字段集（sparse fieldsets）、链接（links）以及符合 JSON:API 规范的响应头。
Queue Routing
Laravel 13 通过 Queue::route(...) 支持按 Job 类名进行队列路由，可以在统一位置为特定 Job 定义默认的队列和连接规则：
php
Queue::route(ProcessPodcast::class, connection: 'redis', queue: 'podcasts');语义搜索 / 向量搜索
Laravel 13 内置了原生向量查询支持、Embedding 工作流，以及跨搜索、查询构造器和 AI SDK 的相关 API。
这些功能让基于 PostgreSQL + pgvector 构建 AI 驱动的搜索体验变得直接，包括针对字符串直接生成 Embedding 并进行相似度搜索。
例如，可以直接通过查询构造器运行语义相似度搜索：
php
$documents = DB::table('documents')
->whereVectorSimilarTo('embedding', 'Best wineries in Napa Valley')
->limit(10)
->get();Cache::touch()
新增了 Cache::touch() 方法，可以在不读取或重新写入缓存值的情况下延长 TTL：
php
// 按秒延长
Cache::touch('user_session:123', 3600);
// 按 DateTime 延长
Cache::touch('analytics_data', now()->addHours(6));
// 永久延长
Cache::touch('report_cache', null);此前延长 TTL 需要先 get 再 put，会造成不必要的网络传输。Cache::touch() 跳过了这一环节------Redis 使用单条 EXPIRE 命令，Memcached 使用 TOUCH，数据库驱动执行单条 UPDATE。
该方法成功时返回 true，键不存在时返回 false。已在所有缓存驱动中实现：Array、APC、Database、DynamoDB、File、Memcached、Memoized、Null 和 Redis。
该特性对滑动会话过期、活跃订阅窗口、热门仪表盘数据、API 速率限制窗口等高频延期场景尤为实用。
Reverb 数据库驱动：不依赖 Redis 的实时通信
此前，横向扩展 Laravel Reverb 需要 Redis 作为消息代理。Laravel 13 引入了数据库驱动，允许使用现有的 MySQL 或 PostgreSQL 数据库实现横向扩展，无需额外部署 Redis。
Passkey 认证
Passkey（基于 WebAuthn 的无密码认证）现已集成至 Laravel 的 Starter Kits 和 Fortify。用户可通过生物识别（Face ID、指纹）或硬件密钥完成认证，无需密码。新建的 Laravel 13 应用开箱即用，无需第三方包。
Teams 支持回归 Starter Kits
Jetstream 曾提供团队多租户功能，但新版 Starter Kits 中缺失了这一支持。Laravel 13 将基于团队的多租户功能带回官方 Starter Kits，实现更简洁，优于 Jetstream 的旧方案。
其他改进
MySQL DELETE...JOIN 支持 ORDER BY / LIMIT
Laravel 的 MySQL 语法编译器现在支持完整的 DELETE...JOIN 查询，包含 ORDER BY 和 LIMIT 子句。此前这两个子句会被静默忽略，开发者不得不为复杂删除操作编写原始 SQL。
HTTP Pool 并发默认值修复
此前 Http::pool() 的并发数默认为 null，导致池中的请求实际串行执行------这是一个容易忽视的陷阱。Laravel 13 将默认并发数调整为 2，确保池化请求开箱即用地并发执行。
Symfony 7.4 和 8.0 支持
Laravel 13 支持 Symfony 7.4 和 8.0，保持依赖链的现代化与前瞻性。
Laravel 13 支持时间线
遵循 Laravel 既定的支持策略，Laravel 13 将接受 Bug 修复至 2027 年第三季度，安全更新至 2028 年第一季度：
| 版本 | PHP (*) | 发布时间 | Bug 修复至 | 安全修复至 |
|---|---|---|---|---|
| 10 | 8.1 - 8.3 | 2023 年 2 月 14 日 | 2024 年 8 月 6 日 | 2025 年 2 月 4 日 |
| 11 | 8.2 - 8.4 | 2024 年 3 月 12 日 | 2025 年 9 月 3 日 | 2026 年 3 月 12 日 |
| 12 | 8.2 - 8.5 | 2025 年 2 月 24 日 | 2026 年 8 月 13 日 | 2027 年 2 月 24 日 |
| 13 | 8.3 - 8.5 | 2026 年第一季度 | 2027 年第三季度 | 2028 年第一季度 |
Laravel 12 于 2025 年 2 月 24 日发布，将继续接受：
- Bug 修复至 2026 年 8 月 13 日
- 安全修复至 2027 年 2 月 24 日
升级到 Laravel 13
Laravel 13 提供了多种升级方式。
使用 Laravel Boost（AI 辅助升级）
Laravel Boost 是 Laravel 官方出品的 MCP Server，为 AI 编程助手提供引导式升级提示。在任意 Laravel 12 项目中安装后，在 Claude Code、Cursor、OpenCode、Gemini 或 VS Code 中执行 /upgrade-laravel-13 斜杠命令，即可开始升级流程。
使用 Laravel Shift（自动化 PR）
Laravel Shift 会为你打开一个 PR，提供结构清晰的原子提交，几次点击即可完成审查。
手动升级
手动升级时，需在 composer.json 中更新以下依赖：
json
"laravel/framework": "^13.0",
"laravel/tinker": "^3.0",
"phpunit/phpunit": "^12.0",
"pestphp/pest": "^4.0"