找不到DocBlock

Question

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

• 到处移动文档块
• 在命名空间
中添加了说明
• 添加了课程以及我能提出的每个组合
• 再次卸载并安装了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;
    }
}

Answer 1

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

尝试将外部文档块移动到您的课程正上方，因为它看起来像是其内容的重点。在文件的开头添加一个新的docblock，以表示文件本身。在命名空间声明的正上方添加另一个docblock，以表示命名空间。我认为这将清除运行时输出中的警告。