phpDocumentor के लिए सरणी डेटा प्रकार को इंगित करने का सही तरीका?

Question

phpDocumentor के लिए इस विधि के रिटर्न प्रकार को दस्तावेज करने का सही तरीका निम्न में से कौन सा है?

विधि 1:

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

विधि 2:

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

इसके अलावा, वहाँ किसी भी विधि से किसी भी आईडीई निहितार्थ हैं?

संपादित करें:

यह दोनों PhpStorm और Netbeans 7.1+ IDEs का समर्थन करने वाले 2 विधि प्रकट होता है।

Answer 1

दोनों ही तरीकों से तकनीकी रूप से सही हैं, लेकिन यह एक 'बेहतर' है क्योंकि यह अधिक विशिष्ट (int और integer परस्पर विनिमय कर रहे हैं) माना जाता है:

@return int[] 

यहाँ प्रलेखित:

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

Answer 2

पर इस उत्तर को लिखने का क्षण, ये phpDocumentor (और शायद अन्य PHPDoc कार्यान्वयन) के स्वीकृत तरीके हैं: एक सरणी को इंगित करने के लिए:

1. अनिर्दिष्ट, का प्रतिनिधित्व किया सरणी की सामग्री की कोई परिभाषा दिया है। उदाहरण: @return array

2. एक प्रकार, Type परिभाषा प्रत्येक सरणी तत्व के प्रकार के पाठक को सूचित युक्त निर्दिष्ट। केवल Type किसी दिए गए सरणी के लिए तत्व के रूप में अपेक्षित है। उदाहरण: @return int[]
   
   कृपया ध्यान दें कि mixed भी एक ही प्रकार है और इसी कीवर्ड के साथ यह संकेत मिलता है कि प्रत्येक सरणी तत्व किसी भी संभव प्रकार हैं संभव है।

3. कई प्रकार के युक्त निर्दिष्ट, Type परिभाषा प्रत्येक सरणी तत्व के प्रकार के पाठक को सूचित। प्रत्येक तत्व दिए गए प्रकारों के का हो सकता है। उदाहरण: @return (int|string)[]