> ## 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 密钥时，可以根据租户的配置创建提供商，并将其传给代理的 `prompt()`。构建出的提供商也可以指定为故障转移的候选。

在处理多个租户的凭据时，关键在于可以明确指定调用所使用的提供商，而不是改写全局配置。AI SDK 的基础用法请参阅 [AI SDK 指南](/zh-CN/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-CN/scout) 与[检索指南](/zh-CN/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 连接器。由于使用浏览器标准的 `EventSource` API，因此无需额外的客户端库。除 Private、Presence 和加密频道外，还支持 Whisper。

Framework v13.32.0 包含 Mercure 广播驱动，以及通过 `install:broadcasting` 引入 Mercure 的支持。v13.33.0 还支持处理 Mercure Hub 的相对 URL。

这是将 Echo 端连接器与 Laravel 端驱动组合使用的功能。配置与认证请参阅 [Mercure 广播](/zh-CN/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-CN/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 | 新增任务超时时不终止 worker 的选项，改进 Cloud 任务的重试，`queue:retry-batch` 会跳过无法重试的批次。 |
| v13.34.0 | 为 `JobProcessed` 事件添加处理时间，在超时前通知任务，`queue:flush` 新增 `--queue` 选项，新增将 worker 崩溃计入 `maxExceptions` 的选项。 |

在 v13.34.0 中，对无法重启的 worker 执行 `queue:restart` 时会显示错误。这项变更让人更容易察觉运维命令看似成功、实际却没有按预期重启的情况。

各项内容的出处为上述[官方发布说明](https://github.com/laravel/framework/releases)。基础操作请参阅[队列指南](/zh-CN/queues)，任务端的控制请参阅[任务控制进阶指南](/zh-CN/advanced/queue-job-control)。

### 数据库、Eloquent 与缓存的新增功能

* **删除向量索引**：v13.30.1 为 Schema Blueprint 新增了 `dropVectorIndex()`。
* **MySQL 的 INPLACE 操作**：v13.33.0 为索引和外键操作新增了 `inplace()` DDL 算法修饰符。相关页面：[迁移](/zh-CN/migrations)。
* **写入后重新获取模型属性**：v13.33.0 新增了在写入后重新获取指定模型属性的功能。
* **保持 NULL 的类型转换**：v13.33.0 为 `AsCollection` 与 `AsArrayObject` 新增了保存真实 `NULL` 的可选功能。
* **带标签的记忆化缓存**：v13.33.0 支持对带标签的缓存进行记忆化。相关页面：[缓存](/zh-CN/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` 吞掉死锁异常的问题。

此列表并非 9 月的全部变更。细微的修复和依赖更新请查阅各版本的发布说明。

## Laravel Cloud

官方月度博客介绍了以下变更。

| 功能 | 更新内容 |
| - | - |
| 隔离的预览环境 | 改进为每个 Pull Request 准备全新资源、不引用生产资源的架构。Flex 规格会在评审间隙休眠，并在 PR 合并或关闭时删除。Deployments 页面还会显示分支、最新提交以及预览链接。 |
| 请求指标 | 可以在 Monitoring 的 Requests 标签页中查看请求数、响应码以及每个页面的处理时间。支持按域名和时间段筛选，无需添加包或修改代码。 |
| Managed database users | 可以在数据库集群中创建额外用户，并仅针对所需数据库授予只读或读写权限。支持 Laravel MySQL、RDS MySQL 与 RDS Postgres。 |
| MySQL 存储自动扩容 | 当 Laravel MySQL 的存储使用率达到 90% 时，容量会增加 50%。扩容在线进行，也可以指定最大容量或按数据库禁用。 |
| Log drains | Enterprise 计划可以将应用日志实时传输到自有的 Amazon S3 存储桶，可用于长期保存或对接现有的监控平台。 |

原始资料：[Laravel Cloud changelog](https://laravel.com/cloud/docs/changelog)。相关页面：[Laravel Cloud 介绍](/zh-CN/blog/laravel-cloud)

## Laravel Forge

* **重定向规则管理**：现在可以从 CSV 批量导入，并选择追加到现有规则或替换现有规则。同时支持 CSV 导出，以及通过拖动调整规则的执行顺序。
* **Server muting**：现在可以在通知设置中选择服务器并将其静音，可用于将预发布和测试环境的通知从收件箱中排除。

原始资料：[Laravel Forge changelog](https://laravel.com/forge/docs/changelog)

## 相关文章

<Columns cols={2}>
  <Card title="2026 年 8 月更新" icon="calendar" href="/zh-CN/blog/changelog/202608">
    回顾 read-through 磁盘、Scout 检索扩展以及 Cloud Managed Queues 的全面升级。
  </Card>

  <Card title="Mercure 广播" icon="tower-broadcast" href="/zh-CN/advanced/mercure-broadcasting">
    了解将 Mercure 集成到 Laravel 与 Echo 的配置方式。
  </Card>
</Columns>


## Related topics

- [2026 年 7 月 Laravel 更新](/zh-CN/blog/changelog/202607.md)
- [2026 年 3 月 Laravel 更新](/zh-CN/blog/changelog/202603.md)
- [2026 年 8 月 Laravel 更新](/zh-CN/blog/changelog/202608.md)
- [2026 年 4 月 Laravel 更新](/zh-CN/blog/changelog/202604.md)
- [2026 年 5 月 Laravel 更新](/zh-CN/blog/changelog/202605.md)


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