ईज़ीवेब: नए साल का अपडेट

मेरी पिछली पोस्ट में , जिसने जनता के लिए इज़ीवेब वेब इंजन का परिचय दिया, यह कहा गया था:

यह योजना बनाई गई है कि पहला संस्करण, जिसे स्थिर और पूरी तरह से उपयोग करने योग्य कहा जा सकता है, वर्ष के अंत से पहले दिखाई देगा।

चूँकि साल खत्म होने से पहले एक दिन से भी कम समय बचा है, मैं आपको बताता हूँ कि इस साल हम और क्या करने में कामयाब रहे।

XML सुविधाएँ

Easyweb को सौंपे गए अन्य कार्यों में PHP की ओर से XML के साथ काम करने की आवश्यकता थी, जितना संभव हो साफ, सुंदर, कॉम्पैक्ट और आसानी से समझा जा सके। फिलहाल, XML सुविधा के सभी बुनियादी तरीकों को जोड़ा गया है। सार्वजनिक विधियों और उपयोग के छोटे उदाहरणों का विवरण:

• XML दस्तावेज़: github.com/nyan-cat/easyweb/wiki/class-xml
• XML नोड सेट: github.com/nyan-cat/easyweb/wiki/class-nodeset
• XML नोड: github.com/nyan-cat/easyweb/wiki/class-node

हमेशा की तरह, GitHub पर सुविधा अनुरोध के माध्यम से किसी भी अतिरिक्त कार्यक्षमता का अनुरोध किया जा सकता है।

मैं मानक PHP DOM API और Easyweb XML सुविधाओं पर समान समस्या को हल करने का एक उदाहरण दूंगा। बात यह है। आपको पुस्तकों के विवरण के साथ एक फ़ाइल डाउनलोड करने की आवश्यकता है, और प्रत्येक पुस्तक के साथ निम्नलिखित करें: कीमत रीसेट करें, मुद्रा कोड को उसके निचले मामले से बदलें, और पुस्तक के लेखक और श्रेणी के लिए निर्दिष्ट पहचानकर्ता भी सेट करें (त्रुटि जाँच सहित)।

यह था:

<?php function replace($author_id, $category_id) { $xml = new DOMDocument(); if(!$xml->load('/var/www/html/mywebsite/xml/library.xml')) { throw new Exception('Error loading XML file'); } $xpath = new DOMXPath($xml); foreach($xpath->query('/books/book') as $book) { $price = $xpath->query('price', $book); if($price->length != 1) { throw new Exception('Node "price" should be unique for the book'); } $price->item[0]->nodeValue = 0; $currency = $price->getAttribute('currency'); if($currency) { $book->setAttribute('currency', strtolower($currency)); } else { throw new Exception('Attribute "currency" not found'); } $book->setAttribute('author_id', $author_id); $book->setAttribute('category_id', $category_id); } } ?> 

यह बन गया:

 <?php function replace($author_id, $category_id) { $xml = xml::load('/xml/library.xml'); foreach($xml->query('/books/book') as $book) { $book['price'] = 0; $book['price/@currency'] = strtolower($book['price/@currency']); $book['@author_id'] = $author_id; $book['@category_id'] = $category_id; } } ?> 

ईज़ीवेब एक्सएमएल सुविधा देशी PHP डोम संसाधन हैंडल से निर्मित की जा सकती है, और उन्हें झिल्ली फ़ंक्शन ::get() माध्यम से उपयोगकर्ता को देने के लिए भी है, जिससे मूल PHP डोम ऑब्जेक्ट्स के माध्यम से काम करने वाले तीसरे पक्ष के पुस्तकालयों के साथ एकीकृत करना आसान हो जाता है।

XPath एक्सटेंशन www: पेजेट

www:paginate($page, $count, $size)

फ़ंक्शन को एक स्थिर पेजिनेटर के प्रतिपादन को सरल बनाने के लिए डिज़ाइन किया गया है।
$page वर्तमान पृष्ठ है।
$count पृष्ठों की कुल संख्या है।
$size - पेजिनेटर का आकार।
वर्तमान पृष्ठ को current विशेषता के साथ चिह्नित किया गया है। पहले पृष्ठ पर कोई <previous /> नोड नहीं होगा, <next /> पिछले पृष्ठ पर <next /> नोड होगा।

www:paginate(15, 85, 10) फ़ंक्शन को कॉल करने से यह XML वापस आ जाएगा:

 <pages> <previous>14</previous> <page>10</page> <page>11</page> <page>12</page> <page>13</page> <page>14</page> <page current="current">15</page> <page>16</page> <page>17</page> <page>18</page> <page>19</page> <next>16</next> </pages> 

लेआउट उदाहरण:

 <xsl:template match="/"> <xsl:apply-templates select="www:paginate(15, 85, 10)/pages/*" /> </xsl:template> <xsl:template match="previous"> <a href="/page/{.}/" class="page">← Previous</a> </xsl:template> <xsl:template match="next"> <a href="/page/{.}/" class="page">Next →</a> </xsl:template> <xsl:template match="page[@current]"> <span class="page current"><xsl:value-of select="." /></span> </xsl:template> <xsl:template match="page"> <a href="/page/{.}/" class="page"><xsl:value-of select="." /></a> </xsl:template> 

संभावित परिणाम:

कैशिंग ब्लॉक करें

अब XSL एक्सटेंशन www:xslt का परिणाम फाइलों में कैश्ड हो सकता है। ऐसा करने के लिए, विशेषता cache="true" । cache-args और cache-lifetime दो वैकल्पिक विशेषताएं भी हैं, जिनमें से पहला आपको कैश्ड ब्लॉक के लिए सरल मापदंडों की एक सूची और दूसरा कैश्ड डेटा के जीवनकाल को सीमित करने की अनुमति देता है। उपयोग उदाहरण:

 <www:xslt xsl="/books.xsl" xml="book:list(author_id -> {$author_id})" args="page -> {$page}, count -> 10" cache="true" cache-args="domain -> '{$domain}'" cache-lifetime="600" /> 

XQuery

ईज़ीवेब में XQuery समर्थन का पहला संस्करण। फिलहाल, इसकी क्षमताएं बहुत सीमित हैं: आप मापदंडों को पारित नहीं कर सकते हैं, आप XSL- और XPath- एक्सटेंशन ईज़ीवेब का उपयोग नहीं कर सकते हैं। अब मुख्य समस्या यह है कि PHP के लिए एक अच्छा XQuery पुस्तकालय सिद्धांत रूप में नहीं मिल सकता है। यदि आप बुद्धिमान सलाह के साथ मदद कर सकते हैं, तो मुझे यह सुनकर खुशी होगी: habrahabr.ru/qa/31087

फिलहाल, XQuery को XQuery लाइट ( http://phpxmlclasses.sourceforge.net/xquery_lite.html ) के माध्यम से बनाया गया है, जिसे 2002 में इसके लेखक ने वापस बनाया और छोड़ दिया था। XQuery लाइट को Easyweb रिपॉजिटरी में इस तथ्य के कारण अपलोड किया गया था कि इसे PHP5 में काम करने के लिए एक फ़ाइल के साथ समाप्त किया जाना था।

XQuery समर्थन अब XSL एक्सटेंशन www:xquery को पेश करने के लिए है:

 <div> <h1>External Resources</h1> <www:xquery src="/tpl/links.xq" /> </div> 

कस्टम XSL एक्सटेंशन

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

 $www = www::create('en', 'us'); $www->register_xsl('http://supermarkup.com/about', 'sm', 'block', function($node) { $xml = new xml(); foreach($node->children() as $child) { $xml->append($xml->import($child)); } foreach($xml->query('//text()') as $text) { $parent = $text->parent(); $parent->append(supermarkup($text->value())); $parent->remove($text); } return $xml; }); 

टेम्पलेट में उपयोग:

 <?xml version="1.0" encoding="utf-8" ?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl" xmlns:www="https://github.com/nyan-cat/easyweb" xmlns:sm="http://supermarkup.com/about" exclude-result-prefixes="php www sm"> <xsl:template match="/"> <sm:block> <xsl:copy-of select="message" /> </sm:block> </xsl:template> </xsl:stylesheet> 

एक्सटेंशन हैंडलर फ़ंक्शन ईज़ीवेब एक्सएमएल सुविधा के माध्यम से काम करता है। यह एक्सएमएल नोड को स्वीकार करता है, जो कि एक एक्सटेंशन है, और एक्सएमएल नोड या एक्सएमएल दस्तावेज या तो रिटर्न करता है जो एक्सटेंशन नोड को बदल देगा।

इंजन कोड में सीधे टिंकरिंग की तुलना में कस्टम एक्सटेंशन लिखना बेहतर क्यों है? क्योंकि ईज़ीवेब गारंटी देता है (या लगभग गारंटी देता है) कि पंजीकरण का इंटरफ़ेस और एक्सटेंशन हैंडलर नहीं बदलेगा, लेकिन अनिर्दिष्ट इंटर्न को अच्छी तरह से देखा जा सकता है।

GeoIP

इंजन में जियोआईपी सपोर्ट दिखाई दिया है। इसके संचालन के लिए, आपको PHP PECL GeoIP स्थापित करना होगा। जियोआईपी सपोर्ट ईज़ीवेब एब्सट्रैक्ट प्रोसेस इंटरफेस के माध्यम से किया जाता है। साइट विन्यास में जियोआईपी प्रक्रिया के विवरण का एक उदाहरण:

 <procedure name="geoip:record" datasource="geoip" method="record" root="record"> <param name="host" type="string" /> </procedure> 

अब इस प्रक्रिया का उपयोग कहीं भी किया जा सकता है जहां ईज़ीवेब अमूर्त प्रक्रियाओं का उपयोग किया जाता है: एक पृष्ठ को रेंडर करते समय, ब्लॉक को रेंडर करते समय, एक्सेस सिस्टम समूहों की गणना करते समय, एक्सपीथ एक्सटेंशन www:query , या पीएचपी से ईज़ीवेब क्लास के एक उदाहरण के माध्यम से कॉल करते समय। कॉल उदाहरण:

 $record = $www->query('geoip:record', array ( 'host' => $www->variable('user:ip') )); 

संभावित परिणाम:

 <?xml version="1.0"?> <record> <country> <alpha2>US</alpha2> <alpha3>USA</alpha3> <name>United States</name> </country> <region>NC</region> <city>Charlotte</city> <latitude>35.206001281738</latitude> <longitude>-80.829002380371</longitude> </record> 

यह मत भूलो कि आपको जियोआईपी डेटाबेस को अलग से डाउनलोड करने की आवश्यकता है:

• एक नि: शुल्क आधार स्थापित करना: http://www.maxmind.com/en/installation?city=1
• अधिक विस्तृत सशुल्क संस्करण: http://www.maxmind.com/en/city
• ठीक है, या torrents पर ;-)

पूर्ण पाठ और पहलू खोज

पूर्ण-पाठ और पहलू खोज का पहला परीक्षण संस्करण सामने आया है। खोज Apache Solr ( http://lucene.apache.org/solr/ ) के माध्यम से की जाती है। खोज का उपयोग करने के लिए, आपको जावा, सर्वलेट कंटेनर (उदाहरण के लिए, टॉमकैट या जेट्टी), सोलर को स्थापित करने की आवश्यकता है, साथ ही पीएचपीईसीएल सोलरक्लाइंट भी। CentOS पर सोलर स्थापित करने पर एक सरल और सुलभ लेख: http://blog.nexcess.net/2011/12/30/installing-apache-solr-on-centos/ ।

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

 <datasource name="metadata" type="solr" server="localhost" port="8080" url="/solr/" username="admin" password="samplepassword" /> <!-- ... --> <procedure name="guestbook:add" datasource="guestbook" core="guestbook" method="add"> <param name="author_id" type="natural" /> <param name="message" type="author" /> <param name="host" type="ipv4" /> </procedure> <!-- ... --> <procedure name="guestbook:list" datasource="guestbook" core="guestbook" method="query" root="messages" item="message"> *:* </procedure> 

अब तक, आपको अपने आप को सोल को कॉन्फ़िगर करने की आवश्यकता है। भविष्य में, यह मक्खी पर एक सोलर सर्किट जनरेटर बनाने की योजना है।

निष्कर्ष

इसलिए, इंजन उन सभी बुनियादी कोर-स्तरीय कार्यों को लागू करता है जो पहले नियोजित थे। लंबी अवधि में, एलएल (1) पार्सर्स, एक ओआरएम प्रणाली और पूर्ण-द्वैध ग्राहक और सर्वर संचार के लिए एक रूपरेखा है।

अगले वर्ष की शुरुआत के लिए इंजन के एक नए संस्करण के लिए सभी ईज़ीवेब की विशेषताओं का उपयोग करके एक बिग® कमर्शियल © साइट ™ को शुरू करना है, जिसके समानांतर में पता चला त्रुटियों को समाप्त किया जाएगा।

मुझे आपके फ़ीचर रिक्वेस्ट, बग रिपोर्ट, और ईज़ीवेब को स्थापित करने और उपयोग करने के बारे में सवाल करने में बहुत खुशी होगी।

नया साल मुबारक हो!