PHPDoc аннотация для возвращаемого значения bool из трех состояний

Question

У меня есть функция, которая (например) возвращает true, если доступ разрешен, false, если доступ запрещен, и NULL, когда доступ неопределен.

Каким должен быть @return phpdoc? bool кажется, не имеет смысла ...

Answer 1

@return bool|null

См. здесь :

Тип данных должен быть действительным типом PHP (int, string, bool и т. Д.), Именем класса для возвращаемого типа объекта или просто «смешанным». Если вы хотите явно показать несколько возможных типов возврата, перечислите их через пробел без пробелов (например, «@return int | string»).

Answer 2

Если вы хотите следовать стилю php.net относительно типа возвращаемого значения. Когда существует несколько возможных типов возвращаемых данных, они используют тип mixed.

Пример:

http://ca2.php.net/manual/en/function.array-rand.php