> ## 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 等大型更新總整理。

2026 年 3 月對 Laravel 生態系而言是歷史性的一個月。**Laravel 13** 正式發佈，同時公開了 First-party 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 導入 First-party AI SDK，提供文字生成、工具呼叫 Agent、Embedding、語音、影像、向量儲存整合的統一 API。可以在不依賴提供者的情況下，以一致的 Laravel 原生開發體驗建構 AI 功能。

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

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

### JSON:API 資源

Laravel 以 First-party 形式導入 JSON:API 資源。可輕鬆回傳符合 JSON:API 規範的回應，自動處理資源物件序列化、關聯 include、稀疏欄位集、連結，以及符合 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 保護 middleware 正式化為 `PreventRequestForgery`。在維持與 token 為基礎的 CSRF 保護相容性的同時，加入 Origin 對應的請求驗證。

### 佇列路由

透過 `Queue::route()` 可對每個類別進行佇列路由。可集中管理特定 Job 的預設佇列與連線的路由規則。

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

### 擴充 PHP 屬性（Attributes）

Laravel 13 於整個框架擴充了 First-party PHP 屬性的支援。新增與 Controller 及認證相關的屬性（`#[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());
```

### 語意搜尋與向量搜尋

新增原生向量查詢支援、Embedding 工作流程與相關 API。可輕鬆使用 PostgreSQL + pgvector 建構 AI 驅動的搜尋。

***

## Inertia v3

### Vite Plugin

新的 `@inertiajs/vite` plugin 讓過去要寫在進入點的樣板程式碼變得不再必要。頁面會自動從 `./Pages` 目錄解析，程式碼分割與延遲載入也會自動處理。SSR 設定同樣是零設定。

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

### 開發時 SSR

`npm run dev` 開始就會自動運作 SSR。開發時不需要另一個 Node.js 程序，頁面預設會進行伺服器端渲染。

### 移除 Axios

Axios 與 qs 已完全從 Inertia 相依中移除。輕量的內建 XHR client 會處理所有 HTTP 通訊，縮減 bundle 大小與相依足跡。

<Info>
  若你有依賴 Axios interceptor 等功能，Axios adapter 會在遷移期間維持運作。
</Info>

### 樂觀更新

新增 `.optimistic()` 方法，可在不等伺服器回應下立即更新 UI。

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

### Instant Visits

在背景執行伺服器請求的同時，可立刻切換到目標頁面元件。

***

## 其他套件

### Prompts 新功能

* **`datatable()`**：對應表格資料瀏覽、搜尋、選取的新 prompt
* **`title()`**：設定終端機視窗標題
* **`stream()`**：即時串流顯示 AI 回應
* **`task()`**：帶有 spinner 的任務執行顯示
* **`autocomplete()`**：輸入自動補完的 prompt
* **`notify()`**：macOS/Linux 原生桌面通知

### Passport

* **`#[TokenCan]` 屬性**：可在 Controller 方法上直接宣告所需的 token scope

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

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

### Reverb

* **速率限制**：支援使用 Laravel 內建 rate limiter 進行應用層級的速率限制

### Scout

* **`where()` 支援運算子**：query builder 可使用 `where('created_at', '>', $date)` 的寫法

***

## Laravel Cloud、Laravel Forge

| 產品                | 主要更新                                                      |
| ----------------- | --------------------------------------------------------- |
| **Laravel Cloud** | 無需信用卡的 \$5 免費試用、GitHub SSO、排程 auto scaling、使用量頁面改版        |
| **Laravel Forge** | 在 VPS 上支援 Managed PostgreSQL 資料庫（含可觀測性、Read Replica、自動備份） |


## Related topics

- [2026 年 4 月 Laravel 更新](/zh-TW/blog/changelog/202604.md)
- [2026 年 5 月 Laravel 更新](/zh-TW/blog/changelog/202605.md)
- [2026 年 6 月 Laravel 更新](/zh-TW/blog/changelog/202606.md)
- [Laravel 新程式碼分析生態系 — surveyor / ranger / roster](/zh-TW/blog/laravel-ecosystem-analysis.md)
- [Laravel 13 新功能彙總](/zh-TW/blog/laravel-13-new-features.md)