Небольшой вопрос о PHP-Docs и NULL-Values.
Я нашел эти ссылки об этом:
http://www.phpdoc.org/docs/latest/guides/types.html или же http://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();
}
Может быть, он свободен в выборе, но какова лучшая практика? Есть ли какой-нибудь стандарт о том, где поместить значение NULL в PHP-документах?
Задача ещё не решена.
Других решений пока нет …