jsduck 5.3 create PHP-Doc

Question

Сегодня я опробовал jsDuck 5.3 с моим проектом ExtJS. Он работает очень хорошо. Но я также прокомментировал каждый метод и класс в PHP. Я видел, что JSDuck 3.11.2 может создавать онлайн-документацию из PHP-файлов, но JSDuck 5.3 этого не делает. Можно ли загрузить модуль или плагин в JSDuck 5.3? Или существует другая практика получения php-doc jsDuck 5.3?

Answer 1

Причина, по которой он 3.x работал с PHP, заключался в том, что JSDuck использовал кучу простых регулярных выражений для разбора кода, следующего за комментарием doc, если он столкнулся с кодом, который он не понял, он просто проигнорировал его. Таким образом, причина, по которой вы смогли разобрать PHP, была неудачной реализацией.

Новый JSDuck использует фактический синтаксический анализатор JavaScript, который терпит неудачу, когда вы пытаетесь передать его чем-то, кроме JavaScript.

Один хакерский способ заставить его работать с PHP будет использовать некоторый препроцессор на вашем PHP-коде, который удаляет весь код и оставляет только комментарии doc-комментариев - тогда этот код будет действительным. JavaScipt и JSDuck проанализируют его ,

Другой вариант - открыть внутренние компоненты JSDuck и добавить к нему парсер PHP.