# 🚀 HPlus Swagger v4.0.0-beta

⚠️ Beta 版本：建议在测试环境验证后再用于生产

📦 安装

composer require hyperf-plus/swagger:^4.0@beta

✨ 核心新特性

• 🚀 OpenAPI 3.1.1 - 完整支持最新规范
• 💾 懒加载+缓存 - 启动零开销，首次访问构建并缓存
• 📋 FormRequest 支持 - 自动识别 Hyperf FormRequest 验证器
• ⚡ 软依赖设计 - validate 插件可选，未安装时自动跳过
• 🔄 智能集成 - 自动识别 Route 和 Validate 注解

🎯 主要改进

• ✅ 启动时零开销（懒加载机制）
• ✅ 构建结果缓存（首次后极快）
• ✅ 支持数组格式验证规则
• ✅ HTTP 方法感知（GET/DELETE 不提取请求体）

🔄 快速迁移

# 1. 升级依赖
composer require hyperf-plus/swagger:^4.0@beta

# 2. 检查配置（通常无需修改）
# config/autoload/swagger.php

# 3. 验证文档
# 访问 http://localhost:9501/swagger

📝 详细文档

• 使用文档
• OpenAPI 3.1.1 规范
• GitHub Issues

---

注意: Beta 版本可能存在未知问题，欢迎反馈！

v3.1.3

Full Changelog: v3.1.2...v3.1.3

v3.1.2

Full Changelog: v3.1.1...v3.1.2

v3.1.1

Full Changelog: v3.1.0...v3.1.1

v3.1.0

Full Changelog: v3.0.2...v3.1.0
支持hyperf3.1

v3.0.2

Update SwaggerJson.php

v3.0.0

fix swagger

v1.0.6: Update BootAppConfListener.php

跳过非http的服务生成文档

v1.0.5

Update SwaggerJson.php

v1.0.4

支持hyperf2.1