在PHP-Docs中放置NULL值的位置?在末尾?

时间:2015-10-21 08:21:04

标签: php types coding-style standards phpdoc

关于PHP-Docs和NULL-Values的简短问题。

我发现了以下链接:

http://www.phpdoc.org/docs/latest/guides/types.htmlhttp://www.phpdoc.org/docs/latest/references/phpdoc/types.html

但是他们不提这些类型的顺序。那么它可以自由选择吗?

我现在这样做:

/**
 * @param integer|null $a
 * @return array|null Array if succeed, NULL on Error
 */
function test($a = null)
{
    if($noValueFoundOrSomething)
        return null;

    return array();
}

但有些人这样做:

/**
 * @param null|integer $a
 * @return null|array Array if succeed, NULL on Error
 */
function test($a = null)
{
    if($noValueFoundOrSomething)
        return null;

    return array();
}

也许它可以自由选择,但最佳做法是什么?关于在PHP-Docs中放置NULL值的位置是否有任何标准?

0 个答案:

没有答案