All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
5.0.21 - 2026-05-16
- debugbar: 修复主动初始化未使用数据库连接
5.0.20 - 2026-04-23
- swagger: 支持 Basic Auth 认证和自定义中间件
- docs: 为 dto/swagger/amis-admin/auth/crontab-task/logger 包添加面向使用者的 AI skill 最佳实践指南
- docs: 将 CLAUDE.md 重命名为 AGENTS.md,优化各包文档结构和工作流程图
- docs: 添加文档规范,精简各包 README 为功能概览
- 修复 OpenAPI snapshot 测试因路径扫描顺序不一致导致 CI 失败
5.0.19 - 2026-03-16
- amis-admin: 修正时间戳转换时显式使用默认时区
5.0.18 - 2026-03-13
- dto+swagger: 默认输出 OpenAPI 3.1 并支持版本可配置
- swagger: 将 x-in 子路径 ref 提升为独立组件
- dto+swagger: 修复 map value nullable 丢失
- swagger: 修复 body 属性请求仍追加 json body
- swagger: 收敛 x-in 子路径 ref 保活
- swagger: 修正 docblock @example 的类型转换
5.0.17 - 2026-03-11
- swagger: cacheKey 不允许为空字符串
5.0.16 - 2026-03-09
- amis-admin: 记住 CRUD 分页大小
- swagger: 将 DTO 校验规则移到 Operation 描述
- dto+swagger: 支持 discriminator 多态类型识别 (#8)
- dto: 修复 array<string, mixed> 在 OpenAPI 中被错误解析为 array 类型
- swagger: 合并多 request schema 的校验规则
- common-utils: 重构 ArrayCache 存储结构并新增自动 GC
5.0.15 - 2026-03-03
- DTO: 支持联合类型验证规则(如 int|string),自动添加 sometimes 验证规则
- common-utils: 添加 ArrayCache 内存缓存实现
- common-utils: 添加 NullCache 空缓存实现
- CI: 忽略依赖安全警告以修复 CI 构建
- CI: 移除已修复的 phpunit 和 symfony/process 安全警告忽略
- debugbar: 使用 WeakMap 重构事件绑定机制,防止内存泄漏
- swagger: 使用 common-utils 的缓存实现替换本地实现
5.0.14 - 2026-01-30
- DTO: 新增
FromDataConfigtrim 配置支持自动去除字符串首尾空格 - DTO: 新增
FromDataConfigvalidatePropertiesAllWithBail 配置 - DTO: 优化 bail 验证规则处理逻辑
- DTO: 新增
FromDataConfigvalidateStopOnFirstFailure 配置 - Logger: 新增命名参数支持,允许使用 level/type/context 参数
- DTO: 修复子项 null 不应在记录日志时被转为 '[NULL]'
- CI: 跳过仅修改 markdown 文档的测试运行
5.0.13 - 2026-01-27
- DTO: 修复三层嵌套对象的 required_with 验证规则路径问题
5.0.12 - 2026-01-20
- DTO: 新增
FromDataConfig属性支持 ignoreNull 和 ignoreEmpty 数据过滤
5.0.11 - 2026-01-19
- DTO: 新增 shallowValidation 浅层验证参数,用于优化嵌套 DTO 和大数组的验证性能
- 修复 PHPStan Level 9 静态分析错误
5.0.10 - 2026-01-16
- DTO: 嵌套 DTO 验证规则继承和避免重复验证
- amis-admin: 支持带类型的 filter 用于 MongoDB
- amis-admin: 支持时间区间单边查询
- 为所有包添加 CLAUDE.md 文档
5.0.9 - 2026-01-06
- DTO/Swagger: 支持多维数组类型解析和生成(如
array<string, Xxx[]>) - Swagger: 支持提取
array<string, Xxx[]>的形式 - DTO: 支持从 comment 里提取
array<string, Xxx[]>的形式
5.0.8 - 2026-01-06
- Swagger: 支持联合类型的返回
- DTO: 支持 construct 下 array 存在 readonly 的情况
5.0.7 - 2025-12-23
- Logger: 支持 symfony HttpClient 对单接口进行控制日志参数
- Logger: 检查跳过时支持 exception 参数
- Logger: EloquentSQLMessage 增加记录日志后的回调处理(用于告警通知之类的)
- Logger: EloquentSQLMessage bindSql 支持 laravel 低版本的
- 测试字段错误
5.0.6 - 2025-12-23
- Logger: EloquentSQLMessage 支持 extraInfo
5.0.5 - 2025-12-19
- Common-utils: 提供 Ip 的工具类
- Swagger: 支持控制被禁后的文案显示
- Swagger: 注册的路由上到 middleware 错误
5.0.4 - 2025-12-16
- Logger: RequestTraceProcessor 支持在 console 下产出 uid
- 更新依赖
- Logger: 清理测试代码
5.0.3 - 2025-12-03
- 修复 runtime dir 问题
5.0.2 - 2025-12-02
- Swagger: 优化使用 psr 缓存,添加更多配置
- Common-utils: middleware 兼容 psr15 handle 的场景
- Logger: 兼容 Auth::guard 不存在的情况
- Common-utils/Swagger: 获取 Url 支持添加 prefix
- Logger: 增加更多 tests,更新 README
- Logger: 优化 cost 计算的代码
- Logger: Add HttpRequestMessage
- Common-utils: from 支持当前 instance
- Common-utils: 优化方法名和测试用例,提高覆盖率
- Common-utils: 调整 Container 的实现逻辑
- Logger: 使用 CommonUtils 下的组件解耦与 webman 的强依赖,重构了部分 Processor 和 Middleware
- Common-utils/Auth: 使用 CommonUtils 下的组件解耦与 webman 的强依赖
- Common-utils/Swagger: 使用 Route 替换原来的 Integrations
- Common-utils: Add Route
- Common-utils: Add BaseMiddleware
- Common-utils: 丰富 Request/Response,增加更多方法和测试
- Swagger: 使用新的 middleware 的形式
- Common-utils: 去除 Request 对 RequestInterface 的依赖,方便扩展
- DTO: 允许将空字符串赋值给允许为 null 的 int 类型
- DTO: 使用 common-utils 下的 request、response
- Common-utils: Add Response/Session
- Common-utils: Add Request
- Logger: add HttpClientMessage
- Logger: add EloquentSQLMessage
- Common-utils: 清理无用代码
- Common-utils: 移除非必要依赖
- 所有组件: phpstan fix
- Swagger: path check error
5.0.1 - 2025-11-24
- 更新依赖版本
5.0.0 - 2025-11-24
- 初始 5.0.0 版本
- 后续组件统一发版(选取原组件版本中最大的,然后再加一位,所以是 5 开始的)
注意:v5.0.0 之前的版本历史未在此处详细记录。主要变更包括:
- 初始版本发布
- 各个组件的基础功能实现
- Webman 框架集成
如需查看完整的历史变更,请访问 GitHub Commit 历史