😈 🚗 🚓 एक्सटेंशन PHP और कोटलिन नेटिव। भाग तीन, शायद अंतिम 😑 🚅 👩🏽‍💻

पहले भाग में , उपकरण और सामान्य अवधारणाओं को स्थापित करने के बारे में काफी बुनियादी बातें बताई गई हैं।

दूसरा भाग के बारे में है, इसलिए बोलने के लिए, प्रोजेक्टाइल, विचारों, योजनाओं, योजनाओं के लिए पहला दृष्टिकोण।

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

अस्वीकरण: निम्नलिखित सभी को PHP के लिए एक पुस्तकालय लिखने के संदर्भ में माना जाता है।

अध्याय एक अंतर्यामी भोले

सी में के / एन कार्यों का उपयोग कैसे करें चक्र के पहले भाग में वर्णित है। तदनुसार, यहां मैं आपको बताऊंगा कि K / N में C फ़ंक्शन का उपयोग कैसे करें।

आधिकारिक दस्तावेज बल्कि कंजूस और संक्षिप्त है, हालांकि, सरल परियोजनाओं के लिए, यह काफी पर्याप्त है।

संक्षेप में, आपको एक्सटेंशन .def के साथ एक विशेष फ़ाइल बनाने और उसमें आवश्यक हेडर फ़ाइलों को निर्दिष्ट करने की आवश्यकता है।

headers = php.h

फिर इसे सिनेटरॉप नामक कार्यक्रम में खिलाएं ।

 # cinterop -def php.def -o php

आउटपुट में, आपको libvp.klib लाइब्रेरी मिलेगी जिसमें llvm बिटकोड और विभिन्न मेटा-जानकारी होगी।

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

 # kotlinc -opt -produce static ${SOURCES} -l libphp.klib -o myLib

लेकिन एक अति सूक्ष्म अंतर है। और एक नहीं।

ऊपर वर्णित रूप में, पुस्तकालय को इकट्ठा नहीं किया जाएगा

क्यों? लेकिन क्योंकि निम्नलिखित पंक्तियाँ php.h में मौजूद हैं:

 #include "php_version.h" #include "zend.h" #include "zend_sort.h" #include "php_compat.h" #include "zend_API.h"

यहां यह ध्यान दिया जाना चाहिए कि llvm अभी भी लाइब्रेरी को संकलित करने में लगा हुआ है, और इसमें -I स्विच है , और सिंटरटॉप में -copt स्विच है । खैर, आप बात करते हैं। नतीजतन, इस तरह की कमांड php.h को संकलित करने के लिए पर्याप्त है।

 # cinterop -def my.def -o myLib -I${PHP_LIB_ROOT} -copt -I${PHP_LIB_ROOT} \ -copt -I${PHP_LIB_ROOT}/main \ -copt -I${PHP_LIB_ROOT}/Zend \ -copt -I${PHP_LIB_ROOT}/TSRM

मैक्रो। मैं तुमसे प्यार करता हूँ और नफरत करता हूँ! नहीं, मुझे इससे नफ़रत है।

आपको C> K / N #define के संदर्भ में #define बारे में जानना होगा

प्रत्येक C मैक्रो जो किसी स्थिरांक तक फैलता है, को कोटलिन संपत्ति के रूप में दर्शाया जाता है। अन्य मैक्रोज़ समर्थित नहीं हैं।

और फिर हम याद करते हैं कि PHP एक्सटेंशन मैक्रो पर एक मैक्रो है और मैक्रो ड्राइव करता है और रोने की कोशिश नहीं करता है।

लेकिन सब कुछ इतना बुरा नहीं है। इस स्थिति के इर्द-गिर्द काम करने के लिए, K / N डेवलपर्स ने कस्टम घोषणाओं को फ़ाइल में संलग्न करने के लिए नीले बिजली के टेप का एक रोल प्रदान किया। यह इस तरह दिखता है (उदाहरण के लिए, मैक्रो Z_TYPE_P )

 headers = php.h --- static inline zend_uchar __zp_get_arg_type(zval *z_value) { return Z_TYPE_P(z_value); }

अब K / N कोड में __zp_get_arg_type फ़ंक्शन का उपयोग करना संभव होगा

अध्याय दो PHP INI- सेटिंग या एक सब-सब मैक्रो।

यह PHP के स्रोत कोड की ओर एक "अच्छी किरण" है।

सेटिंग्स निकालने के लिए 4 मैक्रो हैं:

 INI_INT(val) INI_FLT(val) INI_STR(val) INI_BOOL(val)

जहां val सेटिंग के नाम के साथ एक स्ट्रिंग है।

अब आइए INI_STR के उदाहरण को देखें कि यह मैक्रो कैसे परिभाषित होता है।

 #define INI_STR(name) zend_ini_string_ex((name), sizeof(name)-1, 0, NULL)

पहले से ही अपने "घातक दोष" पर ध्यान दिया?

यदि नहीं, तो मैं आपको बता दूं - यह sizeof समारोह है। जब आप सीधे मैक्रो का उपयोग करते हैं, तो सब कुछ ठीक है:

 php_printf("The value is : %s", INI_STR("my.ini"));

जब आप .def फ़ाइल से प्रॉक्सी फ़ंक्शन के माध्यम से इसका उपयोग करते हैं, तो गाड़ी कद्दू में बदल जाती है, और आकार (नाम) सूचक के आकार को वापस कर देता है। चेकमेट कोटलिन नेटिव।

वास्तव में, चक्कर लगाने के लिए केवल दो विकल्प हैं।

मैक्रो का उपयोग न करें, लेकिन वे कार्य जो वे संलग्न हैं।
हार्डकोड आवरण प्रत्येक आवश्यक सेटिंग के लिए कार्य करता है।

पहला विकल्प दूसरे की तुलना में सभी के लिए बेहतर है, एक बिंदु को छोड़कर - कोई भी गारंटी नहीं देगा कि मैक्रो घोषणा नहीं बदलेगी। इसलिए, मेरी परियोजना के लिए, मैंने, गहरी असंतोष की भावना के साथ, दूसरा विकल्प चुना।

अध्याय तीन डिबग? क्या डीबग?

एक्ट 1 - इंटरोप।

एक बिंदु पर, 20 लगातार प्रॉक्सी फ़ंक्शंस की फ़ाइल को ब्लू टेप संलग्न करने के बाद, मुझे एक अद्भुत त्रुटि मिली।

 Exception in thread "main" java.lang.Error: /tmp/tmp399964332777824085.c:103:38: error: too many arguments to function call, expected 2, have 3 at org.jetbrains.kotlin.native.interop.indexer.UtilsKt.ensureNoCompileErrors(Utils.kt:137) at org.jetbrains.kotlin.native.interop.indexer.IndexerKt.indexDeclarations(Indexer.kt:902) at org.jetbrains.kotlin.native.interop.indexer.IndexerKt.buildNativeIndexImpl(Indexer.kt:892) at org.jetbrains.kotlin.native.interop.indexer.NativeIndexKt.buildNativeIndex(NativeIndex.kt:56) at org.jetbrains.kotlin.native.interop.gen.jvm.MainKt.processCLib(main.kt:283) at org.jetbrains.kotlin.native.interop.gen.jvm.MainKt.interop(main.kt:38) at org.jetbrains.kotlin.cli.utilities.InteropCompilerKt.invokeInterop(InteropCompiler.kt:100) at org.jetbrains.kotlin.cli.utilities.MainKt.main(main.kt:29)

आधा पर टिप्पणी करें, फिर से संकलित करें, यदि बाकी के आधे हिस्से पर टिप्पणी दोहराई जाती है, तो हम एकत्र करते हैं ... और यह देखते हुए कि हेडर को संकलित करने की प्रक्रिया काफी लंबी है ... (हाँ, यह एक दर्जन स्रोत फ़ाइलों पर चढ़ने की तुलना में तेजी से लग रहा था और सावधानीपूर्वक आवर्धक ग्लास, सामंजस्य के साथ)।

दूसरा "रे की गुड" जेटब्रेन की ओर जाता है।

अधिनियम 2 - क्रम।

मुझे रनटाइम सेगमेंटेशन में खराबी है । अच्छा ठीक है, ऐसा होता है। मैं डिबगर में चढ़ रहा हूं। उम्म्म ... एसटीए?

 Program received signal SIGSEGV, Segmentation fault. kfun:kotlinx.cinterop.toKString@kotlinx.cinterop.CPointer<kotlinx.cinterop.ByteVarOf<kotlin.Byte>>.()kotlin.String () at /opt/buildAgent/work/4d622a065c544371/Interop/Runtime/src/main/kotlin/kotlinx/cinterop/Utils.kt:402 402 /opt/buildAgent/work/4d622a065c544371/Interop/Runtime/src/main/kotlin/kotlinx/cinterop/Utils.kt: No such file or directory.

अध्याय चार मैंने आपकी चाय में चाय डाली ताकि आप चाय पीते समय चाय पी सकें।

यहां यह बताना आवश्यक है कि मैं किस प्रकार से बकवास करता हूं कि मैं काम करता हूं।

आप भविष्य के पीएचपी विस्तार का वर्णन करते हुए एक डीएसएल लिखते हैं, फ़ंक्शन, कक्षाओं और विधियों के कार्यान्वयन के साथ के / एन कोड लिखते हैं, फिर make रन करते make और चमत्कारिक रूप से, एक तैयार-निर्मित पुस्तकालय प्राप्त करते हैं जो पीएचपी से जुड़ा हो सकता है।

विधानसभा को 4 चरणों में विभाजित किया जा सकता है:

C और K / N (समान cinterop ) के बीच एक परत बनाना
विस्तार सी कोड पीढ़ी
एक पुस्तकालय का तर्क के साथ संकलन
लक्ष्य पुस्तकालय का संकलन

लक्ष्य K / N कोड में एक PHP वर्ग के उदाहरण बनाने की क्षमता जोड़ना है। उदाहरण के लिए, ताकि वर्ग getInstance() विधि को परिभाषित कर सके। और मैं इसे बनाना चाहता हूं ताकि इसका उपयोग करना सुविधाजनक हो।

सी में, यह समस्या एक या दो बार हल हो जाती है।

 zval *obj = malloc(sizeof(zval)); object_init_ex(obj, myClass);

यह सरल प्रतीत होता है - इसे लें और इसे के / एन में स्थानांतरित करें, लेकिन यहां myClass ...

लेकिन zend_class_entry* प्रकार का एक वैश्विक चर है, जो परियोजना के सी कोड में और पहले से अज्ञात नाम के साथ घोषित किया गया है।

अपने हाथ देखो। आपको लाइब्रेरी को K / N कोड से संकलित करने की आवश्यकता है, जिसमें एक फ़ंक्शन होगा जिसे myClass तक पहुंचने की आवश्यकता है, जो उत्पन्न में परिभाषित है, लेकिन सी-कोड संकलित नहीं है, जिससे यह फ़ंक्शन तब कहा जाएगा।

अंतत: इस कार्यक्षमता के क्रियान्वयन से दो नई कलाकृतियों का समावेश हुआ: .h और .kt कोड जनरेशन के चरण में, सिंटरटॉप चरण की जटिलता और एपिक फेकैप, जिसके बारे में मैं बहुत अंत में बात करूंगा।

अध्याय पाँच मेरे नाम में क्या है?

क्यों की कथा:

 enum class ArgumentType { PHP_STRING, PHP_LONG, PHP_DOUBLE, PHP_NULL, ... }

इससे बेहतर:

 enum class ArgumentType { STRING, LONG, DOUBLE, NULL, ... }

हां, इसे समझाने की कोई आवश्यकता नहीं है। यह वही है जो ArgumentType.NULL कोटलिन लाइब्रेरी की हेडर फ़ाइल में बदल जाता है:

 struct { extension_kt_kref_php_extension_dsl_ArgumentType (*get)(); /* enum entry for NULL. */ } NULL;

और यह कैसे gcc इस पर प्रतिक्रिया करता है।

 /root/simpleExtension/phpmodule/extension_kt_api.h:113:17: error: expected identifier or '(' before 'void' } NULL; ^

पर्दा! नामों के लिए बाहर देखो।

तपस्या अध्याय। आप खुद की प्रशंसा नहीं करेंगे - कोई भी आपकी प्रशंसा नहीं करेगा।

बड़े पैमाने पर, मैंने अपने लक्ष्य हासिल कर लिए हैं। इस विषय में डूबे, कोटलिन नेटिव पर PHP एक्सटेंशन लिखने के लिए "रूपरेखा" तैयार है। यह सबसे महत्वपूर्ण, कार्यक्षमता और पॉलिश को जोड़ने के लिए कुछ नहीं है।

परियोजना खुद और, मुझे उम्मीद है, इसके लिए अच्छा प्रलेखन, जीथब पर देखा जा सकता है।

मैं K / N के बारे में क्या कह सकता हूं? केवल अच्छा है। इस पर लिखना एक खुशी है, और छोटे शोले और खुरदरापन को इस तथ्य के लिए जिम्मेदार ठहराया जा सकता है कि वह क्रैडल से बाहर नहीं निकला है :)

आखिरी अध्याय। बिना कोट्स के, अच्छी की किरणें।

और अब, पूरी गंभीरता से और गहरे सम्मान के साथ, मैं JetBrains के लोगों और Kotlin नेटिव स्लैब चैनल के निवासियों को धन्यवाद देना चाहता हूं। आप सुपर हैं!

और निकोलस इगोटी को विशेष धन्यवाद।

बोनस। महाकाव्य फकप।

चौथे अध्याय में प्रसंग का वर्णन किया गया है।

दरअसल, जब सब कुछ एक ऐसी स्थिति में जोड़ा गया था जिसमें इसे त्रुटियों के बिना संकलित किया गया था, तो एक समस्या पैदा हुई - परीक्षण के दौरान, PHP ने मुझे पूरी तरह से अपरिचित पक्ष से खोला।

 # php -dextension=./phpmodule/modules/extension.so -r "var_dump(ExampleClass::getInstance());" *RECURSION* #

"Figase!" - मैंने सोचा, मैं PHP स्रोत कोड में मिला और ऐसा एक टुकड़ा मिला।

 case IS_OBJECT: if (Z_IS_RECURSIVE_P(struc)) { PUTS("*RECURSION*\n"); return; }

डिबगिंग जोड़ना:

 printf("%u", Z_IS_RECURSIVE_P(struc))

के नेतृत्व में:

 undefined symbol: Z_IS_RECURSIVE_P in Unknown on line 0

"Figase!" मैंने फिर सोचा।

उस समय, जब मैंने php.h (7.1.8) को देखने का अनुमान लगाया था, जो वास्तव में लिनक्स होस्ट पर इस्तेमाल किया गया था, न कि मास्टर ब्रंच (7.3.x) से जीथब से खींचा गया एक दिन। सीधे लज्जित हुए।

लेकिन, जैसा कि यह निकला, यह एक अटेरन नहीं था।

मैंने जिस वस्तु के जीवन को नियंत्रित किया, उसके सभी चरणों में सही पुनरावर्तन जाँच कोड, ने बताया कि सब कुछ काम करना चाहिए। और इसका मतलब यह है कि आपको उन जगहों को ध्यान से देखना चाहिए जिन्हें मैं नियंत्रित नहीं करता हूं। वास्तव में एक ऐसी चीज थी - जिसमें मेरा ऑब्जेक्ट var_dump फ़ंक्शन में वापस आ गया है

 RETURN_OBJ( example_symbols()->kotlin.root.php.extension.proxy.objectToZval( example_symbols()->kotlin.root.exampleclass.getInstance(/* */) ) )

मैक्रो RETURN_OBJ को अंत तक खोलें। तंत्रिका और गर्भवती पर नज़र रखने से दूर!

 1) RETURN_OBJ(r) 2) { RETVAL_OBJ(r); return; } 3) { ZVAL_OBJ(return_value, r); return; } 4) { do { zval *__z = (return_value); Z_OBJ_P(__z) = (r); Z_TYPE_INFO_P(__z) = IS_OBJECT_EX; } while (0); return; } 5) { do { zval *__z = (return_value); Z_OBJ(*(__z)) = (r); Z_TYPE_INFO(*(__z)) = (IS_OBJECT | (IS_TYPE_REFCOUNTED << Z_TYPE_FLAGS_SHIFT)); } while (0); return; } 6) { do { zval *__z = (return_value); (*(__z)).value.obj = (r); (*(__z)).u1.type_info = (8 | ((1<<0) << 8)); } while (0); return; }

यहां तब मुझे दूसरी बार शर्म महसूस हुई। मैं, पूरी तरह से अपनी नीली आँख पर, zval* zend_object* इंतज़ार कर रहा zend_object* और लगभग दो दिन त्रुटि की खोज में बिताए।

सभी को कोटलिन का शुक्रिया! :)

पुनश्च। यदि एक दयालु आत्मा है जो मेरी अनाड़ी अंग्रेजी पढ़ती है और प्रलेखन को ठीक करती है - तो मेरी कृतज्ञता की कोई सीमा नहीं होगी।

एक्सटेंशन PHP और कोटलिन नेटिव। भाग तीन, शायद अंतिम