PHP7 में एक्सटेंशन को "हैलो, दुनिया" से अधिक कठिन कैसे बनाया जाए, और लाल-आंखों वाला बनने के लिए नहीं। भाग 1

क्यों?

सॉफ्टवेयर स्थापना

पीएचपी

1. पहले हमने php7.2-dev पैकेज रखा, इसमें एक्सटेंशन बनाने के लिए आवश्यक phpize स्क्रिप्ट। इसके अलावा, हमें php के एक कार्यशील संस्करण की आवश्यकता होगी, जिस पर हम अपने विस्तार की जांच करेंगे। इस पैकेज को स्थापित करने से कई आश्रित पैकेज तैयार हो जाएंगे, हम सब कुछ पेश करते हैं।
   
   

   sudo apt install php7.2-dev 

   
   
2. हम php.net वेबसाइट पर जाते हैं, डाउनलोड अनुभाग पर जाते हैं और आर्क के नवीनतम स्थिर संस्करण के साथ संग्रह के लिए एक लिंक निकालते हैं, अब यह संस्करण 7.2.11 है।
   Php स्रोत संग्रह डाउनलोड करें:
   
   

    cd /tmp && wget http://it2.php.net/get/php-7.2.11.tar.gz/from/this/mirror -O php7.tar.gz 

   
   
3. अब संग्रह को स्वयं के लिए अनपैक करें:
   
   

    sudo tar -xvf php7.tar.gz -C /usr/local/src 

   
   

कोड संपादक

 sudo apt install geany 

 cd ~/Downloads && wget https://download.jetbrains.com/cpp/CLion-2018.2.5.tar.gz -O clion.tar.gz 

 sudo tar -xvf clion.tar.gz -C /usr/share 

 sudo ln -s /usr/share/clion-2018.2.5/bin/clion.sh /usr/bin/clion 

 # clion 

एक्सटेंशन बनाएं

1. हमारे द्वारा डाउनलोड किए गए php स्रोतों से कच्चे मानक डिस्क लें।
2. एक विशेष ext_skel स्क्रिप्ट के साथ मानक डिस्क को थोड़ा सा देखा
3. यहाँ से एक अच्छा न्यूनतम डिस्क प्राप्त करें ।

1. चलो मानक php एक्सटेंशन के साथ निर्देशिका पर जाएं।
   
   

    cd /usr/local/src/php-7.2.11/ext 

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

    sudo bash 

   
   
2. यहां मैं केवल 1 फ़ंक्शन के पैरामीटर सेट करूंगा जिसे बनाया गया एक्सटेंशन लागू करेगा। यह केवल एक डेमो फ़ंक्शन है यह दिखाने के लिए कि यह कैसे किया जाता है।
   
   हम मानक फ़ंक्शन का एक पूर्ण एनालॉग करेंगे
   
   

    array array_fill ( int $start_index , int $num , mixed $value ) 

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

    echo my_array_fill \( int start_index , int num , mixed value \) >> libtrie.proto 

   
   
3. अब ext_skel स्क्रिप्ट चलाएं, इसे एक्सटेंशन और हमारे द्वारा बनाई गई प्रोटो फाइल का नाम दें।
   
   

    ./ext_skel --extname=libtrie --proto=./libtrie.proto 

   
   
4. हमने अपने एक्सटेंशन के साथ एक निर्देशिका बनाई है। चलो इसमें चलते हैं।
   
   

    cd libtrie 

   
   

फ़ाइल संरचना और विधानसभा सिद्धांत

 config.m4 -           phpize   ./configure,       makefile. CREDITS -  ,     ,    libtrie.c -      php_libtrie.h -     config.w32 -        windows EXPERIMENTAL -  .    ,    . libtrie.php -  php      . tests -   

 config.m4 php_libtrie.h libtrie.c 

 mv libtrie.c php_libtrie.c 

Config.m4 संपादन

 geany config.m4 & 

 PHP_ARG_ENABLE(libtrie, whether to enable libtrie support, [ --enable-libtrie Enable libtrie support]) if test "$PHP_LIBTRIE" != "no"; then #    -    # PHP_ADD_INCLUDE() #   PHP_NEW_EXTENSION(libtrie, php_libtrie.c, $ext_shared) # PHP_NEW_EXTENSION(libtrie, php_libtrie.c, $ext_shared,, -DZEND_ENABLE_STATIC_TSRMLS_CACHE=1) fi 

 #    exit 

 cp /usr/local/src/php-7.2.11/ext/libtrie ~/Documents/ -r 

डेमो फ़ंक्शन

 sudo apt install cmake 

Cmake कॉन्फ़िगर करें

 cmake_minimum_required(VERSION 3.12) project(php-ext-libtrie C) set(CMAKE_C_STANDARD 11) #   phproot,       php set(phproot /usr/local/src/php-7.2.11/) #   ,      #      clion       php include_directories(${phproot}) include_directories(${phproot}TSRM/) include_directories(${phproot}main/) include_directories(${phproot}Zend/) #    clion          add_executable(php-ext-libtrie php_libtrie.c) 

डेमो फंक्शन कोड

 #include "php_libtrie.h" 

 #ifndef PHP_LIBTRIE_H #define PHP_LIBTRIE_H #ifdef HAVE_CONFIG_H #include "config.h" #endif #include <stdarg.h> //   va_start() #include <inttypes.h> //    //  #if defined(__GNUC__) && __GNUC__ >= 4 # define ZEND_API __attribute__ ((visibility("default"))) # define ZEND_DLEXPORT __attribute__ ((visibility("default"))) #else # define ZEND_API # define ZEND_DLEXPORT #endif # define SIZEOF_SIZE_T 8 //   ZVAL_COPY_VALUE() #ifndef ZEND_DEBUG #define ZEND_DEBUG 0 #endif //  ,      #include "php.h" #include "php_ini.h" #include "zend.h" #include "zend_types.h" //ZVAL_COPY_VALUE #include "ext/standard/info.h" #include "zend_API.h" #include "zend_modules.h" #include "zend_string.h" #include "spprintf.h" extern zend_module_entry libtrie_module_entry; ... 

एक छोटा सैद्धांतिक विषयांतर

1. आपको विशेष संरचना zend_module_entry को प्रारंभ करने की आवश्यकता है, जिसमें निम्नलिखित शामिल हैं:
   
   

    zend_module_entry libtrie_module_entry = { STANDARD_MODULE_HEADER, //  "libtrie", //  libtrie_functions, //     PHP_MINIT(libtrie), //,     PHP_MSHUTDOWN(libtrie), //   PHP_RINIT(libtrie), /* Replace with NULL if there's nothing to do at request start */ PHP_RSHUTDOWN(libtrie), /* Replace with NULL if there's nothing to do at request end */ PHP_MINFO(libtrie), // ,    php  phpinfo() PHP_LIBTRIE_VERSION, // ,     STANDARD_MODULE_PROPERTIES //    }; 

   
   
2. उसी सरणी को आरम्भ करें जिसमें हमारे एक्सटेंशन के सभी कार्य शामिल हों।
   
   यहां, एक विशेष मैक्रो रैपर PHP_FE () के माध्यम से, हमारे एक्सटेंशन में सभी फ़ंक्शन के नाम सेट किए गए हैं। सामान्य तौर पर, मैक्रोज़ को पीएचपी में बहुत सक्रिय रूप से उपयोग किया जाता है, बहुत सारे मैक्रोज़ होते हैं जो बस अन्य मैक्रोज़ को संदर्भित करते हैं, और जो बदले में आगे होते हैं। आपको इसकी आदत डालनी होगी। यदि आप मैक्रो से ctrl + क्लिक के माध्यम से पता लगा सकते हैं। यहाँ क्लीयन अपरिहार्य है।
   
   प्रोटो फाइल याद है? हमने वहाँ 1 फ़ंक्शन my_array_fill () सेट किया है। तो अब हमारे यहाँ 3 तत्व हैं:
   
   

    const zend_function_entry libtrie_functions[] = { PHP_FE(confirm_libtrie_compiled, NULL) /* For testing, remove later. */ PHP_FE(my_array_fill, NULL) PHP_FE_END /* Must be the last line in libtrie_functions[] */ }; 

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

 PHP_FUNCTION(my_array_fill) 

 /usr/local/src/php-7.2.11/README.PARAMETER_PARSING_API 

 PHP_FUNCTION(my_array_fill) { //   ,     //    2 : // zend_execute_data *execute_data, zval *return_value //     ,      //zend_long  int64_t  x64   int32_t  x86  //      zend_long zend_long start_index; //1  , zend_long num; //2   zval *value; //   mixed ,   zval,      //    ,          if (zend_parse_parameters(ZEND_NUM_ARGS(), "llz", &start_index, &num, &value) == FAILURE) { /*     *    RETURN_    * return_value     */ RETURN_FALSE; } //   ,   -    if (num <= 0) { php_error_docref(NULL TSRMLS_CC, E_WARNING, "argument 2 must be > 0"); //     RETURN_FALSE; } //zval *return_value  ,        //       zval,     ,  -  //   zend_long  unsigned int32. //      + -. ..   1,    3,     4  array_init_size(return_value, (uint32_t)(start_index + num)); //  ,   ,   for(zend_long i = start_index, last = start_index + num; i < last; ++i) { //   zval       add_index_zval(return_value, i, value); } //   ,      return_value return; } 

एक्सटेंशन का निर्माण और परीक्षण करें

 phpize 

 ./configure 

 make 

 #    php,       # modules.  -a  php      php -d extension=modules/libtrie.so -a 

 print_r(my_array_fill(50, 2, "hello, baby!"));