PHP एक्सटेंशन dom_varimport: DOMDocument में नेस्टेड सरणियों का त्वरित रूपांतरण

कुछ प्रोजेक्ट्स मुख्य टेम्पलेट इंजन के रूप में XSLT का उपयोग करते हैं। XSLT की प्रसिद्ध कमियों के अलावा (उदाहरण के लिए, इसकी वाचालता, सापेक्ष धीमापन, आदि), इसके फायदे भी हैं: "मानक" भाषा, "साइड इफेक्ट्स" की अनुपस्थिति की इसकी विचारधारा और पैटर्न मिलान, यदि आवश्यक हो तो टेम्पलेट्स से सहायक कक्षाओं के तरीकों को कॉल करने की क्षमता। (exslt एक्सटेंशन के माध्यम से)। कुछ समय पहले, मैंने शॉर्टएक्सएसएलटी लाइब्रेरी रखी, जो भारी के बजाय अनुमति देता है <xsl: value of-select = "/ root / abc" /> और <xsl: choose> ... </ xsl: select> लिखने के लिए बस {/ root / चुनें abc} और {if ...} ... {ifif} ... {/ if} बिना प्रदर्शन के नुकसान के, तो क्रिया की समस्या आंशिक रूप से हल हो गई है।



लेकिन अब हम एक्सएसएलटी के फायदे और नुकसान के बारे में बात नहीं कर रहे हैं (मुझे यकीन है कि इस तकनीक के विरोधियों और समर्थकों को प्रचुर मात्रा में मिलेगा)। मैं एक ऐसी तकनीक का वर्णन करना चाहता हूं जो XSLT टेम्प्लेट के साथ मौजूदा परियोजनाओं में उपयोग करने के लिए सुविधाजनक है, और एक पुस्तकालय के लिए एक लिंक प्रदान करता है जो इस तकनीक को अच्छे प्रदर्शन के साथ लागू करता है।

XML पाठकीय प्रतिनिधित्व की पीढ़ी को दरकिनार करते हुए XSLT को डेटा पास करें

कल्पना करें कि हमारे पास एक नियंत्रक है जो पृष्ठ पर प्रदर्शित करने के लिए वस्तुओं के कुछ नेस्टेड PHP सूची बनाता है। उसे इस सरणी को XML में बदलना होगा, जो तब XSLT टेम्पलेट के इनपुट पर जाता है। यह अच्छा होगा यदि PHP संरचनाओं से एक्सएमएल में यह रूपांतरण प्रत्येक नियंत्रक में मैन्युअल रूप से नहीं किया गया था, लेकिन अमूर्त की कुछ मध्यवर्ती परत थी जो कि एक्सएसएलटीटी टेम्पलेट को सीधे पीएचपी डेटा पर लागू कर सकती थी, जो पाठ के एक्सएमएल प्रतिनिधित्व को दरकिनार कर सकती थी। इसलिए हम त्रुटियों की संभावना कम कर देंगे, और पत्र कम हो जाएगा। हम डेटा के XML प्रतिनिधित्व को दरकिनार करते हुए सीधे XSLT टेम्प्लेट के साथ काम कर सकते हैं।



कुछ समय पहले, मैंने C PHP एक्सटेंशन dom_varimport ( GitHub पर पोस्ट ) में लिखा था। इसमें उसी नाम का फ़ंक्शन होता है, जिसके इनपुट पर DOMDocument ऑब्जेक्ट और किसी भी नेस्टिंग के PHP सरणी की आपूर्ति की जाती है। फ़ंक्शन DOMDocument को इनपुट सरणी के XML प्रतिनिधित्व के साथ इसे पास करता है, और यह बहुत जल्दी करता है - शुद्ध PHP में लिखे गए कोड की तुलना में लगभग 20 गुना अधिक तेजी से भरता है। लगभग 1-2 मिलीसेकंड में हजारों संलग्न गुणों और वस्तुओं के साथ 1 एमबी आकार का एक बड़ा दस्तावेज़ बनता है।



उदाहरण के लिए, एक कॉल:

 $ doc = नया DOMDocument ();
 dom_varimport (
     $ डॉक
     सरणी (
         "some_key" => 111,
         123
         0.5
         "एरियर" => एरे ("1 ए" => "1 ए"),
         "obj" => (ऑब्जेक्ट) सरणी ("प्रोप" => "वैल"),
         सच है,
         झूठी,
         "b" => अशक्त,
         "खाली" => सरणी (),
     )
     "रूट" // वैकल्पिक, "रूट" के लिए चूक
 );
 $ doc-> formatOutput = true;
 इको $ doc-> saveXML ();  // यह केवल डिबगिंग के लिए है: व्यवहार में, आपको saveXML () कॉल करने की आवश्यकता नहीं होगी

इस XML दस्तावेज़ को प्रिंट करता है:

 <? xml संस्करण = "1.0"?>
 <रूट>
     <some_key key = "some_key"> 111 </ some_key> <! - plain key = value ->
     <आइटम कुंजी = "0"> 123 </ आइटम> <! - संख्यात्मक कुंजी "आइटम" टैग हैं ->
     <आइटम कुंजी = "1"> 0.5 </ आइटम> <! - दोहरा ->
     <arr key = "arrest"> <! - nested array ->
         <आइटम कुंजी = "1a"> 1a </ आइटम> <! - अमान्य टैग नाम "आइटम" -> में कनवर्ट किए जाते हैं
     </ आगमन>
     <obj key = "obj"> <! - नेस्टेड ऑब्जेक्ट ->
         <प्रोप कुंजी = "प्रोप"> वैल </ प्रोप>
     </ Obj>
     <आइटम कुंजी = "2"> 1 </ आइटम> <! - सत्य 1 से> में परिवर्तित होता है
     <आइटम कुंजी = "3" /> <! - गलत एक खाली स्ट्रिंग में कनवर्ट करता है ->
     <b key = "b" /> <! - null एक खाली स्ट्रिंग -> में भी परिवर्तित हो जाता है
     <खाली कुंजी = "खाली" /> <! - खाली सरणी एक खाली तत्व है ->
 </ रूट>

सब कुछ काफी पारदर्शी है: सरणी कुंजी और ऑब्जेक्ट गुण XML तत्व बन जाते हैं, संभवतः एक ही नाम के साथ (लेकिन यदि नाम XML तत्व के लिए मान्य नहीं है, तो इसके बजाय "आइटम" का उपयोग किया जाता है)। इस तरह के एक्सएमएल दस्तावेज़ को डीबग करते समय पढ़ना बहुत आसान है, यह बहुत कॉम्पैक्ट है। तो, हमें आउटपुट पर DOMDocument ऑब्जेक्ट मिलता है, जिसे हम पहले से ही XSLTProcessor में पास कर सकते हैं। एक्सएमएल टेक्स्टुअल प्रतिनिधित्व कहीं भी प्रकट नहीं होता है, इसे कहीं भी पार्स नहीं किया जाता है।

एक्सटेंशन कैसे स्थापित करें

एक्सटेंशन सी में लिखा है, इसलिए इसे एक मशीन पर संकलित किया जाना चाहिए, जिस पर जीसीसी और php5-src (या php5-devel) जैसे पैकेज स्थापित हैं। यह बिल्कुल डरावना नहीं है:

 git clone https://github.com/DmitryKoterov/dom_varimport.git
 सीडी डोम_वरिमपोर्ट
 phpize
 कॉन्फ़िगर
 मेकअप
 परीक्षण करें
 मैन्युअल रूप से # या कॉपी मॉड्यूल / dom_varimport.so स्थापित करें
 phpize --clean

"मेक इनस्टॉल" स्टेप को छोड़ा जा सकता है: बस बाइनरी फ़ाइल मॉड्यूल / dom_varimport.so को लें और इसे PHP एक्सटेंशन (उदाहरण के लिए, / usr / lib / php5) के साथ एक निर्देशिका में कॉपी करें, जिसमें अन्य मशीनें भी शामिल हैं। अंत में, आपको /etc/php5/conf.d/dom_varimport.ini में एक्सटेंशन कनेक्ट करना होगा और php5-fpm या Apache को पुनरारंभ करना होगा:

 एक्सटेंशन = /usr/lib/php5/dom_varimport.so