Ответ 1
Использование
@return TClass3[]
или
@return TClass3[]|TClass3
Этот вопрос связан с этим:
Можно ли намекать на тип элементов внутри возвращаемого массива?
например.
/**
* MyFunction does a lot of things
*
* @param TClass1 $var1
* @param TClass2 $var2
* @return array[TClass3] //<- I'm trying to express this
*/
function MyFunction( $var1, $var2 ){
...
Я использую NetBeans как среду IDE, которая использует (как и многие другие PHP IDE) преимущества блоков doc над функциями для определения типа возвращаемых значений.
Если бы я мог объяснить, какой тип ожидается внутри массива, я мог бы надеяться, что IDE сможет предложить правильное завершение для следующего случая:
$myTab = MyFunction( $foo, $bar );
foreach( $myTab as $itm ){
$itm->myFi| //offer the completion for a TClass3 object
}
Использование
@return TClass3[]
или
@return TClass3[]|TClass3
Вы пытаетесь намекнуть на возвращаемый тип, чтобы документация генерировала его? Если это возможно, вы могли бы это сделать, вы также могли бы поместить его в описание этой переменной.
Это комментарий, вам разрешено что-то делать в нем.