php - 在 PhpDocumentor 2 中使用 @package 而不是命名空间

Question

我有一个大型代码库，我正在尝试为其生成分层文档。该项目不使用命名空间，而是使用 @package。

我刚刚尝试使用 phpDocumentor2 从以下文件生成文档作为测试：

<?php
/**
 * This is a file
 * @package JustAn\Example
 **/

 /**
 * Something class
 **/
 class Something{
    function try_this(){

    }
 }

虽然根据文档@package JustAn\Example 应该等同于命名空间 JustAn\Example，但我发现情况并非如此。

当我使用命名空间时，生成的文档是这样的：

命名空间版本

当我使用@package 符号时，结果看起来像这样（即使它识别包符号 - 这显示在类的完整详细信息页面上）：

包符号版本

我正在寻找一种方法来获得分层结果，而无需重写代码以使用“真实”命名空间。

score 4 · Accepted Answer

问题是默认的“干净”模板不支持此功能。其他模板（例如“响应式”）可以。您可以使用 --template="responsive" 标志来更改使用的默认模板。

score 0 · Accepted Answer

我看到您在文件docblock 中有包标签，但没有类docblock。如果你将它添加到你的类文档块中，我认为它应该可以工作。

2 回答 2