phpdocumentor 2无法完成文档生成。

Question

我想使用phpDocumentor 2，但是它表现有些奇怪。 我正在运行Windows 7 x64和XAMPP。 我使用pear安装了它pear install phpdoc/phpDocumentor-beta。 安装过程顺利，但当我尝试运行它时，它显示这个。

$ phpdoc -f C:\xampp\htdocs\tests\comments.class.php -t C:\xampp\htdocs\tests/build/api/ -i C:\xampp\htdocs\tests/build/api/
Collecting files .. OK
Initializing parser .. OK
Parsing files
Parsing C:\xampp\htdocs\tests\comments.class.php
  No summary for property $link
  No summary for property $error
  No summary for method grabComment()
  No summary for method generateComments()
  No summary for method generateReplies()
  No summary for method generateForm()
  No summary for method isValidMail()
  No summary for method ip()
Storing cache in "C:\xampp\htdocs\tests\build\api" .. OK
Load cache                                                           ..    0.003s
Preparing template "responsive-twig"                                 ..    0.054s
Preparing 15 transformations                                         ..    0.000s
Build "elements" index                                               ..    0.000s
Replace textual FQCNs with object aliases                            ..    0.001s
Build "packages" index                                               ..    0.002s
Build "namespaces" index and add namespaces to "elements"            ..    0.000s
Transform analyzed project into artifacts                            ..    2.961s
Analyze results and write report to log                              ..    0.000s

然后它就停止了...
当我检查生成的文档时，没有显示有关类的数据
有人遇到过这个问题吗？

- Mihai Vilcu

---

刚遇到了完全相同的问题，同样的平台，同样的行为。正在调查中... - jek

请告诉我如果你发现了什么。 - Mihai Vilcu

Answer 1

我猜这是由于不完整和测试版的默认模板responsive-twig引起的。没有错误报告，因为没有错误。PHPDocumentor完成时没有任何错误。

将模板更改为responsive会使事情变得更好。您可以通过添加

<transformations>
  <template name="responsive" />
</transformations>

要将其转换为响应式文档，您可以将其添加到您的phpdoc.xml文件中或提供--template=responsive命令行选项。我没有尝试其他模板。

最终，我现在还是坚持使用doxygen，直到PHPDocumentor2的模板更加完整和功能丰富。

- jek