COPS 项目升级至 Alpine 3.21 的技术评估

COPS 项目升级至 Alpine 3.21 的技术评估

seblucas-cops Calibre OPDS (and HTML) PHP Server : web-based light alternative to Calibre content server / Calibre2OPDS to serve ebooks (epub, mobi, pdf, ...) 项目地址: https://gitcode.com/gh_mirrors/se/seblucas-cops

近期 COPS（Calibre OPDS PHP Server）项目正在进行基础镜像升级工作，计划将容器基础从 Alpine 3.19 迁移至 Alpine 3.21 版本。这一升级涉及多个关键技术组件的变更，值得开发者关注。

Alpine 3.21 的一个重要变化是同时支持 PHP 8.3 和 PHP 8.4 版本。在技术评估阶段，团队重点考察了以下 PHP 扩展的兼容性：

• php83-dom
• php83-gd
• php83-intl
• php83-pdo_sqlite
• php83-sqlite3

经过深入分析 PHP 8.4 的升级说明文档，发现主要的潜在变化在于 PDO_SQLITE 驱动中 PDO::sqliteCreateFunction() 方法的调整，该方法将成为 Pdo\Sqlite::createFunction() 的别名。这种变化在大多数情况下应该是透明的，不会影响现有功能。

团队进行了全面的测试验证，包括：

1. 全新安装测试：验证了基础功能在全新环境下的运行情况
2. 单元测试：执行了 774 项测试，覆盖 2087 个断言
3. 升级路径测试：确保从旧版本平滑升级的可行性

测试过程中发现了一些有趣的细节差异，如图像处理生成的缩略图大小在 Alpine 环境下比开发环境小 1 字节（15348 字节 vs 15349 字节），这可能是由于不同环境下图像处理库的细微差异导致的。

对于使用 Home Assistant 附加组件的用户，需要注意的是当前版本仍基于 PHP 8.3。开发者建议在 Dockerfile 中明确指定 php83 以避免潜在的版本冲突问题。

经过全面评估，技术团队确认 Alpine 3.21 的升级不会对 COPS 的核心功能产生影响，升级路径安全可靠。这一变更将为项目带来更现代化的基础环境支持，同时保持向后兼容性。

seblucas-cops Calibre OPDS (and HTML) PHP Server : web-based light alternative to Calibre content server / Calibre2OPDS to serve ebooks (epub, mobi, pdf, ...) 项目地址: https://gitcode.com/gh_mirrors/se/seblucas-cops