क्यों मैं इस कोड पर PhpStorm में एक phpdoc चेतावनी मिलता है

Question

मैं नहीं समझ सकता क्यों PhpStorm मुझे इस विधि से अधिक निम्न चेतावनी PHPDoc comment does not match function or method signature देता है:

/** 
* Create a new instance of the class 
* @param string $classname Class to instantiate 
* @return object the instance 
* @throw FactoryException If the class is not instantiable 
*/ 
private function newInstance($classname) { 
    $reflectionClass = new \ReflectionClass($classname); 
    if (! $reflectionClass->isInstantiable()) { 
     throw new FactoryException("The class $classname is not instantiable."); 
    } 
    return new $classname; 
} 

चेतावनी, बहुत विशिष्ट नहीं है मैंने रिटर्न प्रकार को "ऑब्जेक्ट", "मिश्रित" या यहां तक ​​कि "int" (कोशिश करने के लिए) को बदलने जैसी कई चीजों की कोशिश की लेकिन यह नहीं बदला। यहां क्या समस्या है ?

Answer 1

यह @throws@throw होना चाहिए।

यदि आप किसी फ़ंक्शन या क्लास की घोषणा के अनुसार /** टाइप करते हैं तो यह आपके लिए एक आधार PHPDoc डालेंगे। इस तरह मैंने अंतर देखा।

Answer 2

इस पद्धति लागू करने के लिए/एक माता पिता के वर्ग जहां एक docblock इसके लिए मौजूद है से ओवरराइड यदि ऐसा होता है, अगर दोनों भर में अपने टैग मैच देखते हैं। आम तौर पर, माता-पिता में टैग बच्चे द्वारा विरासत में प्राप्त किए जाएंगे, जैसे कि यदि माता-पिता की विधि डॉकब्लॉक में पहले से ही वही टैग (पैरा, रिटर्न, फेंकता है) है, तो उन्हें बच्चों के डॉकब्लॉक में सूचीबद्ध करना आवश्यक नहीं है, जब तक कि उन्हें विशेष रूप से आवश्यकता न हो माता-पिता के काम से कुछ अलग कहने के लिए।

Answer 3

इस लिंक को देखें https://blog.jetbrains.com/webide/2011/05/phpdoc-inspections/ यह है कि उल्लेख किया गया है "निरीक्षण एक समस्या की रिपोर्ट करने पर phpdoc टिप्पणी में वर्णित अनेक मानदंड और/या उनके प्रकार एक इसी समारोह या विधि घोषणा से मेल नहीं खाते"