Apigen无法为被替换的库生成文档

Question

根据编解码器文档，我们应该将本地库替换为out自己的库：

只需将类文件相同地命名为本机库，CodeIgniter就会使用它而不是本机库。要使用此特性，必须将文件和类声明命名为与本机库完全相同的名称。

但是，当我给两个类取相同的名称时，Apigen无法为它们生成文档，而是显示此错误消息：

无法生成该类的文档。 类最初是在应用程序/库/Session.php中声明的，并且由于以下原因无效： 类在system/libraries/Session.php中重新声明。

(在本例中，我试图替换session类)。

在这个案件中，哪个人有罪，代码点火器还是阿皮根？如何才能解决这个问题呢？

Answer 1

可以使用--exclude参数跳过在system下替换的类。手动列出重写的类可能很无聊，但您可以轻松地编写脚本：

$app_files = glob('application/{core,libraries}/*.php', GLOB_BRACE);
foreach ($app_files as $file) {
    $sys_file = preg_replace('/^application\//', 'system/', $file);
    if (is_file($sys_file)) {
        print  ' --exclude '.realpath($sys_file); // looks like it has to be a full path
    }
}
print "\n";

并调用CI根目录中的生成，如下所示：

$ apigen `php overriden_classes.php` --source . --destination apigenout