MySQLi ने सब कुछ समतल पर रखा

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

क्या यह लेख उन लोगों को पढ़ना संभव है जो अभी भी पुराने mysql एक्सटेंशन का उपयोग कर रहे हैं और केवल PDO या MySqli पर स्विच करने के बारे में सोच रहे हैं? मुझे लगता है कि यह और भी आवश्यक है।

MySqli या PDO

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

MySqli और PDO के बीच चयन करना आवश्यक था। बहुत लंबे अध्ययन के बाद, मैंने MySqli पर रुकने का फैसला किया, क्योंकि तब मुझे ऐसा लग रहा था, यह पूरी तरह से पीडीओ के समान था, सिवाय इसके कि कुछ और के पक्ष में MySQL को छोड़ने का कोई तरीका नहीं था। जैसा कि मैंने नीचे लिखा है यह पूरी तरह से सच नहीं है, कम से कम एक ध्यान देने योग्य अंतर है।

MySqli को PHP डेवलपर्स द्वारा स्वयं उपयोग करने के लिए अनुशंसित किया गया है। [ १ ]

OOP और प्रक्रियात्मक इंटरफ़ेस

MySqli आपको OOP और प्रक्रियात्मक शैली दोनों में कोड लिखने की अनुमति देता है। ओओपी मेरे लिए सबसे अधिक हब्र समुदाय के करीब है, इसलिए इसका उपयोग इस लेख में किया जाएगा।

तीन मुख्य वर्ग

MySqli के 3 मुख्य वर्ग हैं, जिनके बारे में इस लेख में विस्तार से चर्चा की जाएगी।

1. mysqli - डेटाबेस से संबंध स्थापित करने के लिए आवश्यक है और उपयोगी होगा यदि हम उसी तरह से प्रश्नों को निष्पादित करना चाहते हैं जैसे हमने पुराने MySQL एक्सटेंशन में किया था;
2. mysqli_stmt - नई MySqli सुविधा का उपयोग करने के लिए आवश्यक: तैयार अभिव्यक्तियों के विरुद्ध प्रश्नों का निष्पादन;
3. mysqli_result - mysqli या mysqli_stmt का उपयोग करके किए गए प्रश्नों के परिणाम प्राप्त करने के लिए कार्यों को जोड़ती है।

आइए नीचे उनमें से प्रत्येक पर अधिक विस्तार से विचार करें।

DB कनेक्शन

इसके दो तरीके हैं।

पहला तरीका। अगर आपको सिर्फ एक कनेक्शन बनाने की जरूरत है।

$ mysqli = new mysqli ( 'localhost' , 'my_user' , 'my_password' , 'my_db' ) ;
अगर ( $ mysqli -> connect_error ) {
die ( 'कनेक्ट एरर (' । $ mysqli -> connect_errno । ')' । $ mysqli -> connect_error ) ;
}

दूसरा तरीका। यदि आपको कनेक्शन विकल्प का उपयोग करने की आवश्यकता है।

$ mysqli = mysqli_init ( ) ;
अगर ( $ mysqli ) {
मर ( 'mysqli_init विफल' ) ;
}

अगर ( $ mysqli -> विकल्प ( MYSQLI_INIT_COMMAND , 'SET AUTOCOMMIT = 0' ) ) {
मरो ( 'सेटिंग MYSQLI_INIT_COMMAND विफल' ) ;
}

अगर ( $ mysqli -> real_connect ( 'localhost' , 'my_user' , 'my_password' , 'my_db' ) ) {
die ( 'कनेक्ट एरर (' । $ mysqli -> connect_errno । ')' । $ mysqli -> connect_error ) ;
}

$ Mysqli-> connect_errno और $ mysqli-> connect_error का उपयोग करते हुए हमें वर्णन और त्रुटि कोड मिलता है जो कनेक्ट करते समय हुआ। दोनों नई mysqli () और $ mysqli-> real_connect () त्रुटियों को जोड़ने पर PHP चेतावनी त्रुटि का कारण होगी । इसलिए, उपरोक्त कार्यों का उपयोग करने में त्रुटि आउटपुट समझ में आता है कि क्या आपके पास PHP त्रुटि प्रदर्शन है, उदाहरण के लिए, किसी उत्पादन सर्वर पर, या यदि आपको किसी तरह इस डेटा को संसाधित करने की आवश्यकता है। मैंने यहां इसका उल्लेख किया है क्योंकि सभी MySQLi फ़ंक्शन त्रुटि के मामले में PHP चेतावनी को नहीं कहते हैं, और यह पता लगाने के लिए कि एक त्रुटि हुई है, विशेष कार्यों को संदर्भित करना आवश्यक है, उस पर और अधिक।

कनेक्शन के दौरान प्राप्त की गई वस्तु को भविष्य में उपयोग करने के लिए $ mysqli चर को सौंपा गया था। यह OOP शैली के लिए स्पष्ट है, लेकिन प्रक्रियात्मक शैली के लिए, यह ऑब्जेक्ट भी आवश्यक है, यह विरासत MySQL एक्सटेंशन के विपरीत है, जहां हर बार जब आप mysql फ़ंक्शन का उपयोग करते हैं तो कनेक्शन संदर्भ पास करना आवश्यक नहीं था।

बफर और गैर-बफर परिणाम

आगे बताने से पहले, मैं इन दो प्रकार के परिणामों के बीच के अंतर को समझाना चाहूंगा।

असंबद्ध परिणाम पर विचार करें। इस मामले में, आप बिना प्रतीक्षा किए परिणाम पढ़ना शुरू कर सकते हैं जब तक कि mysql सर्वर पूरी तरह से परिणाम प्राप्त नहीं कर लेता।

फायदे:

• आप परिणाम पहले पढ़ना शुरू कर सकते हैं, प्रतीक्षा समय कम हो गया है;
• परिणाम रैम में जगह नहीं लेता है।

नुकसान:

• यह जानना संभव नहीं है कि कितनी पंक्तियाँ प्राप्त की जाती हैं;
• एक विशिष्ट परिणाम पर जाना असंभव है, अर्थात, आप केवल शुरुआत से और क्रम में डेटा पढ़ सकते हैं;
• यह परिणाम बंद होने तक आप अन्य अनुरोधों को निष्पादित नहीं कर सकते।

बफ़र्ड परिणाम इन नुकसानों से रहित होता है और, तदनुसार, सूचीबद्ध लाभों से रहित होता है।

क्लासिक प्रश्न

MySqli ने "क्लासिक" प्रश्नों की संभावना को छोड़ दिया: जब उपयोगकर्ता स्वतंत्र रूप से प्रेषित प्रश्नों की सुरक्षा में संलग्न होने के लिए आमंत्रित किया जाता है, जैसा कि विरासत MySQL एक्सटेंशन के साथ था। ऐसा करने के लिए, फ़ंक्शन $ mysqli-> real_escape_string () का उपयोग करने का प्रस्ताव है, जिसके साथ सभी डेटा को क्वेरी में रखने से पहले संसाधित करना आवश्यक है।

कनेक्शन के साथ, इस तरह के अनुरोध को छोटा और लंबा करने के दो तरीके हैं।

लघु।

$ परिणाम = $ mysqli -> क्वेरी ( 'क्वेरी पाठ' , MYSQLI_USE_RESULT ) ;

संभावित स्थिरांक:
MYSQLI_STORE_RESULT - एक बफ़र्ड परिणाम, डिफ़ॉल्ट मान लौटाएगा
MYSQLI_USE_RESULT - असंबद्ध

लांग।

$ mysqli -> real_query ( 'क्वेरी पाठ' ) ;
गूंज ( $ mysqli -> field_count ) ; // कॉलम की संख्या लौटाएगा, परिणामस्वरूप,
// परिणाम प्राप्त होने से पहले प्राप्त किया जा सकता है, जो अतिरिक्त लचीलापन देता है
// छोटी विधि की तुलना में, निश्चित रूप से, कॉल करने के लिए आवश्यक नहीं है
$ परिणाम = $ mysqli -> use_result ( ) ; // असंबद्ध परिणाम लौटाएगा
// या
$ परिणाम = $ mysqli -> store_result ( ) ; // एक बफर परिणाम लौटाएगा

कार्य $ mysqli-> use_result () या $ mysqli-> store_result () का उपयोग बहु-प्रश्नों (कई प्रश्नों से युक्त प्रश्न) के लिए भी किया जाता है। इस लेख में कई अनुरोधों पर विचार नहीं किया जाएगा।

ये दोनों वाक्यविन्यास परिणाम को एक mysqli_result ऑब्जेक्ट के रूप में लौटाएंगे, जो परिणाम के साथ काम करने के लिए एक सुविधाजनक इंटरफ़ेस है, दोनों बफर और गैर-बफर।

जैसा कि मैंने ऊपर लिखा है, सभी MySQLi फ़ंक्शन PHP त्रुटियों को नहीं फेंकते हैं, उनमें से ऊपर वर्णित फ़ंक्शन। यदि अनुरोध गलत है और सर्वर ने कोई त्रुटि दी है, तो PHP आपको जानकारी नहीं देगा। कार्यों की जांच करने के लिए:

• $ mysqli-> त्रुटि - त्रुटि विवरण
• $ mysqli-> इरनो - त्रुटि कोड

$ शहर = $ mysqli -> real_escape_string ( $ शहर ) ;
$ mysqli -> query ( "Select * FROM` city` WHERE` id` = ' $ city ' " ) ;
अगर ( $ mysqli -> इरनो ) {
die ( 'सिलेक्ट एरर (' । $ mysqli -> इरनो । ')' $ mysqli -> एरर ) ;
}

"क्लासिक" क्वेरी सिंटैक्स के लाभ:

1. यह तैयार अभिव्यक्तियों ( mysqli_stmt वर्ग) की तुलना में बहुत अधिक कॉम्पैक्ट है;
2. यह आपको mysqli_result के रूप में एक अप्रतिबंधित परिणाम प्राप्त करने की अनुमति देता है। तैयार अभिव्यक्तियाँ आपको केवल बफ़र किए गए mysqli_result परिणाम प्राप्त करने की अनुमति देती हैं, और आपको अनब्लॉक किए गए mysqli_stmt टूल के साथ काम करना होगा, जो कि mysqli_result की तुलना में बहुत कम लचीला है।

"क्लासिक" क्वेरी सिंटैक्स का व्यावहारिक अनुप्रयोग जो मैं देखता हूं:

1. गैर-बफर प्रश्नों में, यदि आप mysqli_result के साथ काम करना चाहते हैं;
2. यदि आप उनके छोटे वाक्यविन्यास को पसंद करते हैं तो INSERT, UPDATE, REPLACE, या DELETE प्रश्नों में।

ऐसे प्रश्नों के लिए, निम्नलिखित गुण उपयोगी होंगे:

• $ mysqli-> प्रभावित_रो - पिछली गैर-चयन क्वेरी से प्रभावित पंक्तियों की संख्या
• $ mysqli-> insert_id अंतिम सम्मिलित अनुरोध के लिए स्वचालित रूप से जनरेट की गई आईडी है

अनुरोध तैयार किया

"क्लासिक" पर तैयार प्रश्नों के लाभ:

• अनुरोधों की एक श्रृंखला में जिसमें केवल डेटा बदला जाता है, अनुरोध केवल एक बार सर्वर को प्रेषित होता है, भविष्य में केवल बदलते डेटा भेजा जाता है;
• SQL इंजेक्शन के खिलाफ संरक्षण।

MySQLi में तैयार प्रश्नों के साथ काम करने के लिए mysqli_stmt वर्ग जिम्मेदार है।

तैयार क्वेरी बनाने के दो तरीके।

// पहला तरीका - mysqli ऑब्जेक्ट का उपयोग करना
$ mysqli -> तैयार ( "SELECT * FROM` sk2_articles` WHERE` id` =? " ) ;
अगर ( $ mysqli -> इरनो ) {
die ( 'सिलेक्ट एरर (' । $ mysqli -> इरनो । ')' $ mysqli -> एरर ) ;
}

// दूसरा तरीका - mysqli_stmt ऑब्जेक्ट का उपयोग करना
$ stmt = $ mysqli -> stmt_init ( ) ;
$ stmt -> तैयार ( "SELECT * FROM` sk2_articles` WHERE` id` "" )) ;
अगर ( $ stmt -> इरनो ) {
die ( ' सलेक्शन एरर (' । $ stmt -> इरनो । ')' $ stmt -> एरर ) ;
}

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

$ id_min = 81 ;
$ id_max = 88 ;
$ stmt = $ mysqli -> stmt_init ( ) ;
अगर (
// अनुरोध तैयार करें, डेटा कहां डाला जाएगा, इसे एक प्रतीक के साथ चिह्नित करें? (Pleyskholdory)
( $ stmt -> तैयार ( "sk2_articles से सेलेक्ट टाइटल FERE is id>? और id <?" ) === FALSE )
// प्लेसहोल्डर्स के लिए चर बाँध
या ( $ stmt -> bind_param ( 'ii' , $ id_min , $ id_max ) === FALSE )
// वह डेटा भेजें जो वर्तमान में बाध्य चर में है
या ( $ stmt -> निष्पादित ( ) === FALSE )
// परिणाम प्राप्त करने के लिए चर को बांधें
या ( $ stmt -> bind_result ( $ शीर्षक ) === FALSE )
// अनुरोध बफ़र करें,
// यदि यह रेखा नहीं है, तो अनुरोध अप्रभावित रहेगा
या ( $ stmt -> store_result ( ) === FALSE )
// एक बाध्य चर में परिणाम प्राप्त करें
या ( $ stmt -> fetch ( ) === FALSE )
// तैयार अनुरोध को बंद करें
या ( $ stmt -> पास ) ( = = FALSE )
) {
die ( ' सलेक्शन एरर (' । $ stmt -> इरनो । ')' $ stmt -> एरर ) ;
}
गूंज $ शीर्षक ;

ऊपर लिखे कोड के लिए कुछ स्पष्टीकरण।

1. $ Stmt-> bind_param () में, पहला पैरामीटर बाइंड करने के लिए डेटा का प्रकार है (i - पूर्णांक, डी - डबल, एस - स्ट्रिंग)। दूसरा और अगला वे चर हैं जो वर्णों के साथ $ stmt-> तैयार () में घोषित संबंधित प्लेसहोल्डर्स के लिए बाध्य होंगे? "" क्रम में वे $ stmt-> तैयार () में सूचीबद्ध हैं। यह पीडीओ से एक ध्यान देने योग्य अंतर है, जहां प्लेशॉल्डरी का नाम दिया जा सकता है, और इसलिए घोषणा के आदेश पर निर्भर नहीं करता है।
2. $ stmt-> bind_result, मेरी राय में, mysqli_stmt वर्ग में सबसे कमजोर बिंदु है, क्योंकि इसके लिए आपको यह जानना होगा कि अनुरोध से कौन सा डेटा प्राप्त होगा और यह किस क्रम में अनुरोध में घोषित किया गया है। "से चयन करें * ..." के मामले के लिए यह शायद ही लागू हो। Mysqli_result वर्ग परिणाम के साथ काम करने के लिए अधिक लचीला दृष्टिकोण प्रदान करता है। पूरी तरह से वस्तुनिष्ठ होने के लिए, यह ध्यान देने योग्य है कि आप डेटा के बिना केवल मेटाडेटा युक्त mysqli_result प्राप्त करने के लिए $ stmt-> result_metadata () फ़ंक्शन का उपयोग कर सकते हैं, और देख सकते हैं कि क्या कॉलम प्राप्त हुए हैं, लेकिन यह दृष्टिकोण मुझे अनावश्यक रूप से जटिल लगता है, और मैंने केवल इसका उल्लेख किया है गलत जानकारी के आरोपों से बचने के लिए।
3. $ stmt-> store_result () , जैसा कि मैंने लाइन पर टिप्पणी में लिखा है, वैकल्पिक है और इस तरह के कार्यों का उपयोग करने के लिए आवश्यक है:
   
   • $ mysqli_stmt-> num_rows - परिणाम के लिए प्राप्त लाइनों की संख्या,
   • $ stmt-> data_seek - आंतरिक पॉइंटर को निर्दिष्ट परिणाम स्ट्रिंग में ले जाएँ,
   • $ stmt-> free_result () - और अगर आप $ stmt-> store_result () का उपयोग करते हैं तो मुफ्त मेमोरी को कॉल करना न भूलें।
   
   
4. $ stmt-> fetch () TRUE / FALSE लौटाता है यदि डेटा सफलतापूर्वक / असफल प्राप्त हुआ था, और अधिक डेटा नहीं होने पर NULL
5. यदि सभी ब्लॉक में संयुक्त कार्य नहीं किए गए हैं, तो इसे $ stmt-> त्रुटि के मामले में त्रुटि कहते हैं, कुछ PHP चेतावनी कहते हैं, लेकिन विफलता के मामले में सभी FALSE को वापस कर देते हैं, इसलिए यह निर्माण मुझे सफल लगता है। यदि आपको कई बार $ stmt-> execute () या $ stmt-> लाने () करने की आवश्यकता है, तो यह काम नहीं करेगा।
6. भले ही अनुरोध बफ़र किया गया हो या नहीं, निम्न गुण उपलब्ध हैं:
   
   • $ stmt-> field_count - परिणामस्वरूप कॉलम की संख्या,
   • $ stmt-> प्रभावित_रो - पिछले अनुरोध से प्रभावित पंक्तियों की संख्या एक चयन नहीं है,
   • $ stmt-> insert_id - पिछली प्रविष्टि की स्वचालित रूप से निर्मित आईडी।
   
   

कोड को बदलें ताकि हमें mysqli_result ऑब्जेक्ट के उदाहरण के रूप में परिणाम मिले।

$ id_min = 81 ;
$ id_max = 88 ;
$ stmt = $ mysqli -> stmt_init ( ) ;
अगर (
( $ stmt -> तैयार ( "sx2_links से शीर्षक का चयन करें कहां?> और आईडी <?" ) === FALSE )
या ( $ stmt -> bind_param ( 'ii' , $ id_min , $ id_max ) === FALSE )
या ( $ stmt -> निष्पादित ( ) === FALSE )
// mysqli_result के रूप में एक बफर परिणाम प्राप्त करें,
// अप्रभावित परिणाम प्राप्त नहीं किया जा सकता है, जिसके बारे में मैंने कमियों में लिखा था
या ( ( $ परिणाम = $ stmt -> get_result ( ) ) === FALSE )
या ( $ stmt -> पास ) ( = = FALSE )
) {
die ( ' सलेक्शन एरर (' । $ stmt -> इरनो । ')' $ stmt -> एरर ) ;
}
$ पंक्ति = $ परिणाम -> fetch_row ( ) ;
गूंज $ पंक्ति [ 0 ] ;

Mysqli_result वर्ग और इसका उपयोग करके परिणाम के साथ काम कर रहा है

जैसा कि ऊपर दिखाया गया है, आप mysqli_result ऑब्जेक्ट को mysqli वर्ग का उपयोग करके "क्लासिक" क्वेरी का उपयोग कर प्राप्त कर सकते हैं, फिर इसे या तो बफर किया जा सकता है या असंबद्ध किया जा सकता है, या mysqli_stmt वर्ग का उपयोग किया जा सकता है, फिर यह बफर हो गया है। इस वर्ग के कार्यों का कार्य इस बात पर निर्भर करता है कि आपको किस प्रकार का परिणाम प्राप्त होता है, इसलिए आपको यह समझने की आवश्यकता है कि यदि आपकी क्वेरी अप्रभावित है, तो आपके पास पूरा परिणाम नहीं है, और इसलिए आप यह नहीं जान सकते कि परिणाम कितनी पंक्तियाँ हैं, और आप इसे केवल क्रम में पढ़ सकते हैं, पंक्ति द्वारा पंक्ति।

इस वर्ग में कार्यों का सेट पुराने विस्तार से परिचित होगा:

• $ परिणाम-> fetch_row () - एक क्रमांकित सरणी के रूप में परिणाम की वर्तमान पंक्ति प्राप्त करता है,
• $ परिणाम-> fetch_assoc () - एक सहयोगी सरणी के रूप में,
• $ परिणाम-> fetch_array () - सरणी प्रकार एक स्थिरांक द्वारा निर्धारित किया जाता है,
  
  1. MYSQLI_ASSOC - सहयोगी,
  2. MYSQLI_NUM - गिने गए,
  3. MYSQLI_BOTH - दोनों,
  
  
• $ परिणाम-> fetch_object () - एक वस्तु के रूप में परिणाम स्ट्रिंग।

लगभग $ परिणाम-> fetch_object () मैं अलग से बात करना चाहूंगा। इस फ़ंक्शन के दो पैरामीटर हैं, दोनों वैकल्पिक:

• class_name - कक्षा का नाम जिसके आधार पर ऑब्जेक्ट बनाया जाएगा,
• params - पैरामीटर का एक सरणी जो ऑब्जेक्ट बनाते समय कंस्ट्रक्टर को पास किया जाएगा।

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

कक्षा की किताब
{
निजी $ some1 ;
सार्वजनिक $ some2 ;
संरक्षित $ आईडी ;

फ़ंक्शन __construct ( $ param1 , $ param2 ) {
$ यह -> some1 = $ param1 ;
$ यह -> some2 = $ param2 ;
}
}
$ पुस्तक = $ परिणाम -> fetch_object ( 'पुस्तक' , सरणी ( 1 , 2 ) ) ;
var_dump ( $ पुस्तक ) ;

प्रिंट करें यदि केवल एक आईडी फ़ील्ड थी

ऑब्जेक्ट ( पुस्तक ) [ 4 ]
निजी 'some1' => int 1
सार्वजनिक 'some2' => int 2
संरक्षित 'आईडी' => इंट 382

इस वर्ग के अन्य उपयोगी कार्य और गुण:

• $ परिणाम-> fetch_all () - सभी पंक्तियों को क्रमांकित / साहचर्य / दोनों प्रकारों के एक सरणी के रूप में प्राप्त करना,
• $ परिणाम-> data_seek () - परिणामों की एक श्रृंखला के लिए आंतरिक पॉइंटर सेट करना,
• $ परिणाम-> num_rows - परिणाम में लाइनों की संख्या।

संदर्भ:
MySQLi पेज को php.net पर आधिकारिक दस्तावेज में
अधिक MySQLi उदाहरण
रूसी में MySQLi कार्यों की सूची