当我使用phpDocumentor生成 API 文档时,页面Reports -> Markers总是说No marker has found in this project尽管我的 PHP 代码中有几个TODO标记。
我有 phpDocumentor v3.0.0。我运行它:php phpDocumentor.phar --markers
我的phpdoc.dist.xml文件包含:
<?xml version="1.0" encoding="UTF-8" ?>
<phpdocumentor
configVersion="3"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="https://www.phpdoc.org"
xsi:noNamespaceSchemaLocation="https://docs.phpdoc.org/latest/phpdoc.xsd">
<paths>
<output>apidocs/docs</output>
<cache>apidocs/cache</cache>
</paths>
<version number="3.0.0">
<api>
<source dsn=".">
<path>src</path>
<path>*.php</path>
</source>
<markers>
<marker>TODO</marker>
</markers>
</api>
</version>
</phpdocumentor>
我在我的 PHP 代码中使用 TODO 标记,如下所示:
/**
* TODO marker 1
*/
function someFunction(...) {
// ...
}
function anotherFunction(...) {
// TODO marker 2
// ...
}