PHP एक्सटेंशन लिखना

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

Win32 के तहत संकलन

तो, चलो विंडोज के साथ शुरू करते हैं। जैसा कि आप जानते हैं , PHP डेवलपर्स विंडोज के तहत अपने दिमाग की उपज को संकलित करने के लिए विजुअल C ++ 9 या विजुअल स्टूडियो 2008 का उपयोग करते हैं। इसलिए, हम विज़ुअल स्टूडियो 2008 का उपयोग करेंगे, एक मुफ्त एक्सप्रेस संस्करण भी उपयुक्त है, साथ ही, हालांकि, शायद, बाद में और स्टूडियो के पुराने संस्करण।

हमें क्या चाहिए:

• संकलित PHP 5.3 बायनेरिज़, जिसे यहाँ लिया जा सकता है ,
• PHP 5.3 स्रोत जिन्हें साइट से डाउनलोड किया जा सकता है या सार्वजनिक SVN से खींचा जा सकता है,
• प्रयोग करने की इच्छा और थोड़ा धैर्य।

सबसे पहले, Win32 कंसोल एप्लिकेशन प्रकार की एक परियोजना बनाएं और एप्लिकेशन प्रकार में एक DLL चुनें। अब हमें लिंकर के लिए सभी निर्भरता और रास्तों को कॉन्फ़िगर करना होगा:

• सॉल्यूशन एक्सप्लोरर में राइट-क्लिक करें और प्रॉपर्टीज> C / C ++> जनरल> एडिशनल इन्क्लूड डिटेल्स चुनें। यहां हम उन निर्देशिकाओं को जोड़ते हैं जिनमें अनपैक्ड स्रोत कोड और PHP हेडर फाइलें स्थित हैं। विशेष रूप से, आपको आवश्यकता होगी:
  

   php-5.3.6
   php-5.3.6 \ main
   php-5.3.6 \ TSRM
   php-5.3.6 \ Zend
  

  
  
• अब प्रीप्रोसेसर परिभाषाएं जोड़ें, जिन्हें प्लेटफॉर्म के सही विकल्प और मॉड्यूल के संकलन के लिए आवश्यक है। कॉन्फ़िगरेशन गुण> C / C ++> Preprocessor> Preprocessor परिभाषाएँ चुनें, और निम्नलिखित जोड़ें:
  

   PHP_WIN32
   ZEND_WIN32
   ZTS = 1
   ZEND_DEBUG = 0
  

  
  
• फिर हम लिंकर को इंगित करते हैं जहां आवश्यक पुस्तकालयों को ढूंढना है। कॉन्फ़िगरेशन गुण> लिंकर> सामान्य> अतिरिक्त लाइब्रेरी निर्देशिकाएँ चुनें। वहां हम PHP बायनेरिज़ से \ div डायरेक्टरी चुनते हैं। आपको कुछ इस तरह मिलना चाहिए: "D: \ Program Files \ php-5.3.6-Win32-VC9-x86 \ dev"।
  
  
• अब हम लिंकर के लिए एक विशिष्ट लिंक का संकेत देते हैं। हम कॉन्फ़िगरेशन गुण> लिंकर> इनपुट> अतिरिक्त निर्भरता पर जाते हैं, और वहां php5ts.lib दर्ज करते हैं, जो उसी \ देव निर्देशिका में स्थित है जिसे हमने पिछले चरण में निर्दिष्ट किया था।
  
  
• कुछ संकलन समस्याओं से बचने के लिए, कॉन्फ़िगरेशन गुणों> लिंकर> कमांड लाइन में / FORCE: MULTIPLE निर्देश जोड़ें। आप इसके बारे में MSDN वेबसाइट पर अधिक पढ़ सकते हैं।
  
  
• और अंत में, आप यह निर्दिष्ट कर सकते हैं कि संकलित dll को कहाँ सहेजना है। ऐसा करने के लिए, कॉन्फ़िगरेशन गुण> लिंकर> सामान्य> आउटपुट फ़ाइलनाम पर जाएं और वहां स्थापित PHP के \ ext फ़ोल्डर में पथ को इंगित करें। आपको कुछ इस तरह से मिलना चाहिए: "D: \ Program Files \ php-5.3.6-Win32-VC9-x86 \ ext \ $ (ProjectName) .dll"।

प्रोजेक्ट में stdafx.h फ़ाइल खोजें और उसकी सामग्री को निम्न के साथ बदलें:

#ifndef STDAFX #define STDAFX #define PHP_COMPILER_ID "VC9" //        PHP,  Visual C++ 9.0 #include "zend_config.w32.h" #include "php.h" #endif 

यदि आप इस स्तर पर परियोजना को संकलित करने का प्रयास करते हैं, तो आपको यह कहते हुए एक त्रुटि मिलेगी कि main \ config.w32.h गायब है। आप इसे मुख्य \ config.bat स्क्रिप्ट चलाकर प्राप्त कर सकते हैं, या आप इसे स्रोतों से खींच सकते हैं, उदाहरण के लिए, PHP संस्करण 5.2। इस स्थिति में, इस फ़ाइल के सभी पथों को संपादित करना न भूलें और "#define HAVE_SOCKLEN_T" निर्देश को अनलाइक करें। अब परियोजना को त्रुटियों के बिना संकलन करना चाहिए।

अब हैलो दुनिया लिखते हैं, हमारी cpp फ़ाइल में निम्नलिखित जोड़ें:

 PHP_FUNCTION(test); const zend_function_entry test_functions[] = { PHP_FE(test, NULL) {NULL, NULL, NULL} }; zend_module_entry test_module_entry = { STANDARD_MODULE_HEADER, // #if ZEND_MODULE_API_NO >= 20010901 "test", //   test_functions, //    NULL, // PHP_MINIT(test), Module Initialization NULL, // PHP_MSHUTDOWN(test), Module Shutdown NULL, // PHP_RINIT(test), Request Initialization NULL, // PHP_RSHUTDOWN(test), Request Shutdown NULL, // PHP_MINFO(test), Module Info ( phpinfo()) "0.1", //    STANDARD_MODULE_PROPERTIES }; ZEND_GET_MODULE(test) PHP_FUNCTION(test) { RETURN_STRING("hello habr", 1); //  PHP-,   ,         } 

अब इस मॉड्यूल को PHP में प्लग करें और कुछ इस तरह चलाने की कोशिश करें:

 php -r "test();" 

हमें "हेलो हब्र" का जवाब क्या मिलना चाहिए।

* निक्स के तहत संकलन

* निक्स में, सब कुछ हमेशा की तरह सरल हो गया। मैं डेबियन के उदाहरण पर दिखाऊंगा, मुझे लगता है कि अन्य प्रणालियों के तहत प्रक्रिया अलग नहीं होगी।
हमें आवश्यकता होगी:

• क्या PHP मशीन पर स्थापित है,
• PHP-dev स्थापित किया है। ऐसा करने के लिए, केवल एक कमांड चलाएँ:
  

   apt-get install php5-dev 

आइए हमारे विस्तार के लिए कहीं एक निर्देशिका बनाएं। खैर, उदाहरण के लिए / परीक्षण। वहाँ हम दो खाली फाइल बनाते हैं:

 config.m4
 test.c

पहले विस्तार को जादुई रूप से संकलित करने की आवश्यकता है, और दूसरा इसका स्रोत कोड होगा। Config.m4 में, निम्नलिखित लिखें:

 PHP_ARG_ENABLE(test, Enable test support) if test "$PHP_TEST" = "yes"; then AC_DEFINE(HAVE_TEST, 1, [You have test extension]) PHP_NEW_EXTENSION(test, test.c, $ext_shared) fi 

अंदर Test.c add

 #include "php.h" 

और इस समय सीमा के बाद, विंडोज संस्करण से सीपीपी फ़ाइल की सामग्री की प्रतिलिपि बनाएँ।
अब कंसोल पर जाएं और:

 # phpize //        # ./configure //  makefile # make //  # make install //  .so    PHP  

वह सब है। अब आप php.ini खोल सकते हैं, वहां अपना एक्सटेंशन जोड़ें:

 extension = test.so

और इसकी प्रदर्शन टीम की जाँच करें

 php -r "test();" 

तर्क प्रसंस्करण और वापसी मान

पहले, आइए देखें कि आप तर्क कैसे ले सकते हैं:

 char* text; int text_length; if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &text, &text_lenght) == FAILURE) { return; } 

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

आप सरल और जटिल दोनों प्रकारों को वापस कर सकते हैं। आइए लौटे हुए सरणी के गठन से परिचित हों। यह दर्शाने के लिए कि एक सरणी वापस आ जाएगी, इसे आरंभीकृत किया जाना चाहिए:

 array_init(result); 

सरणी में मान जोड़ने के लिए, आपको उन फ़ंक्शन का उपयोग करना होगा जो निर्भर करते हैं कि किस इंडेक्स और मान को सरणी में जोड़ा जाता है। उदाहरण के लिए:

 add_next_index_long(result, 42); // $result[] = 42; add_assoc_bool(result, "foo", 1); // $result['foo'] = true; add_next_index_null(result); // $result[] = NULL; 

सुविधाओं की एक पूरी सूची यहां पाई जा सकती है।

अगर किसी को दिलचस्पी है, तो अगले लेख में मैं वस्तुओं के साथ काम करने के एक उदाहरण पर विचार कर सकता हूं (वस्तुओं पर विस्तार का क्लासिक उदाहरण myslili है)। इस विषय पर एक बहुत अच्छा लेख है।

उत्पादकता

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

मुझे इस तरह का कार्यान्वयन मिला, कोड के लिए ज्यादा किक न करें, मैं अभी भी सी की तुलना में PHP में अधिक लिखता हूं:

 PHP_FUNCTION(calculate_chars) { char* text; int text_length; if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &text, &text_length) == FAILURE) { return; } array_init(return_array); int table[256] = { 0 }; for (int i = 0; i < text_length; i++) { table[((unsigned char*)text)[i]]++; } char str[2]; str[1] = '\0'; for (int i = 0; i < 256; i++) { if (table[i]) { str[0] = (char)i; add_assoc_long(return_array, str, table[i]); } } } 

यह कोड निम्नलिखित परिणाम उत्पन्न करता है:

 user> php -r "print_r( calculate_chars('example') );" Array ( [a] => 1 [e] => 2 [l] => 1 [m] => 1 [p] => 1 [x] => 1 } 

अब इस कोड की निष्पादन गति की तुलना करें और देशी PHP में समान करें:

 $map = array(); for ($i = 0; $i < $length; $i++) { $char = $text[$i]; if (isset($map[$char])) { $map[$char]++; } else { $map[$char] = 1; } } 

मैं माइक्रोटाइम फ़ंक्शन का उपयोग करके दोनों समाधानों के निष्पादन समय की तुलना करूंगा । 100 वर्णों की एक स्ट्रिंग लें, 5000 वर्णों की एक स्ट्रिंग और 69,000 वर्णों की एक स्ट्रिंग (मैंने चार्ल्स डिकेंस द्वारा लिखी गई पुस्तक A Message from the Sea, मुझे आशा है कि वह मुझे माफ कर देगा), और प्रत्येक विकल्प के लिए मैं दोनों समाधानों को कई हजार बार चलाऊंगा। । परिणाम नीचे दी गई तालिका में दिखाए गए हैं। मेरे डेबिन के साथ बोर्ड पर डेब्यू के साथ मेरे नॉन-पावरफुल होम लैपटॉप और वीडीएस पर परीक्षण किया गया था, और हां, मैं स्पष्ट रूप से समझता हूं कि परिणाम कॉन्फ़िगरेशन पर निर्भर कर सकते हैं, ऑपरेटिंग सिस्टम, पीएचपी, वायुमंडलीय दबाव और हवा की दिशा के संस्करण पर, लेकिन केवल अनुमानित आंकड़े दिखाना चाहते थे। ।
टेस्ट स्क्रिप्ट का पूरा कोड यहां डाउनलोड किया जा सकता है । एक्सटेंशन के स्रोत और बायनेरिज़ खुद यहां (जीत) और यहां (निक्स) डाउनलोड किए जा सकते हैं।

	पुनरावृत्तियों की संख्या	PHP कोड / Win32	PHP कोड / डेबियन	PHP एक्सटेंशन / Win32	PHP विस्तार / डेबियन	जीत 32 की जीत	डेबियन जीत
1. 100 वर्णों की एक स्ट्रिंग	1000000	84.7566 सेकंड	72.5617 सेकंड	8.4750 सेकंड	4.4175 सेकेंड	10 बार	16.43 बार
2. लाइन 5000 वर्ण	10000	39.1012 सेक	31.7541 सेकंड	0.5001 सेकंड	0.134 सेकंड	78.19 बार	236.98 बार
3. 69,000 वर्णों की एक स्ट्रिंग	1000	52.3378 सेकंड	44.0647 सेकंड	0.4875 सेकंड	0.0763 सेकंड	१०.3.३६ बार	577.51 बार

निष्कर्ष

व्याख्या किए गए कोड की तुलना में मॉड्यूल के प्रदर्शन को देखते हुए, हम देखते हैं कि डेटा की बड़ी मात्रा और पुनरावृत्तियों की छोटी मात्रा पर मूर्त परिणाम प्राप्त किए जा सकते हैं। हालांकि, अक्सर उपयोग के लिए, हालांकि, बहुत संसाधन-गहन एल्गोरिदम नहीं हैं, यह उन्हें संकलित कोड में डालने का कोई मतलब नहीं है। लेकिन बड़ी मात्रा में डेटा के साथ काम करने वाले एल्गोरिदम के लिए, यह व्यावहारिक समझ बना सकता है। इसके अलावा, मेरे माप के आधार पर, आप देख सकते हैं कि PHP कोड के परिणाम विभिन्न प्रणालियों पर तुलनीय हैं (मुझे याद है कि वे दो अलग-अलग मशीनें थीं), लेकिन विस्तार के परिणाम बहुत अलग हैं। इससे, मैं व्यक्तिगत रूप से यह निष्कर्ष निकालता हूं कि कुछ संकलन विशेषताएं हैं जो मुझे ज्ञात नहीं हैं। हालांकि, मुझे दृढ़ता से संदेह है कि कोई भी PHP परियोजनाओं के लिए विंडोज सर्वर का उपयोग कर रहा है। हालाँकि मुझे यह भी बहुत संदेह है कि कोई अभी C में किसी चीज़ को फिर से लिखने के लिए दौड़ेगा, यह लेख अभी भी कार्रवाई के लिए मार्गदर्शक की तुलना में मज़ेदार है। मैं बस यह दिखाना चाहता था कि PHP का विस्तार लिखना बहुत सरल है, और कभी-कभी यह बहुत उपयोगी हो सकता है।

UPD1। Count_chars के साथ तुलना
टिप्पणियों में एक दिलचस्प सवाल पूछा गया: क्या होगा यदि हम count_chars फ़ंक्शन के प्रदर्शन के साथ तुलना करते हैं?
मैंने पुनरावृत्तियों की संख्या को सौ गुना बढ़ा दिया, और उसी परीक्षण को चलाया, लेकिन पहले से ही इस फ़ंक्शन का उपयोग कर रहा था। आप देख सकते हैं कि डेबियन पर परिणाम लगभग बराबर हैं, और विंडोज के तहत एक दिलचस्प स्थिति है: जितना अधिक डेटा, उतना ही अधिक मेरा मॉड्यूल प्रदर्शन में विलीन हो जाता है। आपको याद दिला दूं कि परीक्षण का विचार साइकिल लिखना नहीं था, बल्कि बड़ी मात्रा में डेटा के साथ काम करने के लिए एक एल्गोरिथ्म लेना था।

	पुनरावृत्तियों की संख्या	count_chars / win32	count_chars / डेबियन	विस्तार / win32	विस्तार / डेबियन	जीत 32 की जीत	डेबियन जीत
1. 100 वर्णों की एक स्ट्रिंग	10000000	67.5245 सेकंड	47.8104 सेकंड	81.8185 सेकंड	43.8091 सेकेंड	0.83 बार	1.09 बार
2. लाइन 5000 वर्ण	1000000	22.4693 सेकेंड	12.8959 सेकेंड	47.2514 सेकंड	12.9577 सेकंड	0.48 बार	0.99 गुना
3. 69,000 वर्णों की एक स्ट्रिंग	100000	15.0681 सेकंड	7.661 सेकंड	46.9598 सेक	7.7387 सेकंड	0.32 बार	0.99 गुना

सामग्री

• कोर पर PHP: Zend इंजन के लिए एक हैकर गाइड, php.net
• साझा किए गए PECL एक्सटेंशन को phpize, php.net के साथ संकलित करें
• Microsoft Visual C ++ 2008, talkphp.com का उपयोग करके विंडोज के लिए एक PHP एक्सटेंशन बनाना
• विस्तार लेखन भाग I: PHP और Zend का परिचय, devzone.zend.com
• विस्तार लेखन भाग II: पैरामीटर, एरेस और ZVALs, devzone.zend.com
• PHP एक्सटेंशन में c ++ क्लासेस को रैप करना , devzone.zend.com