वाई में मान्यता

शुभ दिन। आज मैं इन मॉडलों के सत्यापन के रूप में वाईआईआई फ्रेमवर्क की ऐसी दिलचस्प विशेषता को बाहर करना चाहता हूं। लेखन के समय, फ्रेमवर्क का वर्तमान संस्करण 1.1.10 है , और हम वास्तव में इस पर सत्यापन पर विचार करेंगे।
मैं तुरंत कहना चाहता हूं कि मैं मैनुअल और एपीआई को फिर से लिखना नहीं चाहता हूं, इसलिए जब भी संभव हो मैं तैयार स्रोतों का उल्लेख करूंगा। इसके अलावा, मैं वर्णन नहीं करूंगा कि सत्यापनकर्ताओं का उपयोग कैसे किया जाए। मैं सत्यापन नियमों के आधार पर वाईआई मॉडल के सत्यापन के तंत्र को उजागर करने की कोशिश करूंगा ताकि उनका उपयोग करके आप समझ सकें कि वास्तव में क्या होता है और आप किस मामले में त्रुटियों की तलाश कर सकते हैं।

अंडरस्टैंडिंग वैलिडेटर्स की शुरुआत

तो, अद्भुत साइट yiiframewrok.ru पर व्यंजनों के लिए एक अनुभाग है।
इस अनुभाग में सत्यापन के लिए त्वरित मार्गदर्शिका है । इस लेख का मूल इस पते पर स्थित है।
इस लेख को पढ़ने के बाद आप समझेंगे:

1. सत्यापन नियम कैसे सेट करें
2. एक विशिष्ट नियम क्या है?
3. मानक सत्यापनकर्ताओं और उनके मापदंडों की एक सूची का पता लगाएं

अगला, एक मॉडल ( मूल ) बनाना लेख पढ़ें जिससे आप सीखेंगे:

1. लिपियों के बारे में कुछ। (मैं इस बिंदु पर जोर देना चाहता हूं, यह खराब दस्तावेज है)
2. सत्यापनकर्ता कैसे बनाएँ
3. सत्यापन कैसे करें

वैसे, अपने स्वयं के सत्यापनकर्ता बनाने के उदाहरणों को पुस्तक में अच्छी तरह से वर्णित किया गया है: Yii 1.1 एप्लीकेशन डेवलपमेंट कुकबुक
अर्जित ज्ञान के साथ सशस्त्र, हम आगे बढ़ सकते हैं और पता लगा सकते हैं कि क्या होता है जब कहा जाता है: CModel::validate();

CModel में गहरा :: सत्यापन ();

CModel::validate($attributes=null, $clearErrors=true); विधि CModel::validate($attributes=null, $clearErrors=true); - इनपुट के रूप में 2 वैकल्पिक मापदंडों को स्वीकार करता है (सत्यापन के लिए विशेषताओं की एक सूची, और एक स्पष्टता कुंजी, जो सत्यापनकर्ताओं को कॉल करने से पहले त्रुटियों के साथ सरणी को साफ करता है)
यह समझना महत्वपूर्ण है कि क्या आप मानक Yii मॉडल का विस्तार करेंगे और CModel::addError(); विधि का उपयोग करेंगे CModel::addError(); अपने स्वयं के प्रयोजनों के लिए, जैसा कि CModel::validate(); यदि CModel::hasErrors(); डेटा सफलतापूर्वक और झूठा प्रमाणित हुआ है तो CModel::hasErrors(); सच हो जाएगा।
इसके अलावा, यहां यह ध्यान दिया जाना चाहिए कि यदि आप CModel::beforeValidate(); विधि को ओवरराइड करते हैं, तो वशीकरण काम नहीं करेगा CModel::beforeValidate(); और वह झूठा लौट आया।
पाठ को पतला करने के लिए, आइए कोड को देखें और सब कुछ कमोबेश स्पष्ट हो जाएगा:

1. सार्वजनिक फ़ंक्शन मान्य ( $ विशेषताएँ = अशक्त , $ स्पष्टता = सत्य )
2. {
3. अगर ( $ clearErrors )
4. $ यह -> clearErrors ( ) ;
5. अगर ( $ यह -> पहले से अमान्य ) ( )
6. {
7. foreach ( यह $ -> getValidators ( ) $ सत्यापनकर्ता के रूप में )
8. $ सत्यापनकर्ता -> मान्य ( $ यह , $ विशेषताएँ ) ;
9. $ यह -> afterValidate ( ) ;
10. वापसी ! $ इस -> हैरियर्स ( ) ;
11. }
12. अन्यथा
13. झूठे लौटना ;
14. }

मुझे लगता है कि यहां और प्रश्न नहीं हैं, इसलिए चलो CModel::getValidator() विधि को बेहतर तरीके से देखें

foreach ( यह $ -> getValidators ( ) $ सत्यापनकर्ता के रूप में )

यह समझने के लिए कि Yii को CModel::rules() विधि में निर्दिष्ट नियमों के आधार पर सत्यापनकर्ताओं की सूची कैसे मिलती है

CModel :: getValidators ()

1. सार्वजनिक समारोह getValidators ( $ विशेषता = अशक्त )
2. {
3. अगर ( $ यह -> _validators === नल )
4. $ यह -> _validators = $ this -> createValidators ( ) ;
6. $ सत्यापनकर्ता = सरणी ( ) ;
7. $ परिदृश्य = $ यह -> getScenario ( ) ;
8. foreach (इसे $ -> _validators $ सत्यापनकर्ता के रूप में )
9. {
10. अगर ( $ सत्यापनकर्ता -> applyTo ( $ परिदृश्य ) ) {
11. if ( $ विशेषता === null || in_array ( $ विशेषता , $ सत्यापनकर्ता -> गुण , सत्य ) )
12. $ सत्यापनकर्ता [ ] = $ सत्यापनकर्ता ;
13. }
14. }
15. $ सत्यापनकर्ता लौटें ;
16. }

विधि मॉडल में नियमों द्वारा वर्णित सत्यापनकर्ताओं की एक सरणी देती है।
यहां एक दिलचस्प बिंदु 7 वीं पंक्ति से शुरू होता है। मैंने उपरोक्त लिपियों का उल्लेख किया। इसलिए, यहां हम देखते हैं कि सत्यापनकर्ता को केवल श्रृंखला में जोड़ा जाता है यदि विधि CValidator::applyTo($scenario);
सही लौटेगा, और यह सच है कि या तो मामले में वापस आ जाएगा जब "ऑन" पैरामीटर सेट नहीं होता है या मामले में जब सत्यापनकर्ता उस परिदृश्य को संदर्भित करता है जिसमें मॉडल निष्पादित होता है।
आगे बढ़ो। CModel विधि पर विचार करें CModel:createValidators();

$ यह -> _validators = $ this -> createValidators ( ) ;

जो संक्षेप में सत्यापन नियमों के विश्लेषण का निचला और अंतिम स्तर होगा, और फिर हम कुछ परिणामों को संक्षेप में प्रस्तुत करेंगे।

पूरा होने के करीब: CModel :: createValidators ()

1. सार्वजनिक समारोह createValidators ( )
2. {
3. $ सत्यापनकर्ता = नया CList ;
4. foreach ( यह $ -> नियम ( ) $ नियम के रूप में )
5. {
6. if ( isset ( $ रूल [ 0 ] , $ रूल [ 1 ] ) ) // विशेषताएँ, सत्यापनकर्ता नाम
7. $ सत्यापनकर्ता -> जोड़ें ( सीवीइलेटरेटर :: createValidator ( $ नियम [ 1 ] , $ यह , $ नियम [ 0 ] , array_slice ( $ नियम , 2 ) ) ) ;
8. अन्यथा
9. नए CException ( Yii :: t ( 'yii' ) को फेंकें , '{class} में एक अमान्य सत्यापन नियम है। नियम को मान्य और सत्यापनकर्ता नाम को निर्दिष्ट करना होगा।' , array ( '{class}' => get_class ( $) यह ) ) ) ;
10. }
11. $ सत्यापनकर्ता लौटें ;
12. }

इसलिए हम निचले स्तर पर पहुंच गए हैं। यह विधि केवल CModel::rules() में वर्णित बहुत ही सत्यापन नियमों का विश्लेषण CModel::rules() और स्थैतिक वर्ग विधि CValidator::createValidator() करके इन नियमों द्वारा वर्णित सत्यापनकर्ता ऑब्जेक्ट बनाता है।
CValidator::createValidator() का एपीआई CValidator::createValidator() विधि देखें और सत्यापन नियम के मानक मापदंडों को याद रखें

1. सरणी (
2. 'मॉडल क्षेत्रों की सूची' ,
3. 'सत्यापनकर्ता'
4. 'ऑन' => 'स्क्रिप्ट का नाम' ,
5. 'संदेश' => 'त्रुटि संदेश' ,
6. ... सत्यापन पैरामीटर ...
7. ) ;

सब कुछ तुरंत जगह में गिर जाता है।

संक्षेप में कहना

जैसा कि आप देख सकते हैं, सत्यापन नियमों को पार्स करने के लिए एल्गोरिथ्म इतनी जटिल चीज नहीं है। मुख्य बात समस्या को समझने और समझने की इच्छा है। यह समझना कि कोड कैसे काम करता है, विकास के दौरान बहुत से विभिन्न प्रश्न उठते हैं, जब कुछ गलत होता है और प्रोग्राम गलत तरीके से चलता है।

अंत में, हम कुछ विशेषताओं को संक्षेप में प्रस्तुत कर सकते हैं जो यह समझने में मदद करेगी कि शायद आपका सत्यापनकर्ता काम नहीं करता है जैसा कि हम चाहेंगे, या कुछ सत्यापन नियम क्यों पूरा नहीं होता है।

• जब CModel::validate() विधि कहा जाता है, तो यह जाँचता है कि CModel::beforeValidate() विधि CModel::beforeValidate() ।
  यदि विधि विफल हो जाती है, तो सत्यापन विफल माना जाता है
• यदि CModel::hasErrors() विधि सही है, तो सत्यापन विफल माना जाता है
• जब CModel::getValidators() विधि कहलाती है, तो केवल वे स्क्रिप्टर्स जो वर्तमान स्क्रिप्ट के लिए प्रासंगिक हैं, को जोड़ दिया जाता है, साथ ही सत्यापनकर्ता जिसके लिए स्क्रिप्ट नियमों में निर्दिष्ट नहीं है