> ## 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 年 9 月 Laravel 更新

> 2026 年 9 月 Laravel 13 與官方產品的更新。彙整執行時期建構 AI 供應商、Scout 搜尋擴充、Mercure、跨磁碟傳輸、佇列管理，以及 Cloud 的隔離預覽環境。

2026 年 9 月，每個租戶的 AI 設定與搜尋引擎的選擇更加多元，也新增了支援儲存、佇列與資料庫營運的功能。Laravel Cloud 方面，介紹了為每個 Pull Request 隔離資源的預覽環境，以及無需額外套件即可使用的請求指標。

本頁根據 10 月 2 日發表的官方部落格文章「Laravel September product updates」與 9 月發布的 Laravel 13 官方發行說明，整理主要變更。Framework 項目中也包含 AI SDK、Scout、Echo 等官方套件的變更。請勿僅以 Framework 本體的版本號來判斷這些套件的更新。

參考來源：

* [Laravel September product updates](https://laravel.com/blog/laravel-september-product-updates)
* [Laravel Framework changelog](https://laravel.com/framework/docs/changelog)
* [Laravel Framework v13.30.0](https://github.com/laravel/framework/releases/tag/v13.30.0)
* [Laravel Framework v13.30.1](https://github.com/laravel/framework/releases/tag/v13.30.1)
* [Laravel Framework v13.31.0](https://github.com/laravel/framework/releases/tag/v13.31.0)
* [Laravel Framework v13.32.0](https://github.com/laravel/framework/releases/tag/v13.32.0)
* [Laravel Framework v13.33.0](https://github.com/laravel/framework/releases/tag/v13.33.0)
* [Laravel Framework v13.34.0](https://github.com/laravel/framework/releases/tag/v13.34.0)

## Laravel Framework 與官方套件

### 在執行時期為每個租戶建構 AI 供應商

AI SDK 的 `Ai::build()` 現在可以從設定陣列建構供應商。無需變更應用中已註冊的供應商設定，即可使用在執行時期取得的認證資訊。

例如，當每個租戶各自使用自己簽約的 Anthropic API 金鑰時，可以從各租戶的設定建立供應商，並傳給 agent 的 `prompt()`。建構出的供應商也可以指定為容錯移轉（failover）的候選。

在處理多個租戶的認證資訊時，重點在於能明確指定呼叫所使用的供應商，而不是改寫全域設定。AI SDK 的基礎請參考 [AI SDK 指南](/zh-TW/ai-sdk)。

一手資料：[Build AI providers from runtime configuration](https://laravel.com/framework/docs/changelog#september-2026-build-ai-providers-from-runtime-configuration)

### Scout 的 Typesense 與 Meilisearch 搜尋擴充

Scout 的 Typesense 引擎現在可使用 `semantic()` 進行語意搜尋，以及使用 `hybrid()` 進行混合搜尋。向量除了可由 Laravel AI 產生之外，也可以使用 Typesense 的自動 Embedding 功能，或自行準備的向量。

Meilisearch 引擎現在可以使用 Meilisearch 本身的 Embedder。可依架構選擇由應用端產生 Embedding，或交由搜尋引擎端處理。

延續 8 月的搜尋擴充，9 月則增加了在 Typesense 與 Meilisearch 端產生 Embedding 的選項。各引擎的設定方式請參考 [Scout](/zh-TW/scout) 與[搜尋指南](/zh-TW/search)。

一手資料：[Typesense 的語意與混合搜尋](https://laravel.com/framework/docs/changelog#september-2026-semantic-and-hybrid-search-for-typesense)、[Meilisearch 的原生 Embedder](https://laravel.com/framework/docs/changelog#september-2026-use-meilisearchs-native-embedders-with-scout)

### 透過 Mercure 進行即時通訊

Laravel Echo 新增了 Mercure connector。由於使用瀏覽器標準的 `EventSource` API，因此不需要額外的用戶端函式庫。除了 Private、Presence 與加密頻道之外，也支援 Whisper。

Framework v13.32.0 包含 Mercure 廣播 driver，以及透過 `install:broadcasting` 導入 Mercure 的支援。v13.33.0 起也能處理 Mercure Hub 的相對 URL。

這是需要搭配 Echo 端的 connector 與 Laravel 端的 driver 一起使用的功能。設定與驗證方式請參考 [Mercure 廣播](/zh-TW/advanced/mercure-broadcasting)。

一手資料：[Mercure broadcasting in Laravel Echo](https://laravel.com/framework/docs/changelog#september-2026-mercure-broadcasting-in-laravel-echo)、[v13.32.0](https://github.com/laravel/framework/releases/tag/v13.32.0)、[v13.33.0](https://github.com/laravel/framework/releases/tag/v13.33.0)

### 在磁碟之間複製或移動檔案

v13.32.0 的檔案系統新增了 `copyToDisk()` 與 `moveToDisk()`。可以用串流方式在不同磁碟之間傳輸檔案，例如從本機磁碟移到 S3。傳輸目標除了磁碟名稱之外，也可以傳入檔案系統實例。

`moveToDisk()` 只會在複製成功後才刪除來源檔案。為了跨磁碟遷移，應用端不再需要另外組合讀取、寫入與刪除的步驟。

一手資料：[Copy or move files between disks](https://laravel.com/framework/docs/changelog#september-2026-copy-or-move-files-between-disks)、[v13.32.0](https://github.com/laravel/framework/releases/tag/v13.32.0)。相關頁面：[檔案系統](/zh-TW/filesystem)

### 改善佇列的量測、停止與重試

9 月的發行版本逐步強化了佇列狀態的掌握與 worker 的控制。

| 發行版本 | 主要變更 |
| - | - |
| v13.30.0 | 顯示 `queue:work` 的停止原因、Cloud Queue 的 `totalXSize` 系列方法、Queue Manager 支援 `createPayloadUsing`。 |
| v13.30.1 | `WorkerStopping` 事件新增連線與佇列資訊。 |
| v13.31.0 | Queue 的 `totalSize()`、`JobInterrupted` 事件，以及終止 worker 時在 `WorkerStopping` 中加入連線與佇列資訊。也修正了 Redis Cluster 上的佇列操作。 |
| v13.32.0 | 佇列的暫停與恢復方法可使用 Enum。Cloud Manager 新增 `isManagedQueue`。 |
| v13.33.0 | 新增在 Job 逾時時不終止 worker 的選項、改善 Cloud Job 的重試，並在 `queue:retry-batch` 中略過無法重試的批次。 |
| v13.34.0 | `JobProcessed` 事件新增處理時間、在逾時前通知 Job、`queue:flush` 的 `--queue` 選項，以及將 worker 當機計入 `maxExceptions` 的選項。 |

v13.34.0 起，對無法重新啟動的 worker 執行 `queue:restart` 時會顯示錯誤。這項變更讓人更容易察覺營運指令看似成功、但實際上並未如預期重新啟動的情況。

各項目的出處為上述[官方發行說明](https://github.com/laravel/framework/releases)。基本操作請參考[佇列指南](/zh-TW/queues)，Job 端的控制請參考 [Job 控制進階指南](/zh-TW/advanced/queue-job-control)。

### 資料庫、Eloquent 與快取的新增功能

* **刪除向量索引**：v13.30.1 的 Schema Blueprint 新增了 `dropVectorIndex()`。
* **MySQL 的 INPLACE 操作**：v13.33.0 為索引與外鍵操作新增了 `inplace()` DDL 演算法修飾子。相關頁面：[遷移](/zh-TW/migrations)。
* **寫入後重新取得模型屬性**：v13.33.0 新增了在寫入後重新取得指定模型屬性的功能。
* **保留 NULL 的 cast**：v13.33.0 為 `AsCollection` 與 `AsArrayObject` 新增了儲存實際 `NULL` 的選擇性（opt-in）功能。
* **帶標籤的 memo 快取**：v13.33.0 支援對帶標籤的快取進行 memo 化。相關頁面：[快取](/zh-TW/cache)。
* **取得 schema 資訊**：v13.34.0 的 Schema Builder 新增了 `getColumn()`。
* **資料庫測試**：v13.34.0 起，`assertDatabaseCount` 可以接受陣列。
* **集合**：v13.30.0 新增了 `chunkBy()`，v13.33.0 新增了 Higher Order Proxy 對 `sole` 的支援。

### 既有行為的修正

除了新增功能，也包含會影響既有應用的修正。

* v13.31.0 修正了 `lazy()` 與 `lazyById()` 忽略 `limit()` 與 `offset()` 的問題，以及 Context 未傳遞到並行處理程序的問題。
* v13.32.0 修正了 Redis 帶標籤快取在 `touch()` 時未同步標籤有效期限的問題。
* v13.34.0 修正了重試 HTTP 用戶端的 Multipart 請求時，附加串流內容遺失的問題。
* v13.34.0 修正了 Pivot 的 `wherePivotBetween()` 在 `sync()`、`detach()` 與 `updateExistingPivot()` 中被忽略的問題。
* v13.34.0 修正了交易中的 `DatabaseLock` 吞掉死結（deadlock）的問題。

此清單並非 9 月的所有變更。細部修正與相依套件的更新，請參考各發行說明。

## Laravel Cloud

官方月度部落格介紹了以下變更。

| 功能 | 更新內容 |
| - | - |
| 隔離的預覽環境 | 改為為每個 Pull Request 準備新的資源，不再參照正式環境資源。Flex 規格會在審查空檔時休眠，並在 PR 合併或關閉時刪除。Deployments 畫面也會顯示分支、最新 commit 與預覽連結。 |
| 請求指標 | 可在 Monitoring 的 Requests 分頁查看請求數、回應碼與各頁面的處理時間。可依網域與期間篩選，無需新增套件或修改程式碼。 |
| Managed database users | 可在資料庫叢集中建立額外使用者，並只對所需的資料庫授予唯讀或讀寫權限。支援 Laravel MySQL、RDS MySQL 與 RDS Postgres。 |
| MySQL 儲存空間自動擴充 | 當 Laravel MySQL 的儲存使用率達到 90% 時，會將容量增加 50%。擴充過程保持線上，也可以指定最大容量，或以資料庫為單位停用。 |
| Log drains | Enterprise 方案可將應用日誌即時傳送到自有的 Amazon S3 bucket。可用於長期保存或整合既有的監控基礎設施。 |

一手資料：[Laravel Cloud changelog](https://laravel.com/cloud/docs/changelog)。相關頁面：[Laravel Cloud 介紹](/zh-TW/blog/laravel-cloud)

## Laravel Forge

* **重新導向規則管理**：現在可從 CSV 批次匯入，並選擇附加到既有規則或取代既有規則。也支援 CSV 匯出，以及透過拖曳調整規則的執行順序。
* **Server muting**：現在可在通知設定中選擇要靜音的伺服器。可用於將 staging 或測試環境的通知排除在收件匣之外。

一手資料：[Laravel Forge changelog](https://laravel.com/forge/docs/changelog)

## 相關文章

<Columns cols={2}>
  <Card title="2026 年 8 月更新" icon="calendar" href="/zh-TW/blog/changelog/202608">
    回顧 read-through 磁碟、Scout 的搜尋擴充，以及 Cloud 的 Managed Queues 全面改版。
  </Card>

  <Card title="Mercure 廣播" icon="tower-broadcast" href="/zh-TW/advanced/mercure-broadcasting">
    了解將 Mercure 整合到 Laravel 與 Echo 的架構。
  </Card>
</Columns>


## Related topics

- [2026 年 3 月 Laravel 更新](/zh-TW/blog/changelog/202603.md)
- [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)
- [2026 年 7 月 Laravel 更新](/zh-TW/blog/changelog/202607.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.