🏐 👨‍🎤 🤷🏽 फाल्कन: आइए उदाहरण के द्वारा जानें 🍼 👨🏻‍🔧 👊🏼

हाल ही में , सी में लिखे गए PHP MVC फ्रेमवर्क का उल्लेख हब पर किया गया था , इसके फायदे और नुकसान का वर्णन किया गया था। इस लेख के साथ मैं एक वेब डेवलपर के एक दिलचस्प उपकरण के साथ परिचित जारी रखना चाहता हूं - फाल्कोनपीपी ।

यह लेख मूल पाठ का एक नि: शुल्क अनुवाद है, जो एक सरल पंजीकरण फॉर्म के साथ एक एप्लिकेशन बनाने की प्रक्रिया पर विचार करेगा, साथ ही साथ फ्रेमवर्क के व्यवहार के मुख्य पहलुओं की व्याख्या करेगा।

इस गाइड का उपयोग करने का सबसे अच्छा तरीका यह है कि आप इसे चरण दर चरण देखें।

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

फाल्कन PHP स्थापित करना काफी तुच्छ है, यह सब एक PHP एक्सटेंशन स्थापित करने के लिए नीचे आता है, जिसे आधिकारिक साइट से डाउनलोड किया जा सकता है।

फाल्कन PHP को स्थापित करने के बाद, phpinfo () के आउटपुट में "फाल्कन" अनुभाग की उपस्थिति की जांच करें या नीचे दिए गए कोड स्निपेट को चलाएं:

<?php print_r(get_loaded_extensions());

अन्य एक्सटेंशन के बीच आपको फाल्कन देखना चाहिए:

 Array ( [0] => Core [1] => libxml [2] => filter [3] => SPL [4] => standard [5] => phalcon [6] => pdo_mysql )

निर्देशिका संरचना

फाल्कन को किसी विशिष्ट परियोजना पदानुक्रम के उपयोग की आवश्यकता नहीं है, एक एप्लिकेशन विकसित करने के लिए आप उस संरचना का उपयोग कर सकते हैं जिसके साथ आप काम करने के लिए उपयोग किए जाते हैं।

एक उदाहरण के लिए, इस पाठ में हम निम्नलिखित संरचना का उपयोग करेंगे:

 ट्यूटोरियल /
   ऐप /
     नियंत्रक /
     मॉडल /
     विचार /
   सार्वजनिक /
     सीएसएस /
     img /
     js /

ध्यान दें कि ढांचे की मेजबानी के लिए आपको "लाइब्रेरी" जैसी निर्देशिका की आवश्यकता नहीं है; फाल्कन पहले से ही मेमोरी से एक्सेस करने और उपयोग करने के लिए तैयार है।

सुंदर यूआरएल

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

यह उदाहरण Apache के लिए mod_rewrite का उपयोग करता है और, हमारी निर्देशिका संरचना के आधार पर, हमें दो .htaccess फ़ाइलों की आवश्यकता होती है: एक परियोजना की जड़ में, दूसरा सार्वजनिक निर्देशिका में।

 #/.htaccess <IfModule mod_rewrite.c> RewriteEngine on RewriteRule ^$ public/ [L] RewriteRule (.*) public/$1 [L] </IfModule>

आवेदन के सभी अनुरोध public/ निर्देशिका को भेजे जाएंगे। यह कदम सुनिश्चित करता है कि सुरक्षा जोखिम को कम करते हुए, परियोजना के आंतरिक फ़ोल्डर सार्वजनिक पहुंच से छिपे रहे।

यदि आवश्यक फ़ाइल मौजूद है, तो नियमों का दूसरा सेट जांचता है। यदि फ़ाइल गायब है, तो वेब सर्वर अनुरोध को फ्रेमवर्क के लिए आवश्यक रूप में परिवर्तित करता है।

 #/public/.htaccess <IfModule mod_rewrite.c> RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php?_url=/$1 [QSA,L] </IfModule>

अनुवादक का नोट: सुरक्षा और प्रदर्शन दोनों के दृष्टिकोण से, यह public_html से परे एप्लिकेशन को स्थानांतरित करने के लिए अधिक कुशल होगा, केवल चित्र, js और css उपलब्ध छोड़कर। लेकिन आइए उदाहरण से विचलित न हों।

बूटस्ट्रैपिंग (बूटस्ट्रैप)

बनाने के लिए पहली फ़ाइल इनिशियलाइज़ेशन स्क्रिप्ट है। यह फ़ाइल घटक इनिशियलाइज़ेशन को लागू करती है; यह एप्लिकेशन के आधार के रूप में कार्य करती है, जो उसके सभी व्यवहार पर नियंत्रण प्रदान करती है।

बूटस्ट्रैप फ़ाइल public/index.php इस तरह दिखता है:

 <?php try { //Register an autoloader $loader = new \Phalcon\Loader(); $loader->registerDirs(array( '../app/controllers/', '../app/models/' ))->register(); //Create a DI $di = new Phalcon\DI\FactoryDefault(); //Setting up the view component $di->set('view', function(){ $view = new \Phalcon\Mvc\View(); $view->setViewsDir('../app/views/'); return $view; }); //Handle the request $application = new \Phalcon\Mvc\Application(); $application->setDI($di); echo $application->handle()->getContent(); } catch(\Phalcon\Exception $e) { echo "PhalconException: ", $e->getMessage(); }

नीचे हम इस फ़ाइल के प्रत्येक भाग का अधिक विस्तार से विश्लेषण करेंगे।

autoloader

आरंभीकरण फ़ाइल का पहला भाग ऑटोलैडर पंजीकरण है। इसका उपयोग नियंत्रकों और मॉडलों को लोड करने के लिए किया जाता है। उदाहरण के लिए, हम नियंत्रकों की एक या अधिक निर्देशिकाओं को पंजीकृत कर सकते हैं, जिससे अनुप्रयोग का लचीलापन बढ़ जाता है। हमारे उदाहरण में, Phalcon\Loader घटक का उपयोग किया गया था।

इसका उपयोग विभिन्न दृष्टिकोणों का उपयोग करके कक्षाएं लोड करने के लिए किया जा सकता है, लेकिन इस उदाहरण में हमने पूर्वनिर्धारित निर्देशिकाओं के आधार पर कक्षाओं का पता लगाने के लिए चुना।

 <?php $loader = new \Phalcon\Loader(); $loader->registerDirs( array( '../app/controllers/', '../app/models/' ) )->register();

निर्भरता प्रबंधन

फाल्कन फ्रेमवर्क के साथ काम करते समय, आपको निर्भरता इंजेक्शन ( विकी ) की अवधारणा को समझने की आवश्यकता है। यह जटिल लग सकता है, लेकिन वास्तव में, सब कुछ बहुत सरल और व्यावहारिक है।

फाल्कन में एक तंत्र होता है जो अनुप्रयोग के काम करने के लिए आवश्यक घटकों को संग्रहीत करता है, और फ्रेमवर्क के अनुरोध पर उन्हें एक्सेस प्रदान करता है। यह तंत्र Phalcon\DI वर्ग है, जो अपने संयुक्त कार्य के लिए विभिन्न घटकों के संयोजन के रूप में एक कड़ी के रूप में कार्य करता है।

 <?php //Create a DI $di = new Phalcon\DI\FactoryDefault();

फाल्कन \ DI \ FactoryDefault, फाल्कन \ DI का वंशज है Phalcon\DI निर्भरता इंजेक्शन को लागू करता है। यह फ्रेमवर्क के अधिकांश मानक घटकों को पंजीकृत करता है। इसलिए, हमें उन्हें एक-एक करके पंजीकृत नहीं करना चाहिए। यदि आवश्यक हो, तो आप इसे आसानी से अपने स्वयं के कार्यान्वयन से बदल सकते हैं।

अगला चरण "दृश्य" घटक को पंजीकृत करना है। चूँकि दृश्य फ़ाइलें वर्ग नहीं हैं, उन्हें ऑटोलैडर का उपयोग करके लोड नहीं किया जा सकता है, इसलिए हमें उनका स्थान निर्दिष्ट करना चाहिए।

 <?php //Setting up the view component $di->set('view', function(){ $view = new \Phalcon\Mvc\View(); $view->setViewsDir('../app/views/'); return $view; });

इस फ़ाइल का अंतिम भाग घटक फाल्कन \ Mvc \ Application को पंजीकृत करता है। इसका उद्देश्य अनुरोध पर्यावरण को प्रारंभ करना, मार्ग की प्रक्रिया करना और अनुरोध के अनुरूप कार्रवाई करना है। यह नियंत्रक से प्रतिक्रिया प्राप्त करता है और प्रक्रिया पूरी होने पर उसे वापस कर देता है।

 <?php $application = new \Phalcon\Mvc\Application(); $application->setDI($di); echo $application->handle()->getContent();

जैसा कि आप देख सकते हैं, इनिशियलाइज़ेशन फ़ाइल काफी सरल है और हमें किसी अतिरिक्त फ़ाइल को कनेक्ट करने की आवश्यकता नहीं है। हमने कोड के 30 से कम लाइनों में एक लचीले एमवीसी एप्लिकेशन के लिए चरण निर्धारित किया है।

नियंत्रक

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

 <?php class IndexController extends \Phalcon\Mvc\Controller { public function indexAction() { echo "<h1>Hello!</h1>"; } }

नियंत्रक वर्ग का प्रत्यय "नियंत्रक" है, और इसकी क्रिया का प्रत्यय "क्रिया" होना चाहिए। यदि आप किसी ब्राउज़र में एप्लिकेशन खोलते हैं, तो आपको कुछ इस तरह दिखाई देगा:

बधाई हो, आप एक बाज़ के साथ उड़ रहे हैं! (अनुवादक का नोट: फाल्कन अंग्रेजी फाल्कन - बाज़ * के साथ व्यंजन है)

प्रतिनिधित्व (देखें)

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

हमारे मामले में, यह app/views/index/index.phtml :

 <?php echo "<h1>Hello!</h1>";

और नियंत्रक स्वयं ( app/controllers/IndexController.php ) में अब एक खाली कार्रवाई शामिल है:

 <?php class IndexController extends \Phalcon\Mvc\Controller { public function indexAction() { } }

कार्रवाई पूरी होने के बाद दृश्य स्वचालित रूप से संसाधित होता है। ब्राउज़र में आउटपुट समान रहना चाहिए।

पंजीकरण फार्म

इसमें अन्य "साइनअप" कंट्रोलर के लिंक को जोड़कर व्यू app/views/index/index.phtml को बदलें:

 <?php echo "<h1>Hello!</h1>"; echo Phalcon\Tag::linkTo("signup", "Sign Up Here!");

उत्पन्न HTML नए नियंत्रक के लिंक के साथ <a> टैग प्रदर्शित करेगा:

 <h1>Hello!</h1> <a href="/test/signup">Sign Up Here!</a>

लिंक उत्पन्न करने के लिए, फाल्कन \ टैग वर्ग का उपयोग किया गया था। यह सहायक वर्ग आपको फ्रेमवर्क मानक के अनुसार HTML बनाने की अनुमति देता है। यहां आप HTML कोड की पीढ़ी का अधिक विस्तृत विवरण पा सकते हैं।

यह नया "साइनअप" कंट्रोलर ( app/controllers/SignupController.php ) जैसा दिखता है:

 <?php class SignupController extends \Phalcon\Mvc\Controller { public function indexAction() { } }

खाली क्रिया "indexAction" प्रपत्र ( app/views/signup/index.phtml ) के साथ दृश्य पर सीधे निर्देशित करता है।

 <?php use Phalcon\Tag; ?> <h2>Sign using this form</h2> <?php echo Tag::form("signup/register"); ?> <p> <label for="name">Name</label> <?php echo Tag::textField("name") ?> </p> <p> <label for="name">E-Mail</label> <?php echo Tag::textField("email") ?> </p> <p> <?php echo Tag::submitButton("Register") ?> </p> </form>

इस नियंत्रक को ब्राउज़र में खोलने पर आपको कुछ इस तरह दिखाई देगा:

Phalcon\Tag फार्म तत्वों को बनाने के लिए उपयोगी तरीके प्रदान करता है।
Phalcon\Tag::form विधि में, हमने आवेदन की नियंत्रक / कार्रवाई के लिए पथ पारित किया जो फॉर्म को संसाधित करेगा।

"रजिस्टर" बटन पर क्लिक करके आप "साइनअप" नियंत्रक में "रजिस्टर" कार्रवाई की अनुपस्थिति का संकेत देते हुए, फ्रेमवर्क से फेंका गया एक अपवाद देखेंगे।

PhalconException: एक्शन "रजिस्टर" कंट्रोलर "साइनअप" पर नहीं मिला

इस क्रिया को कार्यान्वित करने से, हमें अपवाद से छुटकारा मिल जाएगा:

 <?php class SignupController extends \Phalcon\Mvc\Controller { public function indexAction() { } public function registerAction() { } }

फॉर्म भेजने के बाद आपको एक खाली पेज दिखाई देगा।

उपयोगकर्ता नाम और ईमेल दर्ज डेटाबेस में संग्रहीत किया जाना चाहिए। एमवीसी के सिद्धांतों के अनुसार, स्वच्छ वस्तु-उन्मुख कोड प्रदान करने के लिए डेटाबेस के साथ सहभागिता को अनुप्रयोग मॉडल द्वारा किया जाना चाहिए।

आदर्श

फाल्कन पीएचपी के लिए पहला ओआरएम लाता है, पूरी तरह से सी में लिखा गया है। विकास की जटिलता को बढ़ाने के बजाय, यह इसे सरल बनाता है।

अपना पहला मॉडल बनाने से पहले, हमें डेटाबेस में एक टेबल रखना होगा। पंजीकृत उपयोगकर्ताओं को संग्रहीत करने के लिए एक सरल तालिका इस तरह दिख सकती है:

 CREATE TABLE `users` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(70) NOT NULL, `email` varchar(70) NOT NULL, PRIMARY KEY (`id`) );

मॉडल को app/models निर्देशिका में स्थित होना चाहिए।
यह एक मॉडल की तरह दिखेगा जो users तालिका तक पहुंच प्रदान करता है:

 <?php class Users extends \Phalcon\Mvc\Model { }

DB कनेक्शन

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

विस्तारित बूटस्ट्रैप फ़ाइल (सार्वजनिक / index.php) इस तरह दिखाई देगी:

 <?php try { //Register an autoloader $loader = new \Phalcon\Loader(); $loader->registerDirs(array( '../app/controllers/', '../app/models/' ))->register(); //Create a DI $di = new Phalcon\DI\FactoryDefault(); //Set the database service $di->set('db', function(){ return new \Phalcon\Db\Adapter\Pdo\Mysql(array( "host" => "localhost", "username" => "root", "password" => "secret", "dbname" => "test_db" )); }); //Setting up the view component $di->set('view', function(){ $view = new \Phalcon\Mvc\View(); $view->setViewsDir('../app/views/'); return $view; }); //Handle the request $application = new \Phalcon\Mvc\Application(); $application->setDI($di); echo $application->handle()->getContent(); } catch(\Phalcon\Exception $e) { echo "PhalconException: ", $e->getMessage(); }

अब हमारे मॉडल बाकी एप्लिकेशन के साथ काम करने और बातचीत करने के लिए तैयार हैं।

एक मॉडल का उपयोग कर डेटा की बचत

हमारा अगला चरण: फॉर्म से डेटा प्राप्त करना और इसे तालिका में लिखना।
आइए कार्रवाई "रजिस्टर" जोड़ें:

 <?php class SignupController extends \Phalcon\Mvc\Controller { public function indexAction() { } public function registerAction() { //Request variables from html form $name = $this->request->getPost("name", "string"); $email = $this->request->getPost("email", "email"); $user = new Users(); $user->name = $name; $user->email = $email; //Store and check for errors if ($user->save()) { echo "Thanks for register!"; } else { echo "Sorry, the following problems were generated: "; foreach ($user->getMessages() as $message) { echo $message->getMessage(), "<br/>"; } } } }

आप कभी भी उपयोगकर्ता से प्राप्त डेटा पर भरोसा नहीं कर सकते। हमारे आवेदन में हस्तांतरित डेटा को सत्यापन / फ़िल्टरिंग पास करना होगा। यह एप्लिकेशन को SQL इंजेक्शन के समान हमलों से अधिक संरक्षित करेगा।

हमारे आवेदन में, हम दर्ज नाम के लिए " string " फ़िल्टर लागू करते हैं और ईमेल पते पर " email " फ़िल्टर यह सुनिश्चित करने के लिए करते हैं कि उपयोगकर्ता ने हमें कोई दुर्भावनापूर्ण वर्ण नहीं भेजा है।

फाल्कन \ फ़िल्टर घटक इस कार्य को प्राथमिक बनाता है, क्योंकि यह निर्भरता कंटेनर से गेटपोस्ट विधि कॉल में एम्बेडेड है।

अगला, हम Users मॉडल का एक उदाहरण बनाते हैं। मॉडल के सार्वजनिक गुण users तालिका में फ़ील्ड के अनुरूप हैं। नए मॉडल के मूल्यों को सेट करके और save() विधि को कॉल करके, हम डेटाबेस को लिखते हैं। save() विधि एक बूलियन देता है जो हमें सूचित करता है कि रिकॉर्डिंग सफल रही या नहीं।

अतिरिक्त सत्यापन स्वचालित रूप से उन फ़ील्ड्स के लिए होता है जिन्हें not null (यानी, आवश्यक हैं)। यदि आप फ़ॉर्म सबमिट करते समय फ़ील्ड खाली छोड़ देते हैं, तो ब्राउज़र में आपको एक संदेश दिखाई देगा:

क्षमा करें, निम्नलिखित समस्याएं उत्पन्न हुईं: नाम की आवश्यकता है
ईमेल आवश्यक है

निष्कर्ष

यह बहुत ही सरल सबक यह दिखाने के लिए है कि फाल्कन PHP फ्रेमवर्क पर अपने एप्लिकेशन को विकसित करना शुरू करना कितना आसान है। यह तथ्य कि फाल्कन सी में लिखा PHP का विस्तार है, विकास की सादगी का खंडन नहीं करता है।

मैं आपको मैनुअल का अध्ययन करना जारी रखने के लिए आमंत्रित करता हूं, जो आपके लिए फाल्कन द्वारा पेश किए गए अतिरिक्त अवसरों को खोलेगा!

___
* बाज़ दुनिया में सबसे तेज़ पक्षी है, और आम तौर पर एक जीवित प्राणी है। लेकिन, निष्पक्षता में, यह ध्यान देने योग्य है कि क्षैतिज उड़ान की गति में बाज़ तेजी से नीचा है।

फाल्कन: आइए उदाहरण के द्वारा जानें