Php 未找到DocBlock

我不能让这个错误消失。我试过：

• 到处移动doc块
• 向命名空间添加了说明
• 添加了类和我能想到的每一个组合
• 再次卸载并安装phpdoc

我的代码：

<?php
/**
 * Number manipulation class
 *
 * This class handles any methods that are used
 * to manipulate numbers
 *
 * @version 1.0
 * @package core
 * @category class
 * @author MY NAME HERE
 * @license MIT http://opensource.org/licenses/MIT
 */
namespace limber\core;

class Num
{
    /**
     * Random number generator
     *
     * @param $length int The length of the number required
     * @return $num int A random number
     * @author Unknown
     */
    public static function random($length = 8)
    {
        $characters = "0123456789abcdefghijklmnopqrstuvwxyz";
        $num = "";
        for ($p = 0; $p < $length; $p++) {
            $num .= $characters[mt_rand(0, strlen($characters))];
        }
        return $num;
    }
}

---

从phpdDocumentor的角度来看，它看到一个文件级docblock，后面是一个没有自己docblock的命名空间声明，然后是一个没有自己docblock的类。您得到的警告消息可能与类没有docblock有关

尝试移动外部docblock，使其显示在类的正上方，因为这似乎是其内容的要点。在文件开头添加一个新的docblock，以表示文件本身。在名称空间声明的正上方添加另一个docblock，以表示名称空间。我认为这将清除运行时输出中的警告。
第一条注释不应该在类声明之上吗？我让注释在类声明之上，它没有改变任何东西我尝试了各种不同的docblock组合，但没有任何成功…我测试并失败的特定请求是可用的@