Doxygen for php 不处理默认参数数组

Question

我尝试为我的问题寻找解决方案，但我找不到任何东西。我的问题是 php 的 doxygen 不处理默认参数，如果它们是一个数组：

代码：

/**
 * @brief convert rgb values to hexa decimal, and return array.
 * @param  int $red   : 0 - 255
 * @param  int $green : 0 - 255
 * @param  int $blue  : 0 - 255
 * @param  array  $default
 * @return array
 */
public static function rgb2hex(
    int   $red   = 0,
    int   $green = 0,
    int   $blue  = 0,
    array $default = ['r' => 0, 'g' => 0, 'b' => 0]
) : array {
...
    return [
        'r' => $r,
        'g' => $g,
        'b' => $b
    ];
}

渲染：

屏幕示例：https://i.stack.imgur.com/bJhiu.png

Answer 1

doxygen 1.9 2021 看不懂 PHP array = [ ];,

一种解决方法是使用老派：array = ( );

注意：查看[ ]和array = ( );之间的区别