एक्सटेंशन PHP और कोटलिन नेटिव। भाग एक, भोला

यह लेख कोटलिन मूल का उपयोग करके PHP विस्तार बनाने के लिए सबसे भोले और सबसे आसान दृष्टिकोण पर चर्चा करता है। मैं इस तथ्य पर आपका ध्यान आकर्षित करता हूं कि नहीं, लेकिन उपयोग के साथ ।

यह बल्कि समस्याओं का एक विवरण के साथ ट्यूटोरियल का एक प्रकार है जो एक हेजहोग के साथ एक हेजहॉग को पार करने और उन्हें हल करने के तरीकों से उत्पन्न हुआ। कोई रहस्योद्घाटन नहीं होगा, लेकिन शायद कोई काम आएगा।

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

लक्ष्य एक फ़ंक्शन `हैलो ($ नाम)` के साथ एक एक्सटेंशन लिखना है जो एक स्ट्रिंग लेता है और `हैलो, $ नाम` को प्रिंट करता है।

जैसा कि नाम कहता है, हम भोलेपन से फैसला करेंगे।

1. कोटलिन पर एक समारोह लिखते हैं
2. साझा लाइब्रेरी में संकलित करें
3. शास्त्रीय तरीके से (सी में), हम एक विस्तार लिखते हैं जो इस लाइब्रेरी में फ़ंक्शन कॉल को रीडायरेक्ट करेगा

यह सरल लगता है, लेकिन घने घास में पहले से ही एक लकीर पड़ी है:

1. कोटलिन में सी-लाइब्रेरी का उपयोग करने के कई उदाहरण हैं, लेकिन मुझे सी में कोटलिन लाइब्रेरी के कार्यों का उपयोग करने के लिए पर्याप्त कुछ भी नहीं मिला (ठीक है, शायद मैं बुरी तरह से देख रहा था, वास्तव में क्या है)
2. पहली बार शुरू होने पर कोटलिनक कंपाइलर निर्भरता को लोड करता है। लेकिन बुरी किस्मत कॉर्पोरेट बादल में मेरी लिनक्स आभासी मशीन है। बिना, यहां तक ​​कि सैद्धांतिक भी, इंटरनेट तक पहुंचने की क्षमता।
3. यह रेक C में अनुभव की कमी से अधिक होने की संभावना है, लेकिन मैं आपको बताऊंगा कि कैसे लिंकर ने मुझे विशेष रूप से ट्रोल किया।

Red Hat Enterprise Linux सर्वर रिलीज़ 7.5 पर सब कुछ हुआ।

चलो चलते हैं!

आरंभ करने के लिए, इंस्टॉल करें ... नहीं, कोटलिन संकलक नहीं। सबसे पहले, JDK स्थापित करें। अच्छी तरह से।
फिर कोटलिन कंपाइलर स्थापित करें। जीथब से संग्रह डाउनलोड करें और इसे अनज़िप करें, उदाहरण के लिए, होम निर्देशिका में।

एक आदर्श दुनिया में, पहली शुरुआत में, वह सभी निर्भरताओं को स्वयं डाउनलोड करता है, लेकिन, इंटरनेट की अनुपस्थिति में, हम इस प्रकार आगे बढ़ते हैं (जेटब्रेन कर्मचारियों से गुप्त ज्ञान प्राप्त होता है):

• हम किसी भी सरल कोटलिन स्क्रिप्ट का निर्माण करते हैं ताकि अगले चरण में संकलक पर हथेली से कुछ हो
• हम $ KOTLIN_HOME / bin / kotlinc SimpleScript.kt शुरू करते हैं, थोड़ा इंतजार करते हैं और CTRL + C दबाते हैं - यह घर निर्देशिका में एक फ़ोल्डर संरचना बनाने के लिए है
• हम अपने आर्किटेक्चर के साथ अनुभाग में फ़ाइल $ KOTLIN_HOME / konan / konan.properties को देखें, और आइटम देखें:
  
  

dependencies.linux_x64 = \ clang-llvm-5.0.0-linux-x86-64 \ target-gcc-toolchain-3-linux-x86-64 \ libffi-3.2.1-2-linux-x86-64 

• हम एक विशेष रिपॉजिटरी में जाते हैं और उपरोक्त सभी डाउनलोड करते हैं।
• हम यह सब ~ / .konan / cache में जोड़ते हैं (मैं आपको याद दिलाता हूं कि लिनक्स होम डायरेक्टरी एक टिल्ड है)

अब, पहली शुरुआत में, कंपाइलर इन वितरणों का उपयोग करेगा और इंटरनेट पर नहीं मिलेगा।

कृपया ध्यान दें कि निर्भरताएं आकार में बहुत छोटी नहीं हैं और, उन्हें स्थापित करने के बाद, मेरी घरेलू निर्देशिका 3.4 जीबी भारी हो गई है। उन लोगों के लिए जिनके होमवर्क के तहत एक अलग वॉल्यूम है, यह महत्वपूर्ण हो सकता है।

बाद में, मानक पैकेज प्रबंधक के साथ, php और संबंधित php-devel स्थापित करें।
इस पर, तैयारी के उपाय खत्म हो गए हैं।

चूंकि यह PHP एक्सटेंशन लिखने के बारे में बात करने लायक नहीं है, इसलिए हम सबसे कम संभव कोड के साथ मिलेंगे।

चलिए शुरू करते हैं कोटलिन से

hellokt.kt

 fun kt_print(string:String){ println("Hello, $string!!!") } 

विभिन्न मैनुअल और ट्यूटोरियल्स में, कोटलिनक या कोनैंक को कंपाइलर के रूप में उपयोग किया जाता है, जो कुछ हद तक भ्रामक है। तो - यह एक ही बात है। यहाँ सबूत है:


संकलन

 # $KOTLINC_HOME/kotlinc -opt ./hellokt.kt -o hellokt -produce dynamic 

-ऑप्ट स्विच के साथ, लाइब्रेरी छोटी है। -प्रोडक्टिव डायनामिक कंपाइलर को वर्तमान प्लेटफॉर्म के लिए एक साझा लाइब्रेरी करने के लिए कहता है।

निष्पादन के बाद, हमारे पास दो फाइलें होंगी: libhellokt.so और hellokt_api.h। इसके लिए लाइब्रेरी और हेडर फ़ाइल। कृपया ध्यान दें कि उपसर्ग और प्रत्यय स्वतः उत्पन्न होते हैं और हम उन्हें (शायद) प्रभावित नहीं कर सकते।

हमारे मामले में, हमें ऐसी हेडर फ़ाइल मिलती है।

 #ifndef KONAN_HELLOKT_H #define KONAN_HELLOKT_H #ifdef __cplusplus extern "C" { #endif #ifdef __cplusplus typedef bool hellokt_KBoolean; #else typedef _Bool hellokt_KBoolean; #endif typedef char hellokt_KByte; typedef unsigned short hellokt_KChar; typedef short hellokt_KShort; typedef int hellokt_KInt; typedef long long hellokt_KLong; typedef float hellokt_KFloat; typedef double hellokt_KDouble; typedef void* hellokt_KNativePtr; struct hellokt_KType; typedef struct hellokt_KType hellokt_KType; typedef struct { /* Service functions. */ void (*DisposeStablePointer)(hellokt_KNativePtr ptr); void (*DisposeString)(const char* string); hellokt_KBoolean (*IsInstance)(hellokt_KNativePtr ref, const hellokt_KType* type); /* User functions. */ struct { struct { void (*kt_print)(const char* string); } root; } kotlin; } hellokt_ExportedSymbols; extern hellokt_ExportedSymbols* hellokt_symbols(void); #ifdef __cplusplus } /* extern "C" */ #endif #endif /* KONAN_HELLOKT_H */ 

हमारे kt_print फ़ंक्शन की पहुंच इस तरह होगी।

 hellokt_symbols()->kotlin.root.kt_print(char *); 

मैं आपको नीचे कक्षाओं और पैकेजों के बारे में बताऊंगा - बारीकियाँ हैं।

पुस्तकालय तैयार है, सी पर जाएं

config.m4 ( इसे कैसे बनाएं )

 PHP_ARG_ENABLE(hello, whether to enable hello support,[ --enable-hello Enable hello support]) if test "$PHP_HELLO" != "no"; then PHP_ADD_LIBRARY_WITH_PATH(hellokt, /path/to/compiled/library, HELLO_SHARED_LIBADD) PHP_NEW_EXTENSION(hello, hello.c, $ext_shared) PHP_SUBST(HELLO_SHARED_LIBADD) fi 

पहली पंक्ति की आवश्यकता है!

ऊपर दिए गए उदाहरण config.m4 में देखी गई पहली बात, कुछ टिप्पणियों से अलग, PHP_ARG_WITH () और PHP_ARG_ENABLE () का उपयोग करके तीन पंक्तियाँ हैं।
...
प्रत्येक एक्सटेंशन को एक्सटेंशन नाम के साथ कम से कम एक या दूसरे को प्रदान करना चाहिए, ताकि उपयोगकर्ता PHP में एक्सटेंशन का निर्माण कर सकें या नहीं चुन सकें।

ध्यान दें कि PHP_ADD_LIBRARY_WITH_PATH में, पहला तर्क लाइब्रेरी का नाम है। लिबेल्हॉक नहीं, अर्थात् हेल्लोक्ट। मैंने दो घंटे तक मार डाला जब तक मुझे पता नहीं चल गया कि ld लाइब्रेरी क्यों नहीं ढूंढ सकता। (यहाँ वह लिंकर बदमाशी के बारे में वादा किया कहानी है)।

अब, वास्तव में, विस्तार कोड ही

hello.c

 #include "php.h" //    #include "hellokt_api.h" #define PHP_MY_EXTENSION_VERSION "1.0" #define PHP_MY_EXTENSION_EXTNAME "hello" PHP_FUNCTION(hello); static zend_function_entry hello_functions[] = { PHP_FE(hello, NULL) }; zend_module_entry hello_module_entry = { #if ZEND_MODULE_API_NO >= 20010901 STANDARD_MODULE_HEADER, #endif PHP_MY_EXTENSION_EXTNAME, hello_functions, NULL, NULL, NULL, NULL, NULL, #if ZEND_MODULE_API_NO >= 20010901 PHP_MY_EXTENSION_VERSION, #endif STANDARD_MODULE_PROPERTIES }; ZEND_GET_MODULE(hello) PHP_FUNCTION(hello) { char * name; size_t name_len; if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &name, &name_len) == FAILURE) { RETURN_NULL(); } hellokt_symbols()->kotlin.root.kt_print(name); //   efree(name); } 

PHP एक्सटेंशन लिखने के बारे में काफी कुछ लेख हैं, और प्रलेखन मौजूद है, इसलिए मैं खुद को zend_parse_parameters का उपयोग करने के लिए एक लिंक तक सीमित कर दूंगा - यह जगह में होगा।

ठीक है, तो सब कुछ लुढ़का हुआ है:

 # $PHP_PATH/phpize # ./configure --with-php-config=$PHP_PATH/php-config # make # $PHP_PATH/php -dextension=./modules/hello.so -r "echo hello('World');" Hello, World!!! 

बोनस, कक्षाओं और पैकेज के बारे में

मान लीजिए हम फेंग शुई करना चाहते थे और इस कोड को अंधा कर रहे थे।

 package hello.kt; public class HelloKt { fun kt_print(string: String) { println("Hello, $string!!!") } } 

यहां एक सामान्य विधि कॉल करने का कोई तरीका नहीं है - आपको पहले एक वर्ग बनाना होगा और इसे पहले फ़ंक्शन को कॉल करना होगा।

 hellokt_kref_hello_kt_HelloKt helloKt = { 0 }; if(!helloKt.pinned){ helloKt = hellokt_symbols()->kotlin.root.hello.kt.HelloKt.HelloKt(); } hellokt_symbols()->kotlin.root.hello.kt.HelloKt.kt_print(helloKt, name); 

आगे क्या है? साझा पुस्तकालय की अस्वीकृति, सी के उपयोग को कम करना और, क्या नरक मज़ाक नहीं कर रहा है, एक मिनी रूपरेखा - ऐसी चीजें। मुझे शुभकामनाएँ! :)