param-如果@param导致异常，那么将类型放入@param？

Question

如果您得到了以下方法：

/**
* @throws \Exception
**/
function foo($param): void
{
    if (!(is_string($param) | is_array($param))) {
        throw new \Exception('Param is neither string nor array!');
    }

    postProcess($param);
}

方法本身接受所有参数类型，但如果参数既不是字符串也不是数组，则抛出。对于此方法，您更喜欢下面的@param-Tags中的哪一个？

1. @param mixed
2. @param string|array

Answer 1

我猜想这是基于观点的，但是我会设置@param string|array，以便给一个更清晰的解释，支持哪些类型。此外，还可以添加注释(向@throws或@params或同时添加)如下：

/**
 * @throws \Exception If the provided argument is not array or string
 *
 * @param string|array $param Bla-bla-bla. If not array or string - \Exception will be thrown.
 */