📸 🐱 👩🏽‍🔧 MODx के लिए एक सरल PHP अनुप्रयोग को फिर से बनाना 🖨️ 🕴🏾 🤲🏼

जेम्स रोटेरिंग द्वारा 02 सितंबर, 2011 को पोस्ट किया गया
PHP कौशल स्तर: मध्यम
MODx कौशल स्तर: शुरुआत

विवरण: यह मैनुअल दिखाता है कि MODx क्रांति के लिए मिश्रित PHP / HTML कोड वाली फ़ाइल को कैसे परिवर्तित किया जाए। यह उन लोगों के लिए है जो PHP के साथ काम करने में सहज हैं, लेकिन वे अभी भी MODx की मूल बातें सीख रहे हैं।

यदि आप निम्नलिखित विवरणों में से अधिकांश को फिट करते हैं, तो यह मार्गदर्शिका आपके लिए उपयोगी होनी चाहिए:
- आपने स्क्रिप्ट लिखी जो PHP कोड और HTML को जोड़ती है
- क्या आप PHP छोरों और सरणियों को समझते हैं
- आपने PHP कोड लिखा जो डेटाबेस से जुड़ता है और प्रविष्टियों को पुनर्प्राप्त करता है
- आपके पास एक सामान्य विचार है कि MODx स्निपेट और अन्य तत्व कैसे काम करते हैं

उदाहरण के लिए, मैं एक वास्तविक परियोजना के सरलीकृत संस्करण पर विचार करूंगा जिसे मैंने हाल ही में पूरा किया है।
आवेदन PHP / HTML में विकसित किया गया था और निम्नलिखित करता है:
- डेटाबेस तालिका से रिकॉर्ड की सूची प्राप्त करता है
- एक HTML तालिका में प्रविष्टियों को प्रदर्शित करता है
- विशिष्ट कॉलम मानों द्वारा परिणामों को फ़िल्टर करने के लिए दो ड्रॉप-डाउन चयन फ़ील्ड प्रदर्शित करता है।

यदि आप रुचि रखते हैं, तो आप यहां आवेदन देख सकते हैं।

हम एक मिश्रित PHP / HTML फ़ाइल से शुरू करते हैं

इस एप्लिकेशन का स्रोत कोड कुछ इस तरह से देखा गया (स्पष्टता के लिए सरलीकृत):

फ़ाइल: acctCodes.php (मूल संस्करण)

<html> <head> <title>    SFS</title> </head> <body> <h1>    SFS</title> <form> <!--  SELECT box --> <div> <label for="byCategory">  :</label> <select name="byCategory" id="byCategory"> <option> </option>

  <?php //   -     $values = //   -         foreach ($values as $value) { echo '<option value="' . $value . '">' . $value . '</option>'; } ?>

  </select> </div> <!--  SELECT box --> <div> <label for="byType">  :</label> <select name="byType" id="byType"> <option> </option>

  <?php $values = //   -         foreach ($values as $value) { echo '<option value="' . $value . '">' . $value . '</option>'; } ?>

  </select> </div> </form> <!--    --> <table id="acctCodes"> <thead> <!--  ,    <th>.    --> </thead> <tbody>

  <?php $records = //   -        foreach ($records as $record) { ?>

  <tr> <td><?php echo $record['category']; ?></td> <td><?php echo $record['status']; ?></td> <td><?php echo $record['account']; ?></td> <td><?php echo $record['acctType']; ?></td> <td><?php echo $record['title']; ?></td> <td><?php echo $record['definition']; ?></td> </tr>

  <?php } ?>

  </tbody> </table> </body> </html>

PHP यहाँ बहुत सरल है। कोड के तीन अलग-अलग ब्लॉक हैं जहां क्वेरी निष्पादित की जाती है, फिर परिणाम उपयुक्त HTML टैग में फ़्रेम किए जाते हैं और पृष्ठ पर प्रदर्शित होते हैं। तीसरा ब्लॉक कुछ हद तक विचित्र है - भारी कोड "इको" ऑपरेटरों के बजाय लूप के अंदर सामान्य HTML कोड का उपयोग करने के लिए PHP कोड बाधित है।
लेकिन यहां कुछ भी जटिल नहीं है।

हालाँकि, हमें MODx के संक्रमण की तैयारी के लिए कुछ सफाई करनी होगी।

भाग एक: सफाई (पहले हमें मूल्य मिलते हैं, और फिर आउटपुट)

MODx (और वास्तव में) के लिए इस PHP कोड को साफ करने का पहला कदम पेज लेआउट के साथ एप्लिकेशन लॉजिक को मिलाने से बचना है। उपयोग करने से पहले प्रत्येक अनुरोध को निष्पादित करने के बजाय, हम सभी अनुरोधों को शुरू करेंगे, और फिर, यदि आवश्यक हो, तो बस प्रतिध्वनि का उपयोग करके परिणाम प्रदर्शित करें।

परिणाम कुछ इस तरह है (फिर से, स्पष्टता के लिए बहुत सरल):

फ़ाइल: acctCodes.php (साफ किया गया संस्करण)

 <?php //   -     $values = //   -         $options1 = ''; foreach ($values as $value) { $options1 .= '<option value="' . $value . '">' . $value . '</option>'; } $values = //   -         $options2 = ''; foreach ($values as $value) { $options2 .= '<option value="' . $value . '">' . $value . '</option>'; } $records = //   -        $trrows = ''; foreach ($records as $record) { $trrows .= '<tr><td>' . $record['category'] . '</td><td>' . $record['status'] . '</td><td>' . $record['account'] . '</td><td>' . $record['acctType'] . '</td><td>' . $record['title'] . '</td><td>' . $record['definition'] . '</td></tr>'; } ?>

 <html> <head> <title>    SFS</title> </head> <body> <h1>    SFS</h1> <form> <!--  SELECT box --> <div> <label for="byCategory">  :</label> <select name="byCategory" id="byCategory"> <option> </option> <?php echo $options1; ?> </select> </div> <!--  SELECT box --> <div> <label for="byType">  :</label> <<font color="#006699">select name="byType" id="byType"> <option> </option> <?php echo $options2; ?> </select> </div> </form> <!--    --> <table id="acctCodes"> <thead> <!--  ,    <th>.    --> </thead> <tbody> <?php echo $trrows; ?> </tbody> </table> </body> </html>

यह मार्कअप को देखने और संपादित करने में बहुत आसान बनाता है। सभी PHP कोड चार ब्लॉकों में सम्‍मिलित हैं: पहला अनुरोध मान सेट करता है, और अगले तीन सरल इको कमांड इन मानों को प्रदर्शित करते हैं।
इस छोटे से वेब एप्लिकेशन को MODx में पोर्ट करना पहले से ही अधिक स्वीकार्य है।

भाग दो: स्निपेट और प्लेसहोल्डर

हमारे स्पष्ट कोड को MODx में स्थानांतरित करने के लिए, हमें कुछ अतिरिक्त परिवर्तन करने की आवश्यकता है।
हमारे HTML कोड को सीधे MODx संसाधन में कॉपी किया जा सकता है। (संसाधन अब नहीं बदलेगा! - लगभग प्रति)
लेकिन हमें PHP कोड को स्निपेट और कुछ प्लेसहोल्डर्स के साथ बदलने की आवश्यकता है।

हमारे MODx संसाधन की सामग्री इस तरह दिखाई देगी:
संसाधन MODx: 'acctCodes'

 [[accountCodes]] <html> <head> <title>    SFS</title> </head> <body> <h1>    SFS</h1> <form> <!--  SELECT box --> <div> <label for="byCategory">  :</label> <select name="byCategory" id="byCategory"> <option> </option> [[+options1]] </select> </div> <!--  SELECT box --> <div> <label for="byType">  :</label> <select name="byType" id="byType"> <option> </option> [[+options2]] </select> </div> </form> <!--    --> <table id="acctCodes"> <thead> <!--  ,    <th>.    --> </thead> <tbody> [[+trrows]] </tbody> </table> </body> </html>

हमारे संसाधन में, PHP कोड के चार ब्लॉक को MODx टैग से बदल दिया गया है। पहला, [[अकाउंटकोड]] , अकाउंटकोड स्निपेट (जिसे हमने अभी तक नहीं लिखा है) को कॉल करेगा। अगले तीन टैग प्लेसहोल्डर हैं, जिन्हें हमारे स्निपेट द्वारा निर्धारित मूल्यों से बदल दिया जाएगा।
अब हमें इस स्निपेट को लिखने की आवश्यकता है

भाग तीन: स्निपेट

हमारे "अकाउंटकोड" स्निपेट में PHP के इस पहले ब्लॉक से कोड होगा - सभी अनुरोध और लूप। केवल एक चीज जो हम जोड़ने जा रहे हैं वह है प्लेसहोल्डर्स बनाने के लिए मॉडेक्स एपीआई कोड की कुछ पंक्तियाँ।

स्निपेट: "अकाउंटकोड"

 <?php //   -     $values = //   -         $options1 = ''; foreach ($values as $value) { $options1 .='<option value="' . $value . '">' . $value . '</option>'; } $values = //   -         $options2 = ''; foreach ($values as $value) { $options2 .= '<option value="' . $value . '">' . $value . '</option>'; } $records = //   -        $trrows = ''; foreach ($records as $record) { $trrows .= '<tr><td>' . $record['category'] . &nbsp; '</td><td>' . $record['status'] . '</td><td>' . $record['account'] . '</td><td>' . $record['acctType'] . '</td><td>' . $record['title'] . '</td><td>' . $record['definition'] . '</td></tr>'; } $modx->setPlaceholder('options1', $options1); $modx->setPlaceholder('options2', $options2); $modx->setPlaceholder('trrows', $trrows);

यह हमारा स्निपेट है। हमारे मूल PHP कोड की तुलना में, नीचे की ओर "सेटप्लसहोल्डर" की तीन पंक्तियों के साथ पूरक है। वे केवल MODx को बताते हैं कि यदि और जब वह पृष्ठ पर नीचे एक प्लेसहोल्डर [[+ विकल्प 1]] का सामना करता है, तो उसे $ विकल्प 1 के मूल्य से बदलना चाहिए। प्लेसहोल्डर स्निपेट्स से आउटपुट मान को संभालने का एक सरल और सुरुचिपूर्ण तरीका है।

अब हमने MODx के अंदर काम करने के लिए वेब एप्लिकेशन की आवश्यकता के लिए सब कुछ किया है। हालाँकि, हम कुछ अतिरिक्त कदम उठा सकते हैं जो हमारे आवेदन को अधिक सेक्सियर बना देगा, MODx में अधिक एपीआई कार्यों का उपयोग करके। मैं हमारे वर्तमान कार्यान्वयन को "संतोषजनक" (मूल में, "सी" दर बताता हूं । चलो काम जारी रखें।

भाग चार: आउटपुट टेम्प्लेट के रूप में विखंडू का उपयोग करना

हमारे वर्तमान PHP कोड के लिए की जा सकने वाली आलोचनाओं में से एक यह है कि यह अभी भी तर्क के साथ मार्कअप को मिलाता है। हमारे 'फॉर्च्यूनर' लूप में अभी भी HTML मार्कअप का हिस्सा है:

 foreach ($values as $value) { $options1 .= '<option value="' . $value . '">' . $value . '/option>'; }

यह रणनीति आदर्श से बहुत दूर है: मान लीजिए कि बॉस स्किप्पी के HTML एनकोडर (मूल "Skippy HTML कोड बंदर" में - लगभग प्रति) पूछता है। प्रत्येक </ b> टैग के लिए कुछ अतिरिक्त विशेषताओं को जोड़कर इस एप्लिकेशन के HTML कोड को बदलने के लिए। लेकिन हम नहीं चाहते कि स्केपी HTML कोड बंदर हमारे PHP स्क्रिप्ट के पास कहीं हो, है ना?

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

ऊपर दिए गए स्निपेट से "विकल्प" कोड को "विकल्प" नामक एक चंक के रूप में फिर से लिखा जा सकता है:

चंक: "विकल्प"

 <option value="[[+value]]">[[+value]]</option>

इस chunk के बारे में कुछ खास नहीं है - प्लेसहोल्डर्स के एक जोड़े के साथ HTML का एक सा। "विकल्प" एक सरल, उपयोगी हिस्सा है जिसका उपयोग कहीं भी किया जा सकता है - विभिन्न संसाधनों में कई स्निपेट्स में।

अब हम अपने लूप में इस चंक के मूल्य का उपयोग करने के लिए थोड़ा और MODx API कोड जोड़कर अपने स्निपेट को बदल सकते हैं:

 <?php //   -     $values = //   -         $options1 = ''; foreach ($values as $value) { $modx->setPlaceholder('value', $value); $options1 .= $modx->getChunk('option'); }

अब हमारा लूप $ मूल्य के लिए एक प्लेसहोल्डर बनाता है और आउटपुट लाइन में 'विकल्प' के मूल्य को जोड़ता है।
यह आपको PHP से सभी HTML कोड को पूरी तरह से अलग करने की अनुमति देता है। यदि Skippy ("Skippy HTML कोड बंदर") को <विकल्प> तत्वों में एक विशेषता जोड़ने की आवश्यकता है, तो वह "विकल्प" चंक को संपादित करके ऐसा कर सकता है। (बस उसे बताएं कि इन प्लेसहोल्डर्स को न छूएं!)

तालिका पंक्तियों को उसी तरह से किया जा सकता है:
चंक: "चड्डी"

 <tr> <td>[[+category]]</td> <td>[[+status]]</td> <td>[[+account]]</td> <td>[[+acctType]]</td> <td>[[+title]]</td> <td>[[+definition]]</td> </tr>

और इसे कॉल करने के लिए php कोड

 each ($records as $record) { $trrows .= $modx->getChunk('trrows', $record); }

ध्यान दें कि इस उदाहरण में हमें किसी भी प्लेसहोल्डर को स्थापित नहीं करना है!
हम एक तर्क के रूप में GetChunk () में $ रिकॉर्ड साहचर्य सरणी पास कर सकते हैं, और प्लेसहोल्डर सरणी में प्रत्येक कुंजी / मान जोड़ी के लिए स्वचालित रूप से ** सेट हो जाएगा!
(** MODX Awesomeness! आप इसमें भिगो रहे हैं! **) (कुछ वाशिंग पाउडर के स्लोगन के साथ एक सादृश्य? - लगभग प्रति)।

तो अब हम अपने सभी HTML चंक्स को चंक्स में सेव कर सकते हैं और अपने स्निपेट को इस तरह से फिर से लिख सकते हैं:

 <?php //   -     $values = //   -         $options1 = ''; foreach ($values as $value) { $modx->setPlaceholder('value', $value); $options1 .= $modx->getChunk('option'); } $values = //   -         $options2 = ''; foreach ($values as $value) { $modx->setPlaceholder('value', $value); $options2 .= $modx->getChunk('option'); } $records = //   -        $trrows = ''; foreach ($records as $record) { $trrows .= $modx->getChunk('trrows', $record); } $modx->setPlaceholder('options1', $options1); $modx->setPlaceholder('options2', $options2); $modx->setPlaceholder('trrows', $trrows);

यह पहले से ही बहुत अच्छा लगने लगा है। हमने आउटपुट टेम्पलेट के लिए MODx API का उपयोग किया है और हमारा स्निपेट वास्तव में साफ दिखता है। फिर भी, एक बात है जो मुझे परेशान करती है, और संभावित रूप से समस्याग्रस्त हो सकती है - अब हमारे पास हमारे आवेदन के तर्क से जुड़ी मॉडेक्स एपीआई कॉल हैं। यदि हमें 100% यकीन है कि हमें केवल इस वेब पेज पर और इस प्रारूप में मुद्रित डेटा की आवश्यकता होगी, तो यह वास्तव में कोई समस्या नहीं है। लेकिन अगर एक मौका है कि इस डेटा को अलग-अलग उपयोग करने की आवश्यकता हो सकती है - कहीं न कहीं MODx के बाहर - मुख्य एप्लिकेशन लॉजिक को MODx संस्थाओं से अलग रखना बेहतर होगा।

फिलहाल, एप्लिकेशन को "अच्छा" (मूल में - "बी") रेट किया गया है। चलो अंतिम चरण लेते हैं और हमारी रेटिंग को "उत्कृष्ट" (मूल - "ए") में बढ़ाते हैं।

भाग पांच: अपने आवेदन तर्क को अलग करना

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

दूसरा भाग स्निपेट ही है। यह पहले तर्क फ़ाइल द्वारा लौटाया गया सरणी प्राप्त करेगा, फिर परिणाम लाइनों को मानकीकृत करने के लिए विखंडू का उपयोग करें, और अंत में संसाधनों में परिणाम प्रदर्शित करने के लिए प्लेसहोल्डर स्थापित करें।

यह इस तरह से समाप्त होता है:

फ़ाइल: acctCodes.php

 <?php //   -     $values = //   -         $values2 = //   -         $records = //   -        return array('values'=>$values, 'values2'=>$values2, 'records'=>$records); ?>

स्निपेट: 'एक्टकोड्स'

 <?php $data = include_once(MY_INCLUDE_PATH . 'acctCodes.php'); $options1 = ''; foreach ($data['values'] as $value) { $modx->setPlaceholder('value', $value); $options1 .= $modx->getChunk('option'); } $options2 = ''; foreach ($data['values2'] as $value) { $modx->setPlaceholder('value', $value); $options2 .= $modx->getChunk('option'); } $trrows = ''; foreach ($data['records'] as $record) { $trrows .= $modx->getChunk('trrows', $record); } $modx->setPlaceholder('options1', $options1); $modx->setPlaceholder('options2', $options2); $modx->setPlaceholder('trrows', $trrows);

अब हमारे पास एक पंक्ति में हमारे बतख हैं । आइए देखें कि हमने क्या किया:
- हमारे पास सर्वर पर एक फ़ाइल में एप्लिकेशन लॉजिक है (पूरी तरह से MODx के बाहर)।
- हम अपने MODx स्निपेट में सीधे (किसी HTML मार्कअप के बिना) डेटा ट्रांसफर करते हैं।
"हम अपने आउटपुट रिकॉर्ड के टेम्प्लेटिंग को MODx नियंत्रित करते हैं।"
- हम संसाधन के शीर्ष पर एक स्निपेट में सभी प्लेसहोल्डर मान सेट करते हैं।
- जहां आवश्यक हो, हम पृष्ठ पर प्लेसहोल्डर का उपयोग करके अपना डेटा प्रदर्शित करते हैं।

हम अपने मूल मिश्रित PHP / HTML फ़ाइल से एक लंबा सफर तय कर चुके हैं, है ना? मैं इस अंतिम कार्यान्वयन को "उत्कृष्ट" (मूल, "ए") में रेट करूंगा। हालांकि, किसी के पास बेहतर विचार है कि विभिन्न समस्या क्षेत्रों को कैसे अलग किया जाए। लेकिन मेरे जैसे PHP के लिए, यह एक अच्छी जगह है।

मुझे उम्मीद है कि MODx में उपयोग के लिए सरल PHP अनुप्रयोगों को लिखते समय आपने कुछ प्रमुख मुद्दों को सीखा है। इस गाइड के बारे में किसी भी विचार, सवाल या सुझाव को यहां टिप्पणियों में छोड़ने के लिए स्वतंत्र महसूस करें।

लगभग। प्रति। - परिणामस्वरूप परिणाम बनाए गए:
- संसाधन acctCodes (भाग 2)
- अकाउंटकोड स्निपेट (भाग 5)
- फ़ाइल acctCodes.php (भाग 5)
- विकल्प हिस्सा (भाग 4)
- ट्रंक चंक (भाग 4)

MODx के लिए एक सरल PHP अनुप्रयोग को फिर से बनाना

जेम्स रोटेरिंग द्वारा 02 सितंबर, 2011 को पोस्ट किया गयाPHP कौशल स्तर: मध्यमMODx कौशल स्तर: शुरुआत