ZF-3900: Returning Arrays of Certain Types
In most applications, when returning an array of data this is restricted to one type. Wouldn't it be a good practice to adopt java language syntax style "type" to declare the return type "array of types" in the @return Doc Comment?
This usage is more important in the AutoDiscovery generation of WSDL file than to declare the "correct" return value "array" for generating a PHPdoc API document. I think it could be accepted for usage as syntax description of this types. And although it has been rejected as PHP specific implementation in method headers using it in @return is still a very good practice.
As I can take from the following php.net comment this is also practice in Zend Studio: http://de2.php.net/manual/en/…