Richtiger Weg, Array-Datentyp für phpDocumentor zu bezeichnen?

Question

Welcher der folgenden Schritte ist der richtige Weg, den Rückgabetyp dieser Methode für phpDocumentor zu dokumentieren?

Methode 1:

/** 
* @return array Foo array. 
*/ 
public function foo() { 
    return array(1, 2, 3); 
} 

Methode 2:

/** 
* @return integer[] Foo array. 
*/ 
public function foo() { 
    return array(1, 2, 3); 
} 

Auch

, gibt es irgendwelche Auswirkungen IDE entweder Methode?

Edit:

Es scheint, dass beide PhpStorm und Netbeans 7.1+ IDEs die zweite Methode unterstützen.

Answer 1

Beide Methoden sind technisch korrekt, aber dieses als 'besser' ist, weil es mehr spezifische (int und integer austauschbar sind) ist:

@return int[] 

hier Dokumentiert:

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

Answer 2

Bei Zum Zeitpunkt des Schreibens dieser Antwort sind dies die akzeptierten Möglichkeiten von phpDocumentor (und wahrscheinlich anderen PHPDoc Implementierungen), ein Array zu bezeichnen:

1. unspezifiziert, keine Definition der Inhalte des dargestellten Arrays ist gegeben. Beispiel: @return array

2. angegebenen einen einzigen Typ enthält, wobei die Definition Type informiert den Leser des Typs jedes Array-Element. Nur ein Type ist dann erwartet als Element für ein bestimmtes Array. Beispiel: @return int[]
   
   Bitte beachten Sie, dass mixed auch ein einzelner Typ ist und mit diesem Begriff es ist möglich, um anzuzeigen, dass jedes Array-Element einen möglichen Typen enthält.

3. mehrere Typen die Type Definition informiert den Leser des Typs jedes Array-Element enthält, angegeben. Jedes Element kann der angegebenen Typen sein. Beispiel: @return (int|string)[]