## [6.0.0] - 2025-09-09 ### 🚀 Major Features - **性能优化策略系统**: 全新的转换策略架构,针对不同使用场景提供最优性能 - **内存优化策略** (Memory Optimized): 占用 ~400KB 内存,适合 Web 请求和内存受限环境 - **缓存策略** (Cached): 占用 ~4MB 内存,重复转换性能提升 2-3 倍,适合批处理任务 - **智能策略** (Smart): 占用 600KB-1.5MB 内存,根据文本复杂度自适应加载 - **ConverterFactory**: 新的工厂模式管理转换器实例和策略选择 - **自动策略选择**: 根据运行环境(Web/CLI/内存限制)自动推荐最佳策略 - **性能基准测试工具**: 内置的策略性能对比和监控工具 - **内存监控**: 支持实时监控内存使用情况和性能指标 ### 🔧 API Changes - 新增 `Pinyin::useMemoryOptimized()` - 切换到内存优化策略 - 新增 `Pinyin::useCached()` - 切换到缓存策略 - 新增 `Pinyin::useSmart()` - 切换到智能策略 - 新增 `Pinyin::useAutoStrategy()` - 自动选择最佳策略 - 新增 `Pinyin::clearCache()` - 清理所有转换器缓存 - 新增 `ConverterFactory::make($strategy)` - 创建指定策略的转换器 - 新增 `ConverterFactory::recommend()` - 获取推荐策略 - 新增 `ConverterFactory::getStrategiesInfo()` - 获取所有策略信息 ### ⚡ Performance Improvements - **内存使用优化**: 默认内存占用从 ~4MB 降低到 ~400KB - **转换速度提升**: 缓存策略下重复转换速度提升 2-3 倍 - **智能加载**: 根据文本复杂度动态调整数据加载策略 - **按需加载**: 内存优化策略仅在需要时加载转换数据 ### 📊 Benchmark & Monitoring - 新增 `php benchmark/run.php` - 运行性能基准测试 - 新增 `php benchmark/compare-strategies.php` - 策略对比测试 - 新增基准测试文档 `docs/benchmark-guide.md` - 支持内存使用情况实时监控 #### 运行基准测试 ```bash # 运行标准基准测试,显示所有方法的性能表现 php benchmark/run.php # 详细的策略对比测试,对比三种策略的性能差异 php benchmark/compare-strategies.php ``` 基准测试会显示: - 每种策略的执行时间和内存使用情况 - 不同文本长度下的性能表现 - 策略之间的性能对比和推荐场景 ### 🔄 Breaking Changes - **默认策略变更**: 从全缓存改为内存优化策略,降低默认内存占用 - **转换器架构重构**: 引入策略模式,旧的直接实例化转换器方式仍兼容 - **性能特征变化**: 首次转换可能略慢,但内存占用显著降低 ### 🔧 Backward Compatibility - 完全兼容 5.x API,现有代码无需修改即可使用 - `heteronym()` 方法(5.3.3+ 引入)继续保持兼容 - 所有原有的转换方法 (`sentence`, `phrase`, `chars` 等) 保持不变 ### 📚 Documentation - 更新 README.md 增加性能优化策略说明 - 新增性能对比表格和使用建议 - 新增基准测试指南 - 新增性能优化最佳实践 ### 🔧 Development Tools - 新增性能基准测试脚本 - 新增策略对比工具 - 增强命令行工具支持策略选择 ### 🛠️ Migration Guide 从 5.x 升级到 6.0 非常简单,所有现有代码都能正常工作: #### 无需任何修改(推荐) ```php // 5.x 和 6.x 都能正常工作 Pinyin::sentence('你好世界'); // 6.x 默认使用内存优化策略,内存占用更低 ``` #### 保持 5.x 完全相同的性能特征 ```php // 如果你需要与 5.x 完全相同的高性能(高内存占用) Pinyin::useCached(); // 一次设置,全局生效 Pinyin::sentence('你好世界'); ``` #### 使用新的性能优化特性 ```php // 自动选择最佳策略(推荐用于新项目) Pinyin::useAutoStrategy(); // 或者根据场景手动选择: // Web 应用(内存受限) Pinyin::useMemoryOptimized(); // 批处理任务(性能优先) Pinyin::useCached(); // 通用场景(平衡) Pinyin::useSmart(); ``` #### 性能监控和优化 ```php // 监控内存使用 $initialMemory = memory_get_usage(); $result = Pinyin::sentence('测试文本'); $memoryUsed = memory_get_usage() - $initialMemory; echo "内存使用: " . round($memoryUsed / 1024, 2) . " KB"; // 批处理完成后清理缓存 Pinyin::useCached(); // ... 批量处理 ... Pinyin::clearCache(); // 释放内存 ``` ### 💡 Performance Comparison | 策略 | 内存占用 | 首次转换 | 重复转换 | 推荐场景 | |-----|---------|---------|---------|---------| | Memory Optimized | ~400KB | 中等 | 中等 | Web 请求、内存受限环境 | | Cached | ~4MB | 慢 | **最快** (2-3x) | 批处理、长时运行进程 | | Smart | 600KB-1.5MB | 快 | 快 | 通用场景、自动优化 | 基于 1000 次转换的基准测试结果: | 文本长度 | Memory Optimized | Cached | Smart | |---------|-----------------|--------|-------| | 短文本 (<10字) | 1.2ms | 0.5ms | 0.8ms | | 中等文本 (10-50字) | 3.5ms | 1.2ms | 2.1ms | | 长文本 (>100字) | 8.7ms | 3.1ms | 5.2ms | ## [5.3.4] - 2025-03-16 ### 🚀 Features - Resolved #211 ### ⚙️ Miscellaneous Tasks - Format ## [5.3.3] - 2024-08-01 ### 🚀 Features - 使用 heteronym 代替 polyphonic 多音字 #184 - 取首字母时,能否保留完整的英文 #199 ### 🐛 Bug Fixes - 修复 琢 的音频顺序 #207 - 补充案例 #207 - Tests - Tests ## [5.3.2] - 2024-03-19 ### 🚀 Features - 取首字母时,能否保留完整的英文 #199 ## [5.3.1] - 2024-03-19 ### 🐛 Bug Fixes - 「仆区」应该读 pú ōu 而非 pú qū #200 - Tests #200 ## [5.3.0] - 2023-10-27 ### 🚀 Features - 添加sentenceFull,支持保留其他字符 (#198) - Full sentence, #198 ## [5.2.2] - 2023-09-27 ### ⚙️ Miscellaneous Tasks - Bin ## [5.2.1] - 2023-06-17 ### 🐛 Bug Fixes - Bin ## [5.2.0] - 2023-06-12 ### 🚀 Features - 增加 Pinyin::polyphonesAsArray. fixed #195 ### 📚 Documentation - 更新文档提示 - 更新文档提示 - 更新文档提示 ## [5.1.0] - 2023-04-27 ### 💼 Other - 移除错误语法 (#190) ## [5.0.0] - 2022-07-24 ### 🐛 Bug Fixes - 优化符号匹配规则 ## [1.0-beta] - 2014-07-16