Laravel 12.48.0 核心库版本发布

Laravel 的 12.x 分支又迎来了一个小版本迭代——v12.48.0 正式发布了。别看版本号只跳了一小步，这次更新在问题修复和功能增强上的密度可不低，涉及队列、验证、集合、测试、CORS 等多个模块，甚至还有一些潜在的无限循环隐患被堵住了。下面直接梳理一下这次更新的核心内容。

本次更新主要围绕以下几个方向展开：

• 修复变量未正确重新赋值的问题（#58376）
• 优化 PendingRequest 的类型定义（#58386）
• 修复与第三方防护工具的向后兼容性异常（#58385）
• 调整 Illuminate\Testing\TestResponse::assertHeader() 方法，使其对 HTTP 头名称不区分大小写（#58383）
• 修复验证规则参数为空时触发的 TypeError 错误（#58380）
• 优化 PendingBatchFake 的过滤逻辑（#58375）
• 解决延迟队列场景下可能引发的无限循环问题（#58373）
• 持续完善 Illuminate\Support\Str 的类型支持与稳定性（#58372）
• 确保 Bus::chain 在执行时自动剔除 falsy 值（#58369）
• 修正 v12.47.0 中 Str::replaceMatches 方法文档中标注的错误数组类型（#58364）
• 移除 Mockery\PHPUnitIntegration 中不必要的重复调用（#58363）
• 清理 failed_jobs 表中冗余索引（#58362）
• 翻译字符串现支持在占位符中使用方括号和花括号（#58367）
• 为 HandleCors 中间件新增 skipWhen 配置能力（#58361）
• 为 Illuminate\Support\Str 补充完整的类型测试用例（#58365）
• 引入 $class 参数替代部分反射操作，提升运行性能（#58391）
• 并行测试过程中按进程独立编译视图，避免冲突（#58390）
• 修复某些场景下类导入失败的问题（#58394）
• 为枚举验证规则实现 Stringable 接口（#58392）
• 修复 MemoizedStore 中 restoreLock 方法的行为异常（#58423）
• 修复 Filesystem::sharedGet 在部分读取时的数据截断问题（#58418 / #58419）
• 为 ValidatedInput::__isset() 方法补充缺失的 @param 文档注释（#58410）
• 在 JobPopping 事件中增加队列名称字段（#58413）
• 为 JobReleasedAfterException 事件添加重试回退机制（#58414）
• 修正 Number::abbreviate 方法的 return type 文档注释（#58408）
• 为 Number::pairs() 方法的元组返回类型添加准确类型注释（#58409）
• 将 /src/Illuminate/Foundation/resources/exceptions/renderer 目录中 tar 包版本由 7.4.3 升级至 7.5.3（#58404）
• 更新集合 merge 方法的返回类型声明（#58405）
• 修复部分文件中遗漏的命名空间导入（#58401）
• 在 PendingRequest 内部统一捕获并处理 Throwable 异常（#58395）
• chore：将 PruneCommand::isPrunable() 方法访问权限调整为 protected（#58430）
• 扩展 PendingRequest@pool() 方法的返回类型定义（#58437）
• 测试覆盖率与稳定性进一步提升（#58432）
• 新增 BatchFinished 事件，便于监听批量任务完成状态（#58431）

以上就是 v12.48.0 的主要变更。对于正在维护 Laravel 项目的开发者来说，延迟队列无限循环的修复、CORS 中间件的 skipWhen 配置、以及并行测试中的视图独立编译，都是值得重点关注的变化。更详细的上下文可以查阅对应的 issue 和 PR，这里就不再展开了。