jsduck 5.3 创建 PHP-Doc

Question

今天我用我的 ExtJS 项目试用了 jsDuck 5.3。它真的很好用。但我也评论了 PHP 中的每个方法和类。 我已经看到 JSDuck 3.11.2 可以从 PHP 文件创建完美的在线文档，但 JSDuck 5.3 不能。是否可以将模块或插件加载到 JSDuck 5.3 中？或者是否有其他做法可以通过 jsDuck 5.3 获取 php-doc ？

Answer 1

它 3.x 碰巧与 PHP 一起工作的原因是 JSDuck 使用了一堆简单的正则表达式来解析文档注释后的代码，如果遇到它不理解的代码，它就会忽略它。因此，您能够解析 PHP 的原因是执行不佳的意外。

New JSDuck 使用实际的 JavaScript 解析器，当您尝试向它提供 JavaScript 以外的其他内容时，它会失败。

让它与 PHP 一起工作的一种骇人听闻的方法是在你的 PHP 代码上使用一些预处理器，它会去除所有代码，只留下 doc-cmets - 该代码将是有效的 JavaScipt 并且 JSDuck 会解析它。

另一种选择是打开 JSDuck 的内部并添加一个 PHP 解析器。