> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026 年 3 月 Laravel 更新

> 2026 年 3 月的 Laravel 生态更新。Laravel 13 发布、AI SDK、JSON:API、Inertia v3 等大型更新汇总。

对 Laravel 生态而言,2026 年 3 月是历史性的一个月。**Laravel 13** 正式发布,同时公开了官方 AI SDK、JSON:API 资源、Inertia v3 等一大批重量级功能。

参考出处:[Laravel March Product Updates](https://laravel.com/blog/laravel-march-product-updates)

***

## Laravel Framework

### Laravel AI SDK

Laravel 13 引入了官方 AI SDK,为文本生成、工具调用智能体、嵌入、语音、图像、向量存储集成提供统一 API。你可以以一致的 Laravel 原生开发体验来构建不依赖具体供应商的 AI 功能。

```php theme={null}
use Laravel\Ai\Facades\Ai;

$response = Ai::text('gpt-4o')->generate('What is Laravel?');
```

### JSON:API 资源

Laravel 官方引入了 JSON:API 资源。现在可以轻松返回符合 JSON:API 规范的响应,自动处理资源对象的序列化、关联包含、稀疏字段集、链接以及符合 JSON:API 的响应头。

```php theme={null}
use Laravel\JsonApi\Resources\JsonApiResource;

class UserResource extends JsonApiResource
{
    public function toAttributes(Request $request): array
    {
        return [
            'name' => $this->name,
            'email' => $this->email,
        ];
    }
}
```

### 请求伪造防御强化

作为安全加固,CSRF 保护中间件被正式命名为 `PreventRequestForgery`。在保持与基于 Token 的 CSRF 保护兼容的同时,新增了基于 Origin 的请求校验。

### 队列路由

`Queue::route()` 支持按类维度的队列路由。可以集中管理特定作业的默认队列/连接路由规则。

```php theme={null}
Queue::route(ProcessPodcast::class, connection: 'redis', queue: 'podcasts');
```

### PHP 属性(Attribute)的扩充

Laravel 13 在整个框架中扩充了官方 PHP 属性支持。新增了控制器与认证相关的属性(如 `#[Middleware]`、`#[Authorize]` 等),让配置和行为可以更加声明式地表达。

```php theme={null}
use Illuminate\Routing\Attributes\Middleware;

class UserController extends Controller
{
    #[Middleware('auth')]
    public function index(): Response
    {
        // ...
    }
}
```

### Cache::touch()

新增 `Cache::touch()`,可以在不取回并重存值的情况下延长已有缓存项的 TTL。

```php theme={null}
Cache::touch('user-session', now()->addHour());
```

### 语义搜索 / 向量搜索

新增原生向量查询支持、嵌入工作流以及相关 API。可以轻松构建基于 PostgreSQL + pgvector 的 AI 驱动搜索。

***

## Inertia v3

### Vite 插件

有了新的 `@inertiajs/vite` 插件后,原来写在入口的样板代码就不再需要了。页面会从 `./Pages` 目录自动解析,代码分割与懒加载也会自动处理。SSR 也是零配置。

```bash theme={null}
npm install @inertiajs/vite --save-dev
```

### 开发时的 SSR

`npm run dev` 会自动启用 SSR。开发时不再需要另一个 Node.js 进程,页面默认就会进行服务端渲染。

### 移除 Axios

Axios 和 qs 已从 Inertia 的依赖中完全移除。所有 HTTP 通信由轻量的内置 XHR 客户端负责,包体积和依赖占用都得到削减。

<Info>
  如果你依赖 Axios 拦截器等功能,Axios 适配器在过渡期间会继续保持工作。
</Info>

### 乐观更新

新增 `.optimistic()` 方法,可以在不等待服务器响应的情况下立即更新 UI。

```javascript theme={null}
router.post('/posts', data, {
    optimistic: (currentProps) => ({
        posts: [...currentProps.posts, { ...data, id: 'temp' }],
    }),
});
```

### 即时访问

服务器请求在后台进行的同时,可以立即切换到目标页面组件。

***

## 其他包

### Prompts 新功能

* **`datatable()`**:支持表格数据浏览、搜索、选择的新提示
* **`title()`**:设置终端窗口标题
* **`stream()`**:AI 响应的实时流式显示
* **`task()`**:带 Spinner 的任务执行显示
* **`autocomplete()`**:输入自动补全提示
* **`notify()`**:macOS/Linux 原生桌面通知

### Passport

* **`#[TokenCan]` 属性**:直接在控制器方法上声明所需的 Token 作用域

```php theme={null}
class PhotoController
{
    #[TokenCan('read')]
    public function index() { /* ... */ }

    #[TokenCan('write')]
    public function store() { /* ... */ }
}
```

### Reverb

* **限流**:支持使用 Laravel 内置速率限制器进行每应用维度的限流

### Scout

* **`where()` 支持运算符**:查询构造器支持 `where('created_at', '>', $date)` 的写法

***

## Laravel Cloud / Laravel Forge

| 产品                | 主要更新                                            |
| ----------------- | ----------------------------------------------- |
| **Laravel Cloud** | 无需信用卡的 \$5 免费试用、GitHub SSO、定时自动扩缩容、用量页面重设计      |
| **Laravel Forge** | VPS 上支持 Managed PostgreSQL 数据库(带可观测性、只读副本、自动备份) |


## Related topics

- [2026 年 4 月 Laravel 更新](/zh/blog/changelog/202604.md)
- [2026 年 5 月 Laravel 更新](/zh/blog/changelog/202605.md)
- [2026 年 6 月 Laravel 更新](/zh/blog/changelog/202606.md)
- [Laravel 新代码分析生态 — surveyor / ranger / roster](/zh/blog/laravel-ecosystem-analysis.md)
- [Laravel 13 新功能汇总](/zh/blog/laravel-13-new-features.md)