phpDoc部分更新

Question

我试图在我们的团队开发环境中自动化文档构建，因此我们决定使用phpDocumentor(2.7.0)并触发它来重新构建SVN后提交的文档。

我做了一个触发器，但是我很清楚，每次执行文档时，所有文档都是重新构建的，因为即使我只提交了一个修改过的文件，phpdoc命令的持续时间也几乎与文档初始构建时相同。

因此，我的想法是只重建那些文件的文档，在提交中进行更改。是否有可能这样做？我已经查过phpDoc和谷歌的文档，但什么也没有发现。

Answer 1

只要上次phpDocumentor2执行的结果文件位于要运行新执行的相同位置，默认情况下只应处理新的/修改的文件。phpDocumentor2有一个内置的缓存机制来跟踪“这是我们在上一次文档运行中所做的一切”，这样它就可以确定您添加/更改了哪些代码文件。

当然，如果您的构建每次运行都是新鲜的，那么以前运行的缓存是不可用的，因此phpDocumentor2所知道的就是“这是有史以来的第一次执行”。

Answer 2

您可以使用svnlook changed获得受修订影响的文件列表。如果可以使用单个文件作为参数，则只能将所需文件输送到PHPDoc。