Silex पर एक साधारण REST एप्लिकेशन बनाना

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

चलिए शुरू करते हैं

इस उदाहरण के लिए, मैं एक निर्देशिका का उपयोग करूंगा जिसका नाम है खिलौनों

Silex स्थापित करें

Silex को स्थापित करने के कई तरीके हैं, लेकिन इसके लिए Composer का उपयोग करें।
अपनी कार्यशील निर्देशिका के अंदर, कमांड चलाएँ:

 composer require silex/silex ~1.1 

इस कमांड के साथ, आपने कम्पोज़र कमांड को निम्न करने के लिए दिया:

• require परियोजना के लिए एक नया पैकेज जोड़ता है
• प्रारूप प्रदाता (विक्रेता) / पैकेज (पैकेज) में पैकेज का silex / silex नाम
• ~ 1.1 - पैकेज संस्करण, ~ 1.1 का अर्थ> = 1.1, <2.0 है

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

जैसे ही कमांड निष्पादन निष्पादित करता है, आपको निम्न फ़ाइल संरचना मिलेगी, जो नीचे दिखाया गया है:

 toyshop/ composer.json composer.lock vendor/ ... 

सभी Silex कोड विक्रेता फ़ोल्डर के अंदर संग्रहीत किए जाते हैं, और 2 संगीतकार फ़ाइलों में जानकारी होती है कि कौन से पैकेज और लाइब्रेरी संस्करण स्थापित हैं।

Composer.json

आइए संगीतकार.जॉन के अंदर देखें, इसे कुछ इस तरह देखना चाहिए:

 { "require": { "silex/silex": "~1.1" } } 

Composer.lock

इस फ़ाइल में सभी स्थापित पैकेजों की सूची है, साथ ही साथ उनके संस्करण भी हैं। यह बहुत उपयोगी है क्योंकि इसका मतलब है कि जब आप प्रोजेक्ट को रिपॉजिटरी में अपलोड करते हैं तो आपको vendor/ फोल्डर नहीं करना पड़ता है - एप्लिकेशन के सही ढंग से काम करने के लिए आवश्यक सभी लाइब्रेरी इस फाइल के आधार पर इंस्टॉल की जा सकती हैं। आपको बस composer.json और composer.lock फ़ाइलों को रिपॉजिटरी में अपलोड करने की आवश्यकता है और फिर, जैसे ही कोड रिपॉजिटरी से निकाला जाता है, आप बस composer install कमांड चला सकते हैं और Composer निर्दिष्ट संस्करणों के आवश्यक पुस्तकालयों Composer स्थापित Composer ।

मार्ग निर्माण

चूंकि हमारा आवेदन एक खिलौने की दुकान है, आइए हम इसके बारे में सोचते हैं कि हमें क्या चाहिए। जो लोग हमारी साइट पर जाएँगे, वे उपहार देखना चाहेंगे, तो चलिए एक मार्ग बनाते हैं जिससे आप उपहारों की सूची प्राप्त कर सकेंगे।

एक index.php फ़ाइल बनाते हैं। इसमें कोड जोड़ें ताकि यह इस तरह दिखे:

 <?php require_once __DIR__.'/vendor/autoload.php'; $app = new Silex\Application(); // Please set to false in a production environment $app['debug'] = true; $toys = array( '00001'=> array( 'name' => 'Racing Car', 'quantity' => '53', 'description' => '...', 'image' => 'racing_car.jpg', ), '00002' => array( 'name' => 'Raspberry Pi', 'quantity' => '13', 'description' => '...', 'image' => 'raspberry_pi.jpg', ), ); $app->get('/', function() use ($toys) { return json_encode($toys); }); $app->get('/{stockcode}', function (Silex\Application $app, $stockcode) use ($toys) { if (!isset($toys[$stockcode])) { $app->abort(404, "Stockcode {$stockcode} does not exist."); } return json_encode($toys[$stockcode]); }); $app->run(); 

अब हमारे पास 2 मार्ग घोषित हैं: / और /{stockcode}

मार्ग /

यह सभी खिलौनों की सूची प्राप्त करने का मार्ग है। यह सब विधि जो करता है वह JSON में दिए गए एक को एनकोड करता है और अनुरोध के जवाब के रूप में एन्कोडेड डेटा को वापस करता है।

$toys सरणी के लिए एक अनाम फ़ंक्शन का उपयोग करने की अनुमति देने के लिए, हमें अनाम फ़ंक्शन परिभाषा के अंत में use($toys) जोड़कर इसे आयात करना होगा, लेकिन {खोलने से पहले।

रूट /{stockcode}

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

use($toys) हम स्वयं फ़ंक्शन के लिए कुछ चर पास करते हैं: Silex\Application $app $stockcode.

Silex\Application $app एक Silex एप्लिकेशन ऑब्जेक्ट है और इसकी मदद से हम एक सुंदर 404 त्रुटि पृष्ठ प्रदर्शित कर सकते हैं यदि गलत स्टॉककोड पारित किया गया था।

$stockcode खिलौने का पहचानकर्ता है जिसकी जानकारी हम प्राप्त करना चाहते हैं। जैसा कि आप देख सकते हैं, यह चर {स्टॉककोड} से मेल खाता है, जो हमारे द्वारा वर्णित मार्ग में है।

आवेदन का परीक्षण

Index.php के माध्यम से सभी अनुरोधों को रूट करने के लिए वेब सर्वर स्थापित करने के बाद, आप उपयोग करने वाले मार्गों पर जा सकते हैं toyshop toyshop/00001 toyshop toyshop/00001 और परिणाम देखें कि इनमें से प्रत्येक क्वेरी वापस आ जाएगी।

उदाहरण के लिए toyshop/00001 toyshop/00001 वापस आ जाएगी:

 {"name":"Raspberry Pi","quantity":"13","description":"...","image":"raspberry_pi.jpg"} 

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

Silex क्यों?

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

अनुवादक से नोट्स

मैं यह जोड़ना चाहूंगा कि Silex में काम करना आसान है और अन्य प्रकार के HTTP अनुरोधों के साथ, जैसे PUT, POST, DELETE (नीचे उदाहरण)

 $app->post('/toys', function (Silex\Application $app) use ($toys) { //... }); $app->put('/{stockcode}', function (Silex\Application $app, $stockcode) use ($toys) { //... }); $app->delete('/{stockcode}', function (Silex\Application $app, $stockcode) use ($toys) { //... }); 

इस प्रकार, आप एक पूर्ण REST अनुप्रयोग बना सकते हैं।