jsduck - 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-comments - 该代码将是有效的 JavaScipt 并且 JSDuck 会解析它。

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