Laravel 13.43 的三处改动:JSON Schema 转验证规则、RetryFor 属性、releaseUsingBackoff
版本发布于 2026-11-17。三个改动都偏向「消除重复」,但每个都有自己的边界。
JsonSchema::rules():省掉一份源,还是多一份漂移
Laravel AI SDK 和 Laravel MCP 里的工具本来就用 JSON Schema 描述输入,以前还得把约束再手写成验证规则。现在可以直接转:
use Illuminate\JsonSchema\JsonSchema;
$schema = JsonSchema::object(fn ($schema) => [
'name' => $schema->string()->max(50)->required(),
'age' => $schema->integer()->min(18),
'role' => $schema->string()->enum(['admin', 'user'])->required(),
]);
JsonSchema::rules($schema);
// ['name' => ['required','string','max:50'],
// 'age' => ['sometimes', RejectEmptyString, 'integer','min:18'],
// 'role' => ['required','string', Rule::in([...])]]
也接受原始 schema 数组。嵌套属性映射到点号键,如 address.city、tags.*,能直接喂给 Validator::make() 和 form request。后续 PR 补了 exclusiveMinimum / exclusiveMaximum,uniqueItems 对标量改为严格比较。
取舍很清楚:当 schema 已经是唯一事实来源时用(AI 工具定义、MCP 输入描述),这确实能消掉一份复制品。但如果同一份校验在别处还有手写规则——比如表单请求里另写一套、或者 schema 只是给 LLM 看的宽松描述——那就是两套源,改一边忘一边,漂移比重复更贵。
另一个要注意的实际输出:可选字段会带上 sometimes 和 RejectEmptyString。这跟手写 ['nullable','integer'] 的空值语义不完全一致,迁移老规则时别默认行为相同。
#[RetryFor(hours: 4)]:属性替代 retryUntil()
// Before
class ImportProducts implements ShouldQueue
{
public function retryUntil(): DateTime { return now()->addHours(4); }
}
// After
#[RetryFor(hours: 4)]
class ImportProducts implements ShouldQueue {}
第一个位置参数是秒,另外支持具名参数 minutes、hours,可组合:#[RetryFor(hours: 1, minutes: 30)]。适用范围包括 job、队列 mailbale、队列 notification、队列 listener。子类继承该属性。
优先级是坑所在:显式的 retryUntil() 方法或 $retryUntil 属性仍然优先于属性。也就是说给基类加了 #[RetryFor] 之后,某个子类残留的旧 retryUntil() 会静默盖掉新配置,不会报错。
releaseUsingBackoff():主动 release 的 job 得自己算延迟
队列 worker 只在 job 抛异常时才应用 backoff 计划。一个自己 release 自己的 job(比如轮询外部 API)以前必须手动算延迟:
#[Backoff(5, 15, 60, 300)]
class WaitForExport implements ShouldQueue
{
use InteractsWithQueue;
public function handle(): void
{
if (! $this->export->isReady()) {
return $this->releaseUsingBackoff();
}
$this->export->download();
}
}
取的是当前尝试次数对应的 backoff 值;尝试次数超出列表长度后复用最后一个值;没有配置 backoff 的 job 则以零延迟 release——最后这条在轮询场景里等于原地重试,容易打爆下游,配置时留意。
安全修复与依赖冲突
13.43 修了一批问题:
- 签名 URL 过期绕过,通过数组/数字型查询参数(以及 numeric query-fragment parameter smuggling)
- 组件属性与 debug 页面的 XSS
- mass assignment 防护绕过,经由 mutator 属性名
- 文件校验绕过
- JSON Schema 反序列化中无界的
$ref链
另有一条 12.x 分支的「Prevent escaping from bypassing protection」。
框架现在声明与 laravel/horizon < 5.47.0 冲突,升级时先对齐 Horizon 版本。
顺带两个小改动:DB::withoutAffectingStickiness() 在开启 sticky 时,于回调内执行写操作而不把后续读强制打到写连接;Stringable::isBlank() / isNotBlank()。
链接
- Release:https://github.com/laravel/framework/releases/tag/v13.43.0
- 参考文章:https://msaied.com/articles/json-schema-validation-rules-and-a-retryfor-attribute-in-laravel-1343