jsduck 5.3 创建 PHP-Doc

jsduck 5.3 create PHP-Doc

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

它 3.x 碰巧与 PHP 一起工作的原因是 JSDuck 使用了一堆简单的正则表达式来解析文档注释后的代码,如果它遇到了它没有遇到的代码明白了,它只是忽略了它。所以你能够解析 PHP 的原因是执行不力的意外。

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

使它与 PHP 一起工作的一种骇人听闻的方法是在您的 PHP 代码上使用一些预处理器,它会剥离所有代码并只留下文档注释 - 此代码将然后是有效的 JavaScipt,JSDuck 会解析它。

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