🍭 🖼️ 🙎🏻 Easyweb - वेब के लिए XSLT इंजन 👨🏾 🔷 👩🏻

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

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

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

यदि किसी कारण से आप मौजूदा सीएमएस से संतुष्ट नहीं हैं;
यदि आप इस बारे में सोच रहे हैं कि आपको "सब कुछ खुद लिखने" की क्या ज़रूरत है;
यदि आप मौजूदा सॉफ्टवेयर फ्रेमवर्क की जटिलता से डरते हैं;
अगर आपको एक्सएचटीएमएल पसंद है, साथ ही एक्सएमएल तकनीक का एक अनुकूल परिवार भी है।

प्रागितिहास

वेब के लिए विकास के साथ मेरा परिचय काफी मानक रूप से शुरू हुआ: मेरे कीबोर्ड के नीचे से निकलने वाली साइटें HTML से गन्दी थीं, PHP आवेषण के साथ मिश्रित होती हैं और mysql_ * API के माध्यम से डेटाबेस तक सीधी पहुँच बनाती हैं। हालाँकि, जब से मैं एक लंबे समय के लिए विभिन्न प्रकार की भाषाओं में प्रोग्रामिंग में लगा हुआ हूं, कोडांतरक से लेकर एसक्यूएल, शेड्स और एलेक्जेंड्रा जैसी सी ++ तक, मुझे जल्दी से एहसास हुआ कि किसी को भी इस तरह की वेब में दिलचस्पी नहीं थी और कुछ को बदलने की जरूरत थी। बहुत कम समय बीत गया, और मैंने अपने मित्र से एक्सएसएलटी के अस्तित्व के बारे में सीखा। मैटरियल का अध्ययन करने के बाद, मुझे एहसास हुआ: यहाँ यह है, मेरे सपनों की तकनीक! हालांकि, XSLT सिर्फ एक टेम्पलेट इंजन है, जबकि वेब विकास कार्यों की एक विस्तृत श्रृंखला शामिल है। इसलिए, मैंने तय किया कि मुझे एक पूर्ण इंजन बनाने की आवश्यकता है।

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

तीसरे और चौथे संस्करण के बीच, मेरे पास तकनीकी गैग्स की एक पूरी श्रृंखला थी, जिसके संबंध में मैंने ईज़ीवेब के चौथे संस्करण को किसी अन्य भाषा में लिखने के बारे में भी गंभीरता से सोचा था। एक या दूसरे डिग्री पर, C ++, Java, Scala, Ruby, Perl, Erlang और यहां तक कि Microsoft प्रौद्योगिकियों के साथ उनके .NET और अन्य IIS में कुछ प्रयास किए गए हैं। हालांकि, विभिन्न कोणों से समान समस्याओं पर विचार करने के छह महीने से अधिक समय के बाद, अंत में हम PHP के भीतर सभी बाधाओं को दूर करने में कामयाब रहे। हुर्रे, समाधान मिला!

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

वर्तमान स्थिति

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

प्रलेखन अंग्रेजी में लिखा गया है, हालांकि, अभी तक एक देशी वक्ता द्वारा समायोजित नहीं किया गया है, इसलिए मेरे रियाज़ लहजे के साथ बहुत हँसने की कोशिश न करें।

बिंदु पर पहुँचो

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

ईज़ीवेब एक इंजन है जिसमें आपको खुद सब कुछ करने की आवश्यकता होती है। यह सब है: एक डेटाबेस डिज़ाइन करें, एसक्यूएल प्रक्रियाएँ लिखें, एक्सएचटीएमएल बिछाएँ, सीएसएस शैलियों, जावा स्क्रिप्ट्स, साथ ही साथ पोस्ट रिक्वेस्ट हैंडलर्स भी लिखें। Easyweb का उद्देश्य और अर्थ आपको यह "सब कुछ" सरल, कॉम्पैक्ट, पठनीय, सहज, सुरक्षित और एक दर्जन अन्य सुंदर बोलियों के साथ करने की अनुमति देता है।

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

डेटाबेस

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

XML विन्यास

कॉन्फ़िगरेशन वर्णन करता है कि साइट पर कौन से पृष्ठ हैं, कौन से डेटा स्रोत उपलब्ध हैं, इस डेटा को एक्सेस करने के लिए कौन सी प्रक्रियाएँ उपयोग की जाती हैं (और वे कैसे दिखती हैं), और पेज, प्रक्रिया और टेम्पलेट टुकड़े के अधिकार कैसे विनियमित होते हैं।

पेज:

<page name="book" url="/book/(book_id -> natural)/"> <template src="/tpl/main.xsl" xml="book:info(book_id -> $book_id)"> <template name="head" src="/tpl/home/head.xsl" /> <template name="body" src="/tpl/home/body.xsl" /> </template> </page>

डेटा स्रोत:

 <datasource name="library" type="postgresql" server="192.168.10.230" username="guest" password="mZrCe3qlj92H" database="library" charset="UNICODE" />

प्रक्रिया:

 <procedure name="book:list" datasource="library" root="books" item="book" empty="true"> <param name="author_id" type="natural" /> select id, title, description from book where author_id = $author_id; </procedure>

समूह सदस्यता:

 <group name="editor"> <param name="account_id" type="natural" /> account:type(account_id -> $account_id) = 'editor' </group>

समाधान:

 <permission name="book:edit"> <param name="account_id" type="natural" /> <param name="book_id" type="natural" /> editor(account_id -> $account_id) and public(book_id -> $book_id) </permission>

पेज टेम्पलेट

सभी पेज टेम्प्लेट एक्सएसएल-वैध दस्तावेज हैं, जिसके अंदर पेज मानक XSL और XPath संस्थाओं के साथ टाइपसेट, साथ ही इंजन द्वारा प्रदान किए गए एक्सटेंशन हैं। Easyweb एक्सटेंशन www नामस्थान में स्थित हैं। एक साधारण रूट पैटर्न का एक उदाहरण:

 <?xml version="1.0" encoding="utf-8" ?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:php="http://php.net/xsl" xmlns:www="https://github.com/nyan-cat/easyweb" exclude-result-prefixes="xi php www"> <xsl:template match="/"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <xi:include href="head.xml" /> <www:template name="head" /> </head> <body> <www:xslt xsl="/xsl/menu.xsl" xml="/xml/menu.xml" /> <www:template name="body" /> <footer> <xsl:value-of select="www:local('footer')" /> </footer> </body> </html> </xsl:template> </xsl:stylesheet>

मेनू के लेआउट का उदाहरण (ऊपर के उदाहरण से menu.xsl):

 <?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" exclude-result-prefixes="php www"> <xsl:template match="menu"> <xsl:for-each select="item"> <a href="{@href}"> <xsl:value-of select="www:local(@name)" /> </a><xsl:if test="position() != last()"> | </xsl:if> </xsl:for-each> </xsl:template> </xsl:stylesheet>

प्रक्रिया द्वारा प्राप्त पुस्तकों की सूची का लेआउट। XSL टेम्पलेट एक अलग फ़ाइल में संग्रहीत है:

 <www:xslt xsl="/xsl/book-list.xsl" xml="book:list(author_id -> $author_id)" />

वर्तमान टेम्पलेट में तुरंत प्रभाव:

 <xsl:for-each select="www:query('book:list', 'author_id -> $author_id')/books/book"> <h3><xsl:value-of select="title" /></h3> <xsl:copy-of select="description" /> </xsl:for-each>

स्थानीयकरण

Easyweb बहुभाषी साइटों के ग्रंथों को संग्रहीत करने के लिए एक विशेष प्रारूप की XML फ़ाइल प्रदान करता है। ऐसी फ़ाइल का एक उदाहरण:

 <?xml version="1.0" encoding="utf-8" ?> <local> <home> <title> <en>Chinese Cuisine</en> <ru> </ru> <zh>中国菜</zh> </title> <description> <en> Welcome to Nannan Zhang personal website about chinese cuisine. Feel free to contact me at <a href="mailto:nannan@zhang.com">nannan@zhang.com</a>. </en> <ru>       ,   .        <a href="mailto:nannan@zhang.com">nannan@zhang.com</a>. </ru> <zh>关于中式美食，欢迎访问张南南个人网站。垂询邮箱：<a href="mailto:nannan@zhang.com">nannan@zhang.com</a> </zh> </description> </home> </local>

इस XML से डेटा अंशों का अनुरोध करने के लिए, एक विशेष XPath एक्सटेंशन और स्ट्रिंग उपनाम प्रदान किए जाते हैं, जो संबंधित नोड को पथ रिकॉर्ड करने का एक सरलीकृत रूप हैं। XSL टेम्पलेट में टेक्स्ट आउटपुट का एक उदाहरण:

 <xsl:copy-of select="www:local('home:description')" />

पोस्ट अनुरोध प्रसंस्करण

कॉन्फ़िगरेशन में पेज को कॉन्फ़िगर करना:

 <page name="book:edit:post" url="/book/edit/post/" action="/php/book-edit.php" permission="book:edit(account_id -> $session:account_id, book_id -> $post:id)" />

पुस्तक की सामग्री- edit.php:

 <?php function action($www, $response) { $www->query('book:edit', array ( 'book_id' => post::hidden('id'), 'title' => post::text('title'), 'description' => post::textarea('description') )); $response->location('/book/' . post::hidden('id') . /); } ?>

POST अनुरोध द्वारा अपलोड की गई छवियों को सहेजने का एक उदाहरण:

 <?php function action($www, $response) { foreach(files::get('picture.+') as $file) { $image = image::load($file['name']); $scaled = $image->fit_to_width_copy(800); $image_id = $www->evaluate('image:create'); $scaled->save(fs::normalize('/images/pictures/' . $image_id)); } } ?>

सत्र के साथ काम करें

इंजन द्वारा प्रदान की गई PHP कक्षाओं में, एक सत्र वर्ग है जिसे एक सत्र में वस्तुओं को संग्रहीत करने और उनसे इसे पुनर्प्राप्त करने के लिए डिज़ाइन किया गया है। ईज़ीवेब आपको एक सत्र में स्ट्रिंग्स और संख्याओं के साथ-साथ अधिक जटिल संस्थाओं, जैसे कि इंडेक्स एरे, एसोसिएटिव एरेज़, ईज़ीवेब एक्सएमएल क्लास ऑब्जेक्ट्स, साथ ही JSON और इसके विपरीत में क्रमबद्ध किसी भी PHP ऑब्जेक्ट को स्टोर करने की अनुमति देता है:

 <?php session::start(); session::value('account_id', $account_id); var_dump( session::value('account_id') ); session::vector('numbers', array(1, 2, 3)); var_dump( session::vector('numbers') ); session::map('food', array('Apple' => 'Fruit', 'Potato' => 'Vegitable')); var_dump( session::map('food') ); $xml = xml::load('/xml/menu.xml'); session::xml('menu', $xml); var_dump( session::xml('menu') ); session::object('user', new user('Mark', user::type_editor, 35)); var_dump( session::object('user') ); ?>

सत्र में संग्रहीत सभी वस्तुएँ एक्सएमएल प्रतिनिधित्व के रूप में अपने एक्सएसएल टेम्पलेट्स से एक विशेष एक्सपीथ एक्सटेंशन के माध्यम से सुलभ हैं:

 <xsl:for-each select="www:session('xml', 'menu')/menu/item"> <a href="{@url}"><xsl:value-of select="@name" /></a> </xsl:for-each>

तकनीकी मुद्दे

फिलहाल, इंजन PHP वर्ग XSLTProcessor के माध्यम से काम करता है, जो बदले में, libxslt का उपयोग करता है। इसका मतलब है कि केवल XSLT 1.0 और XPath 1.0 का उपयोग किया जा सकता है। अच्छी खबर यह है कि मानक एसेंबली में XSLTProcessor EXSLT के थोक का समर्थन करता है। जैसे ही / अगर XSLT / XPath 2.0 के साथ काम करने के लिए एक मानक मॉड्यूल PHP में दिखाई देता है, तो इसे तुरंत ईज़ीवेब में बनाया जाएगा।

PHP PDO का उपयोग DBMS तक पहुंच के लिए API के रूप में किया जाता है, इसलिए, सैद्धांतिक रूप से, Easyweb 12 प्रकार के DBMS ( http://php.net/manual/ru/pdo.drivers.php ) का समर्थन करता है, और इसे आसानी से किसी अन्य DBMS के लिए भी अनुकूलित किया जा सकता है एक PDO ड्राइवर होने (बस DBMS नाम और उसके PDO ड्राइवर के लिए एक लिंक के साथ एक सुविधा अनुरोध सबमिट करें)। इसके अलावा, ईज़ीवेब आर्किटेक्चर आसानी से अन्य डीबीएमएस के लिए समर्थन को एम्बेड करने के लिए (इंजन का लेखक, जो है, मेरे लिए) अनुमति देता है, जिनके पास पीडीओ ड्राइवर नहीं है (उदाहरण के लिए, मोंगोडीबी), जो वास्तव में, भविष्य में किए जाने की योजना है।

प्रदर्शन पर कोई अकादमिक-विस्तृत परीक्षण नहीं किया गया है, इसलिए मैं केवल दृश्य टिप्पणियों, पिन किए गए समय मापन और अपाचे लॉग्स के विश्लेषण को htop पर एक समानांतर नज़र के साथ साझा कर सकता हूं। तो यहाँ है जो जाना जाता है:

गीथहब पर एक केस स्टडी से सबसे सरल अतिथि पुस्तक, एक संदेश फ़ीड वाला एक पृष्ठ एक सस्ती वीडीएस-के पर 0.005 - 0.01 सेकंड में उत्पन्न होता है। VDS का विन्यास, हालांकि, मज़बूती से अज्ञात है;
बुलेटिन बोर्ड की साइट। एक समर्पित इंटेल Xeon E3- स्तर सर्वर प्रति दिन खोज बॉट्स से ~ 10 मिलियन अनुरोधों को वापस लेता है, और htop द्वारा निर्णय लेते हुए, सर्वर में अभी भी कई बार मार्जिन है;
इंजन के पिछले संस्करण पर "बुलेटिन बोर्ड" प्रारूप की एक साइट और इंटेल i7 स्तर के एक समर्पित सर्वर ने एक बार आगंतुकों के तूफानी प्रवाह का सामना किया, 15 मिनट में लगभग 5,000 - 10,000 अद्वितीय उपयोगकर्ता। साइट में कोई मंदी नहीं थी। इसी समय, इंजन का वर्तमान संस्करण पिछले एक की तुलना में तेज है।

आगे की योजना और विचार

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

विभिन्न DBMS के लिए समर्थन जिसमें कोई PDO ड्राइवर नहीं है, जैसा कि कोई चाहता है;
नियमित रूप से पूर्ण एलएल (1) से पार्सिंग के कुछ हिस्सों का अनुवाद;
ORM प्रणाली या इसकी समानता;
पहलू खोज;
पूर्ण पाठ खोज;
क्लाइंट पर कुछ कार्यों के समाधान की सुविधा के लिए एक रूपरेखा (ग्राहक पक्ष पर AJAX या WebSockets, और शायद JSON-over-HTTP सर्वर साइड पर)।

संदर्भ

ईज़ीवेब रिपॉजिटरी: github.com/nyan-cat/easyweb
प्रलेखन: github.com/nyan-cat/easyweb/wiki
गेस्टबुक केस स्टडी: github.com/nyan-cat/easybook

आपका ध्यान देने के लिए धन्यवाद। टिप्पणियों में मैं आपके सवालों का जवाब दूंगा।

Easyweb - वेब के लिए XSLT इंजन