Laravel 13正式发布后,如何使用Laravel AI实现无缝平滑升级?
摘要:Laravel 13 正式发布 使用 Laravel AI 无缝平滑升级 Laravel 13 已正式发布。本次版本将 PHP 8.3 作为最低版本要求,并遵循 Laravel 标准支持周期:Bug 修复支持至 2027 年第三季度,安全更
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 语法。
// 模型示例
#[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 定义默认的队列和连接规则:
Queue::route(ProcessPodcast::class, connection: 'redis', queue: 'podcasts');
语义搜索 / 向量搜索
Laravel 13 内置了原生向量查询支持、Embedding 工作流,以及跨搜索、查询构造器和 AI SDK 的相关 API。
这些功能让基于 PostgreSQL + pgvector 构建 AI 驱动的搜索体验变得直接,包括针对字符串直接生成 Embedding 并进行相似度搜索。
例如,可以直接通过查询构造器运行语义相似度搜索:
$documents = DB::table('documents')
->whereVectorSimilarTo('embedding', 'Best wineries in Napa Valley')
->limit(10)
->get();
Cache::touch()
新增了 Cache::touch() 方法,可以在不读取或重新写入缓存值的情况下延长 TTL:
// 按秒延长
Cache::touch('user_session:123', 3600);
// 按 DateTime 延长
Cache::touch('analytics_data', now()->addHours(6));
// 永久延长
Cache::touch('report_cache', null);
此前延长 TTL 需要先 get 再 put,会造成不必要的网络传输。
