DokuWiki项目中关于random_compat依赖库的技术解析

在DokuWiki的版本迭代过程中，开发团队发现了一个关于依赖库管理的典型案例。项目中存在一个名为paragonie/random_compat的PHP兼容性库，该库原本用于在不同PHP版本中提供一致的随机数生成功能。随着技术演进，这个库的处理方式展现了开源项目中依赖管理的典型场景。

2022年，DokuWiki开发团队移除了这个兼容库的相关文件，并将其列入了data/deleted.files清单中。然而在后续升级phpseclib加密库时，由于phpseclib 3.0.43版本明确声明依赖paragonie/random_compat，这个库又被重新引入项目。

技术背景方面，random_compat库的主要作用是弥合PHP 5.x和7.x在随机数生成API方面的差异。当项目运行环境升级到PHP 7.4及以上版本时，该库的v9.99.100版本实际上只是一个空实现，因为现代PHP版本已经原生支持这些功能。

对于系统管理员和开发者而言，这个案例带来了两个重要启示：

1. 依赖管理是动态过程，删除的文件可能因新的依赖关系而重新出现
2. 在升级DokuWiki时，应该先执行删除操作再覆盖安装，这与文档建议的顺序有所不同

当前解决方案是保留这个看似无用的依赖库，以维持整个依赖树的完整性。这种做法在软件工程中很常见，称为"空实现"或"桩模块"，既满足了依赖声明，又不会产生实际开销。

这个案例也展示了开源项目依赖管理的复杂性，即使是看似简单的文件删除操作，也需要考虑整个生态系统的相互关联性。对于使用DokuWiki的系统管理员来说，理解这种机制有助于更好地处理升级过程中的文件管理问题。