🕰️ 🤰🏻 🛌🏾 एक्सटेंशन PHP और कोटलिन नेटिव। भाग दो, चेतना 🍣 ⏺️ 😔

पहले भाग का सारांश:

औजारों की स्थापना और विन्यास।
helloWorld() में helloWorld() फ़ंक्शन लिख रहा है और इसे एक साझा लाइब्रेरी में संकलित कर रहा है।
इस फ़ंक्शन को PHP एक्सटेंशन C कोड से एक्सेस करें।

इस लेख में, मैं सी को छूने के बिना PHP एक्सटेंशन लिखने के लिए उपकरण बनाने के बारे में बात करूंगा, विशेष रूप से के / एन पर।

कौन परवाह करता है - बिल्ली में आपका स्वागत है।
जो कोई भी पढ़ता है वह दिलचस्पी नहीं रखता है, लेकिन सिर्फ यह देखना चाहता है - गितुब का स्वागत है

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

तुरंत एक आरक्षण करें कि मैं एक पूर्ण रूपरेखा बनाने का दिखावा नहीं करता (शायद बाद में), इसलिए हम इस तरह से कार्यक्षमता को सीमित करेंगे:

ऐसे फ़ंक्शन बनाना जो PHP कोड से कॉल किए जा सकते हैं।
स्थिरांक की परिभाषा।
हम केवल सरल PHP प्रकारों के साथ काम करते हैं: string , boolean , int , float (और null )। कोई सरणियाँ, ऑब्जेक्ट्स, संसाधन, संदर्भ द्वारा स्थानान्तरण, आदि। - मैं आपको नीचे बताऊंगा।

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

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

एक्सटेंशन लाइब्रेरी को शास्त्रीय तरीके से बनाने के लिए (phpize, कॉन्फ़िगर, बनाओ), कम से कम दो कलाकृतियों की आवश्यकता है - C में एक्सटेंशन कोड और फ़ाइल config.m4 ।

उपयोग परिदृश्य इस प्रकार होगा:

DSL का उपयोग करते हुए, हम विस्तार का वर्णन करते हैं।
हम K / N पर कार्यों के कार्यान्वयन को लिखते हैं।
विवरण के अनुसार, हम extension.c और config.m4 उत्पन्न config.m4 । extencion.c में कोड फ़ंक्शन कॉल की extencion.c से extencion.c ।
वर्णन द्वारा, हम कॉन्स्टैंट.कैट बनाते हैं, जो हमें K / N पर हमारे कार्यों में दिए गए स्थिरांक का उपयोग करने की अनुमति देता है।
हम K / N कोड को स्टैटिक लाइब्रेरी में संकलित करते हैं।
यह सब एक साथ रखना और इसे एक विस्तार पुस्तकालय में संकलित करना।

चलो चलते हैं!

हमारी योजना को लागू करने के लिए, हमें इस संरचना की तरह कुछ प्राप्त करने की आवश्यकता है:

 (, ) 1 2 ... 1(,  ) 1 2 ... 1 ...

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

अगला कदम इस डीएसएल को आवश्यक कलाकृतियों में बदलना है। ऐसा करने के लिए, हम उसी K / N पर एक जनरेटर लिखेंगे, उसमें से एक निष्पादन योग्य फ़ाइल संकलित करें और हमारे DSL और इसे चलाएं - वॉइला! समाधान सबसे सुरुचिपूर्ण नहीं है, लेकिन मेरे लिए अभी तक अधिक सरल और विश्वसनीय कुछ भी नहीं हुआ है।

खैर, फिर सब कुछ सरल है - हम कार्यों के साथ पुस्तकालय को संकलित करते हैं और विस्तार को एक नियमित तरीके से इकट्ठा करते हैं, जिसमें यह भी शामिल है।

उपयोग में आसानी के लिए, संकलन के साथ सभी जादू एक शेल स्क्रिप्ट में छिपा हुआ है।

इसका क्या आया?

इस डीएसएल पर वर्णित सरल विस्तार के लिए विवरण और उत्पन्न कोड का एक उदाहरण ( बेहतर समझ के लिए, सभी तर्क एक नामित रूप में दिए गए हैं )।

konfigure.kt - डीएसएल एक्सटेंशन

 import php.extension.dsl.* val dsl = extension(name = "example", version = "0.1") { constant(name = "HELLO_EN", value = "Hello") constant(name = "HELLO_ES", value = "Hola") constant(name = "HELLO_RU", value = "") function(name = "hello", returnType = ArgumentType.STRING) { arg(type = ArgumentType.STRING, name = "name") arg(type = ArgumentType.STRING, name = "lang", optional = true) } } fun main(args: Array<String>) = dsl.make()

example.kt - कार्यों को लागू करना

 fun hello(name: String, lang: String?) = "${if (lang ?: "" == "") HELLO_EN else lang} $name!!!\n"

`लैंग` के लिए मूल्य निर्धारित करने के लिए अजीब एल्गोरिथ्म पर ध्यान दें। यह के / एन के वर्तमान संस्करण में एक बग के कारण है, जो सी से एक तर्क के रूप में `चर *` प्रकार के एक अनियंत्रित चर को पारित करने की अनुमति नहीं देता है - आपको खाली स्ट्रिंग पास करना होगा।

config.m4 - जनरेट की गई फ़ाइल

 PHP_ARG_ENABLE(example, whether to enable example support,[ --enable-example Enable hello support]) if test "$PHP_EXAMPLE" != "no"; then PHP_ADD_INCLUDE(.) PHP_ADD_LIBRARY_WITH_PATH(example_kt, ., EXAMPLE_SHARED_LIBADD) PHP_SUBST(EXAMPLE_SHARED_LIBADD) PHP_NEW_EXTENSION(example, example.c, $ext_shared) fi

example_generated_constants.kt - कोटलिन स्थिरांक के साथ उत्पन्न फ़ाइल

 const val HELLO_EN = "Hello" const val HELLO_ES = "Hola" const val HELLO_RU = ""

example.c - C कोड के साथ जनरेट की गई फ़ाइल

 #include "php.h" #include "example_kt_api.h" PHP_FUNCTION(hello); static zend_function_entry example_functions[] = { PHP_FE(hello, NULL) {NULL,NULL,NULL} }; PHP_MINIT_FUNCTION(example); zend_module_entry example_module_entry = { #if ZEND_MODULE_API_NO >= 20010901 STANDARD_MODULE_HEADER, #endif "example", example_functions, PHP_MINIT(example), NULL, NULL, NULL, NULL, #if ZEND_MODULE_API_NO >= 20010901 "0.1", #endif STANDARD_MODULE_PROPERTIES }; ZEND_GET_MODULE(example) PHP_MINIT_FUNCTION(example) { REGISTER_STRING_CONSTANT("HELLO_EN", "Hello", CONST_CS|CONST_PERSISTENT); REGISTER_STRING_CONSTANT("HELLO_ES", "Hola", CONST_CS|CONST_PERSISTENT); REGISTER_STRING_CONSTANT("HELLO_RU", "", CONST_CS|CONST_PERSISTENT); return SUCCESS; } PHP_FUNCTION(hello){ //-,      char*  K/N char *name = malloc(1); name[0] = '\0'; size_t name_len=0; char *lang = malloc(1); lang[0] = '\0'; size_t lang_len=0; if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|s", &name, &name_len, &lang, &lang_len) == FAILURE) { return; } RETURN_STRING(example_kt_symbols()->kotlin.root.hello(name, lang)); }

केवल सरल प्रकारों के बारे में क्यों

क्योंकि वे एक से एक कोटलीन मूल प्रकार के मैप हैं। तिथि करने के लिए, परियोजना लागू होती है, वास्तव में, केवल एक दिशा में इंटरॉप होती है, अर्थात। C से K / N फ़ंक्शन को कॉल करना। जटिल प्रकारों को संसाधित करने के लिए, जैसे कि zend_value , zend_class_entry या zend_fcall_info , आपको K / N प्रोजेक्ट में संबंधित संरचनाओं को आयात करना होगा और उनके साथ काम करने के लिए उचित रैपर लिखना होगा, और सभी मैक्रोज़ आदि भी हैं।

टार के साथ जार। एक चम्मच जुड़ा हुआ है।

कोटलिन मूल दस्तावेज। यह वहाँ लगता है, लेकिन ... अब तक, अध्ययन का सबसे विश्वसनीय साधन स्रोत को पढ़ना है।
परिणामी विस्तार का आकार इतना छोटा नहीं है। उपरोक्त उदाहरण के लिए, लगभग 500KB का एक पुस्तकालय प्राप्त किया जाता है।
आपको यह भी उम्मीद नहीं करनी होगी कि K / N में लिखे गए एक्सटेंशन PHP एक्सटेंशन लाइब्रेरी में समाप्त हो जाएंगे। उत्पाद प्राप्त होता है, इसलिए बोलने के लिए, केवल आंतरिक उपयोग के लिए।

आगे क्या है

"केवल सरल प्रकार के बारे में" अनुभाग में वर्णित सभी चीजों को लागू करें।

एक बार फिर, रिपॉजिटरी का एक लिंक ।

आपका ध्यान के लिए धन्यवाद, मुझे शुभकामनाएँ :)