इसे तनाव! - PHP में सत्यापन और डेटा कास्टिंग

परिचय

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

लेकिन जब मैंने PHP 5.3 पर स्विच किया, तो मुझे अनाम कार्यों के आधार पर एक नया सत्यापनकर्ता लिखने के लिए तैयार किया गया था। और उसी समय, उनके उपयोग में फिर से अभ्यास करें। मैंने भविष्य की कक्षा के लिए निम्नलिखित आवश्यकताओं को निर्धारित किया है:

• घोषणा (सत्यापन जानकारी वस्तुओं / सरणियों द्वारा निर्दिष्ट की जानी चाहिए)
• लचीलापन (उच्च प्रदर्शन कोड इस वर्ग का उपयोग करके लिखा गया है)
• गति (अधिक कुछ नहीं)

काम की शुरुआत के बाद, यह मेरे लिए हुआ कि इस वर्ग में अनाम कार्यों का उपयोग न केवल सत्यापन के लिए किया जा सकता है, बल्कि डेटा को सही प्रकार (उदाहरण के लिए, एक विशिष्ट प्रकार के लिए) के लिए भी उपयोग किया जा सकता है। आवश्यकताओं की सूची में एक और जोड़ देने से ("बहुमुखी प्रतिभा") मैंने साहसपूर्वक कक्षा का नाम बदलकर स्ट्रेन रख दिया।

आखिर में क्या हुआ ... नीचे पढ़िए। यहां मैं एक मूल समाधान और अन्य बकवास होने का दावा नहीं करूंगा। यदि आप इस दृष्टिकोण को पसंद करते हैं, तो इसे अपनी परियोजनाओं में उपयोग करें, और यदि नहीं, तो नहीं। हताश विकृतियों के लिए, मैं लेख के अंत में स्रोत कोड प्रकाशित करूंगा।

कक्षा का तनाव

जैसा कि मैंने ऊपर लिखा है, वर्ग की कार्यक्षमता दोगुनी है। आइए, इसमें उपयोग किए जाने वाले दोनों प्रकार के अनाम कार्यों और उनके अनुप्रयोग पर एक नज़र डालें। बेशक, कुछ भी आपको एक फ़ंक्शन में उनकी कार्यक्षमता को संयोजित करने से नहीं रोकता है।

मुझे आशा है कि मैं आपको जल्दबाजी में तैयार किए गए नामों और परिभाषाओं से बहुत डरा नहीं सकता।

कास्ट फंक्शन (FP)

डेटा रूपांतरण के लिए एफपी (हमारे मामले में, एक चर)। वास्तव में, इसमें एक डेटा को दूसरे में बदलने के लिए कोई तर्क हो सकता है। उदाहरण के लिए, एक फ़ंक्शन बनाएं जो सब कुछ INTEGER में अनुवाद करेगा।

Strain :: add ( 'integer' , function ( & $value , $options = null ) { <br/>
$value = ( int ) $value ; <br/>
} ) ;

यह सिर्फ एक सरल उदाहरण है। वास्तविक उपयोग में, मैं यहां बिट्स की संख्या पर एक सीमा जोड़ूंगा।

अब इस समारोह के संचालन पर नजर डालते हैं:

$var = '56' ; // ! . <br/>
Strain :: it ( $var , 'integer' ) ; <br/>
var_dump ( $var ) ; <br/>
<br/>
// : int(56)

समारोह मान्यता (PV)

एफवी एक निश्चित स्थिति के अनुपालन के लिए डेटा की जांच करता है और त्रुटि के मामले में एक रिपोर्ट फेंकता है। यदि फ़ंक्शन कुछ भी नहीं लौटाता है (यानी NULL लौटाता है), तो डेटा सही है। एक उदाहरण:

Strain :: add ( 'must_be_integer' , function ( & $value , $options = null ) { <br/>
if ( ! is_int ( $value ) ) return true ; <br/>
} ) ;

टिप्पणियाँ बेमानी हैं। आइए फ़ंक्शन के कार्य को देखें:

$var = '56' ; <br/>
var_dump ( Strain :: it ( $var , 'must_be_integer' ) ) ; <br/>
<br/>
// : TRUE

TRUE एक त्रुटि इंगित करता है। आप लौटे मूल्य को स्ट्रेन :: $ परिणाम में अधिक विस्तार से देख सकते हैं (इस उदाहरण में, यह TRUE से मेल खाता है)

परिष्कृत उदाहरण

अब जब हमने मूल बातें पता लगा ली हैं, तो तनाव - वस्तु सत्यापन के अधिक जटिल अनुप्रयोग पर आगे बढ़ने का समय आ गया है।

सबसे पहले, डेटा ऑब्जेक्ट स्वयं बनाएं। और इसे रहने दें, उदाहरण के लिए, नए उपयोगकर्ता के बारे में डेटा जिसे हम जोड़ना चाहते हैं।

$user = ( object ) array ( <br/>
'email' => 'user@site.com' , <br/>
'name' => 'User' , <br/>
'address' => ( object ) array ( <br/>
'city' => 'Default City' , <br/>
'street' => 'Street' <br/>
) <br/>
) ;

और इसलिए ... हमारे पास किसी प्रकार की वस्तु है जिसमें सही डेटा होना चाहिए और हमारे पास आवश्यक संरचना होनी चाहिए, और हमें इसे डेटाबेस में फेंकने से पहले सुनिश्चित करना चाहिए, और हमें सभी सत्यापन त्रुटियों के बारे में ठीक से पता होना चाहिए। सौभाग्य से, तनाव पूरी तरह से इस समस्या को हल कर सकता है।
एक ऑब्जेक्ट बनाएं जिसके साथ सत्यापन होगा। भविष्य में, मैं ऐसी वस्तुओं को "डेटा फ़िल्टरिंग योजना" (एसएफ) कहूंगा।

$valid = ( object ) array ( <br/>
'email' => array ( 'email' , 'UserExists' ) , <br/>
'name' => array ( 'string' , 'regexp' => '/^[A-Za-z0-9 _-]{3,20}$/' ) , <br/>
'address' => ( object ) array ( <br/>
'city' => 'string' , <br/>
'street' => 'string' <br/>
) <br/>
) ;

एसएफ पर करीब से नज़र डालते हैं। यह तुरंत ध्यान देने योग्य है कि ऑब्जेक्ट पूरी तरह से जाँच की जा रही डेटा की संरचना को दोहराता है, केवल संपत्ति के मूल्य किसी तरह "अजीब" हैं। मुझे यकीन है कि आप में से कई लोग पहले ही अनुमान लगा चुके हैं कि इस वस्तु की रचना कैसे हुई थी।

किसी ऑब्जेक्ट के प्रत्येक मान में एक फ़ंक्शन नाम या कोई अन्य फ़ाइल सिस्टम होता है। उदाहरण के लिए, फ़ंक्शन नामों की एक सूची के रूप में - मिश्रित प्रकार की एक सरणी, जिसमें फ़ंक्शन को पैरामीटर पास करने की क्षमता होती है। याद रखें कि फ़ंक्शन परिभाषा में अस्पष्ट $ विकल्प चर? यह बात है!

अब चेक करना शुरू करते हैं। पहले से ही एक परिचित चुनौती है।

Strain :: it ( $user , $valid ) ; // FALSE

यह देखना न भूलें कि तनाव में क्या रहता है :: $ परिणाम

object ( stdClass ) #7 (3) {<br/>
[ "email" ] => <br/>
NULL <br/>
[ "name" ] => <br/>
NULL <br/>
[ "address" ] => <br/>
object ( stdClass ) #9 (2) {<br/>
[ "city" ] => <br/>
NULL <br/>
[ "street" ] => <br/>
NULL <br/>
} <br/>
}

जैसा कि हम देखते हैं कि ऑब्जेक्ट त्रुटियों को छोड़े बिना फ़िल्टर किया गया था।

विधि का एक अतिरिक्त लचीलापन यह है कि स्ट्रेन :: ऐड () विधि का उपयोग करके, आप न केवल स्वयं अनाम कार्यों को जोड़ सकते हैं, बल्कि एसएफ जिसे आपने ऊपर देखा था। जब फ़ंक्शन में से एक स्वयं की जांच शुरू करता है तो पुनरावृत्तियां भी संभव हैं। (नीचे देखें)

टिप्पणियों की जोड़ी

इससे पहले कि आप इस वर्ग के साथ खिलवाड़ करना शुरू करें, आपको कुछ और गुर सीखने चाहिए।

यदि डेटा को फ़ंक्शन की सूची द्वारा जांचा जाता है, तो पहले फ़ंक्शन से परिणाम जो कुछ लौटाता है, $ परिणाम में मिल जाएगा। लेकिन यदि फ़ंक्शन FALSE लौटाता है, तो परिणाम NULL होगा, और श्रृंखला का निष्पादन बंद हो जाएगा। यह बिना किसी त्रुटि के चेक को रोकने का एक आसान तरीका है, उदाहरण के लिए, यदि मान NULL हो सकता है, लेकिन सेट किया जा सकता है, और आपको एक चेक करने की आवश्यकता है। एक उदाहरण:

$valid = array ( 'null' , 'string' , 'length' => array ( 2 , 10 ) ) ;

'अशक्त' फ़ंक्शन में, आपको लिखने की ज़रूरत है ताकि यह FALSE लौटाए, यदि यह एक पूर्ण मान प्राप्त करता है, तो आगे सत्यापन नहीं किया जाएगा और कोई त्रुटि नहीं दिखाई देगी।

एक ही डेटा के साथ एक सरणी की जाँच का एहसास।

$valid = array ( 'array_of' => array ( 'string' , 'length' => array ( 2 , 10 ) ) ) ;

एसएफ को आसानी से एक फ़ंक्शन में कैसे स्थानांतरित किया जाता है, इसका एक उदाहरण, जिसे वह अपने विवेक पर उपयोग कर सकता है। इस मामले में, वे सरणी के प्रत्येक तत्व की जांच करते हैं।

एक और दिलचस्प उदाहरण। शर्तों को लागू करें या।

$valid = array ( 'mixed' => array ( 'null' , array ( 'string' , 'length' => array ( 2 , 10 ) ) ) ) ;

यह ऊपर दिए गए NULL के साथ उदाहरण के समान है, केवल इस फ़ंक्शन द्वारा FALSE को वापस किए बिना। इसी तरह, आप विभिन्न एक्सओआर, एनआर और बीआरआरआर को लागू करने वाले कार्यों के साथ आ सकते हैं!

अंत में, मैं तनाव के तीसरे पैरामीटर के बारे में बात करना चाहता हूं :: यह () विधि। यह उस व्यवहार को परिभाषित करता है जो डेटा पर लागू होता है। पैरामीटर मान:

0: डेटा संरचना को नहीं बदलता है;
1: फ़िल्टर संरचना में निर्दिष्ट गुणों को डेटा संरचना में जोड़ता है;
2: डेटा संरचना से फ़िल्टर संरचना में निर्दिष्ट गुण नहीं निकालता है;
3: 1 और 2 एक साथ। (डिफ़ॉल्ट रूप से। केवल इस मान के साथ यह गारंटी दी जाती है कि फ़िल्टर करने के बाद वाली वस्तु में SF के समान संरचना होगी, भले ही आप ऑब्जेक्ट के बजाय कुछ NULL डाल दें )

यानी वर्ग वस्तुओं के अनावश्यक गुणों को हटा सकता है, उन्हें नए जोड़ सकता है और एसएफ के अनुरूप नहीं होने पर प्रतिस्थापित कर सकता है। निर्मित गुण डिफ़ॉल्ट रूप से NULL हैं और फ़िल्टरिंग के लिए भेजे गए हैं।

निष्कर्ष

दुर्भाग्य से, मैंने 'array_of' और 'मिश्रित' को छोड़कर, स्रोतों में अनाम फ़ंक्शन शामिल नहीं किए। किसी भी मामले में, उन्हें लिखना बहुत आसान है, और हर कोई अभी भी उन्हें अपने तरीके से बनाना चाहेगा।

उपयोग में आसानी और कोड के विज़ुअलाइज़ेशन के लिए, मैं सुझाव देता हूं कि आप एफपी और पीवी के नामों की वर्तनी को अलग करें। उदाहरण के लिए, सभी FI को शुरुआत में (या अंत में) '!' अक्षर वाले नाम दिए जाने चाहिए। या एक पैरामीटर के साथ आओ जो स्पष्ट रूप से तर्क को इंगित करेगा।

महत्वपूर्ण! फिलहाल, कक्षा का परीक्षण अभी भी किया जा रहा है और आप इसे उत्पाद में केवल अपने जोखिम और जोखिम पर उपयोग कर सकते हैं।

जैसा कि वादा किया गया है, स्रोत का लिंक:
गिटहब पर तनाव के स्रोत

PS और क्या किसी को भी जेएस की जरूरत है?

अद्यतन: यदि कोई बहुत भ्रमित है कि यह () विधि TRUE देता है जब कोई त्रुटि होती है और FALSE जब यह नहीं है, और इसके विपरीत नहीं है, तो वे इसके कोड को सही कर सकते हैं। यह कक्षा के काम को प्रभावित नहीं करता है।
अद्यतन 2: चेक () पद्धति को वर्ग में जोड़ा गया है, जो इसके () विधि के समान है, लेकिन यदि कोई त्रुटियां और FALSE नहीं हैं तो TRUE लौटाता है।
अद्यतन 3: स्कीमा में सीधे कार्यों को निर्दिष्ट करने की क्षमता को जोड़ा गया, साथ ही योजनाओं के सरणियों में योजनाबद्ध वस्तुओं को सम्मिलित करने की क्षमता, जो शायद किसी अन्य लेख पर खींचती है, क्योंकि संक्षेप में यह समझाया नहीं जा सकता है। एक उदाहरण मैंने टिप्पणियों में पोस्ट किया है।