php - 未找到 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，以表示命名空间。我认为这将从您的运行时输出中清除该警告。