🛀🏽 ⛴️ 🚭 Google क्लाउड मैसेजिंग - PHP में बैकएंड लिखना ㊙️ 🚃 ♥️

ट्यूटोरियल के भाग के रूप में, हम GCM सर्वर पर संदेश भेजने के लिए एक पूर्ण-वर्ग लिखेंगे, जो:

भेजने के लिए एक इनपुट डेटा सरणी प्राप्त करता है
प्रत्येक के लिए 4096kb भेजने के लिए पैकेज बनाता है।
समानांतर अनुरोधों में पैकेट भेजता है।
जवाब देता है और जानता है:
- क्या संदेश सफलतापूर्वक वितरित किया गया था
- त्रुटि का प्रकार

Google क्लाउड मैसेजिंग - लघु और स्पष्ट

जीसीएम एक त्वरित संदेश सेवा है। मानक मतदान और लंबे मतदान के लिए एक विकल्प, लेकिन अनन्य नहीं, लेकिन उन्हें पूरक। Google यह गारंटी नहीं देता है कि संदेश वितरित किया जाएगा (हालांकि वितरण की विश्वसनीयता और गति CDMDM के पूर्वजों की तुलना में बस स्थान बन गई है)। यदि फोन पर इंटरनेट बंद है, तो संदेश 4 सप्ताह तक GCM सर्वर पर संग्रहीत किया जाएगा। यही है, अगर उपयोगकर्ता फोन बंद कर देता है, छुट्टी पर जाता है, तो आगमन पर, उसे अब संदेश नहीं मिल सकता है। इसलिए, GCM को केवल विश्वसनीय वितरण विधियों जैसे उदाहरण के लिए, प्राथमिक मतदान - सर्वर से प्रत्येक N मिनट में HTTP अनुरोध भेजना चाहिए।

कोई भी Android एप्लिकेशन GCM के संदेशों के प्राप्तकर्ता के रूप में खुद को पंजीकृत कर सकता है। इंटरनेट चालू होने के साथ, कुछ ही सेकंड में पंजीकरण हो जाता है। जैसे ही ऐसा होता है, आवेदन GCM सर्वर से RegistrationId प्राप्त करता है, जिसे इसके सर्वर पर भेजा जाना चाहिए। नतीजतन, सर्वर डेटाबेस में, हमारे पास, उदाहरण के लिए, एक डिवाइस तालिका जो उपकरणों के बारे में जानकारी संग्रहीत करती है, जिसमें उनका RegistrationId भी शामिल है।

संदेश प्राप्त करना शुरू करने के लिए उपकरणों के लिए, सर्वर कोड को जीसीएम सर्वर में जॉन्स प्रारूप में POST अनुरोध भेजना चाहिए (आप सामान्य कुंजी => मान भी भेज सकते हैं, लेकिन json अनुशंसित है)। सर्वर रिस्पॉन्स में json भी होता है, जिसका विश्लेषण करके हम समझ सकते हैं कि क्या संदेश दिया गया है, और यदि नहीं, तो क्या त्रुटियां हुई हैं।

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

चलो दो कक्षाएं GcmPayload और GcmSender बनाएं।

लिस्टिंग

class GcmPayload { public function __construct($regId, $jsons) {} public $regId; public $jsons; } class GcmSender { public function __construct($payloads) {} public function send() {} protected function getPackages() {} protected function isReadyToFlush($items, $json) {} public function onResponse($response, $info, RollingCurlRequest $request) {} }

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

GcmPayload - एक प्राप्तकर्ता के लिए डेटा मॉडल और, तदनुसार, एक RegistrationId। $ Jsons फ़ील्ड को इस प्राप्तकर्ता को भेजे जाने वाले डेटा वाले स्ट्रिंग्स के रूप में json'ov की एक सरणी के साथ आरंभीकृत किया जाना चाहिए। ट्यूटोरियल को सरल बनाने के लिए, हम मानते हैं कि यह हमारी कक्षा के बाहर किया गया है, उदाहरण के लिए, इस तरह:

लिस्टिंग

 $recipients = $messagesRepository->getRecipientsWithNewMessages(); $payloads = array(); foreach ($recipients as $recipient) { $jsons = array(); foreach ($recipient->messages as $message) { $jsons[] = json_encode($message); } $payloads[] = new GcmPayload($recipient['regId'], $jsons); } $gcm = new GcmSender(); $gcm->send($payloads);

GcmSender

लगातार और वर्ग के सदस्य

const GCM_API_KEY = 'आपकी एपी कुंजी'; // Google API कॉन्सोल पृष्ठ पर प्राप्त करने की आवश्यकता है
const CURL_TIMEOUT = 10; // Google सर्वर सेकंड में
const GCM_MAX_DATA_SIZE = 4096; // भेजे गए डेटा को बाइट्स में सीमित करें
const GCM_SERVER_URL = 'https://android.googleapis.com/gcm/send'; // GCM सर्वर का पता
const GCM_MAX_CONNECTIONS = 10; // समवर्ती अनुरोधों की संख्या

const KEY_REG_IDS = 'registration_ids'; // json अनुरोध में प्राप्तकर्ता कुंजी
const KEY_DATA = 'डेटा'; // json अनुरोध में डेटा कुंजी
const KEY_ITEMS = 'आइटम'; // डेटा ऑब्जेक्ट में हमारी डेटा सरणी वाली कुंजी
const REGID_PLACEHOLDER = '_REGID_'; // प्लेसहोल्डर पंजीकरण के लिए json अनुरोध टेम्पलेट में
const ITEMS_PLACEHOLDER = '_ITEMS_'; // json अनुरोध टेम्पलेट में हमारे डेटा की सरणी के लिए प्लेसहोल्डर

const GCM_ERROR_NOTRcture = 'NotRegistered'; // त्रुटि के लिए निरंतर यदि उपयोगकर्ता ने एप्लिकेशन को अनइंस्टॉल किया

संरक्षित $ _template; // json अनुरोध टेम्पलेट
संरक्षित $ _baseDataSize; // प्रारंभिक डेटा आकार, जिसमें आइटम कुंजी, कोष्ठक उद्धरण चिह्न आदि शामिल हैं।

डिजाइनर

निर्माता एक अनुरोध टेम्पलेट बनाता है जिसका उपयोग गेटपेकेज विधि में किया जाएगा। कृपया ध्यान दें कि संभावित रूप से प्रति डेटा 4096 बाइट्स की सीमा से अधिक नहीं होने के लिए, आपको टेम्प्लेट में प्रारंभिक डेटा के आकार को भी याद रखना और लेना होगा: {"आइटम": []}

लिस्टिंग

 public function __construct() { $dataObj = '{"'.self::KEY_ITEMS.'": ['.self::ITEMS_PLACEHOLDER.']}'; $this->_template = '{ "'.self::KEY_REG_IDS.'": ["'.self::REGID_PLACEHOLDER.'"], "'.self::KEY_DATA.'": '.$dataObj.' }'; $baseDataJson = str_replace(self::ITEMS_PLACEHOLDER, '', $dataObj); $this->_baseDataSize = strlen($baseDataJson); }

विधि भेजें

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

लिस्टिंग

 /** * @param GcmPayload[] $payloads */ public function send($payloads) { $packages = self::getPackages($payloads); if (!$packages || count($packages) == 0) return; $rc = new RollingCurl(array($this, 'onResponse')); $headers = array('Authorization: key='.self::GCM_API_KEY, 'Content-Type: application/json'); $rc->__set('headers', $headers); $rc->options = array( CURLOPT_SSL_VERIFYPEER => false, //   CURLOPT_RETURNTRANSFER => true, //,        CURLOPT_CONNECTTIMEOUT => self::CURL_TIMEOUT, //      CURLOPT_TIMEOUT => self::CURL_TIMEOUT); //     curl foreach ($packages as $package) { $rc->request(self::GCM_SERVER_URL, 'POST', $package); } $rc->execute(self::GCM_MAX_CONNECTIONS); }

GetPackages विधि

इस पद्धति में, क्लास को पास किए गए पेलोड की एक सरणी को सॉर्ट किया जाता है और कंस्ट्रक्टर में बनाया गया टेम्प्लेट धीरे-धीरे भरा जाता है, जब तक कि पैकेट 4096 बाइट्स की सीमा से अधिक न हो जाए या प्राप्तकर्ता का डेटा समाप्त न हो जाए। वैसे, हमारे उदाहरण में, हम मानते हैं कि एक पैकेट एक प्राप्तकर्ता है। इसका क्या मतलब है? उदाहरण के लिए, इस तरह का सम्मेलन सच है जब एक पाठ संदेश केवल एक व्यक्ति को संबोधित किया जाता है। लेकिन समूह वार्तालापों में, एक ही संदेश कई लोगों को भेजा जा सकता है, और GCM इसे Registration_ids कुंजी के मान में कई RegistrationId निर्दिष्ट करके अनुमति देता है। लेकिन फिर, इस उदाहरण में, अनावश्यक जटिलताओं से बचने के लिए, इस मामले पर विचार नहीं किया जाता है।

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

लिस्टिंग

 /** * @param GcmPayload[] $payloads * @return string[] */ protected function getPackages($payloads) { $packages = array(); foreach($payloads as $payload) { $template = str_replace(self::REGID_PLACEHOLDER, $payload->regId, $this->_template); $items = ''; foreach($payload->jsons as $json) { if ($this->isReadyToFlush($items, $json)) { $package = str_replace(self::ITEMS_PLACEHOLDER, $items, $template); $packages[] = $package; $items = ''; } if ($items) $items .= ','.$json; else $items = $json; } if ($items) { //        $package = str_replace(self::ITEMS_PLACEHOLDER, $items, $template); $packages[] = $package; } } return $packages; }

OnResponse विधि

यह न केवल संदेश भेजने के लिए महत्वपूर्ण है, बल्कि यह समझने के लिए भी है कि क्या वितरित किया गया है, और यदि नहीं, तो किस कारण से। onResponse वह कॉलबैक है जिसके साथ हमने रोलिंग विधि में RollingCurl को इनिशियलाइज़ किया। कोल्बेक तीन मापदंडों को स्वीकार करता है:

$ प्रतिक्रिया - स्ट्रिंग प्रतिक्रिया
$ जानकारी curl_getinfo फ़ंक्शन का परिणाम है php.net/manual/en/function.curl-getinfo.php और डेटा ट्रांसफर डेटा के साथ एक सरणी देता है, प्रतिक्रिया http कोड से शुरू होता है और अपलोड / डाउनलोड गति के साथ समाप्त होता है। लेकिन इस ट्यूटोरियल में, केवल http प्रतिक्रिया कोड दिलचस्प है।
RollingCurlRequest $ अनुरोध - जानकारी का अनुरोध करें। हम $ अनुरोध में रुचि रखते हैं-> post_data

फ़ंक्शन सूची में टिप्पणियाँ अधिक स्पष्ट होंगी:

लिस्टिंग

 /** * @param string $response * @param array $info * @param \RollingCurl\RollingCurlRequest $request */ public function onResponse($response, $info, RollingCurlRequest $request) { //       $success = true; // json,     post $post = json_decode($request->post_data, true); if (json_last_error() != JSON_ERROR_NONE) { // json ,     . return; } // RegistratonId     $regId = $post[self::KEY_REG_IDS][0]; $items = $post[self::KEY_DATA][self::KEY_ITEMS]; //   $code = $info != null && isset($info['http_code']) ? $info['http_code'] : 0; //  : 2, 3, 4, 5 $codeGroup = (int)($code / 100); if ($codeGroup == 5) { //  5xx,  ,  GCM   ,    //TODO    Retry-After $success = false; } if ($code !== 200) { // http  ,    //           http://developer.android.com/google/gcm/gcm.html#response $success = false; } if (!$response || strlen(trim($response)) == null) { // ,  -   ,     . $success = false; } // ,    http://developer.android.com/google/gcm/gcm.html#success if ($response) { $json = json_decode($response, true); if (json_last_error() != JSON_ERROR_NONE) { //  json ,         $success = false; $json = array(); } } else { $json = array(); $success = false; } // failure     (    ,  failure    0  1) $failure = isset($json['failure']) ? $json['failure'] : null; // canonical_ids   ,     RegistrationId (     failure -   0  1). $canonicalIds = isset($json['canonical_ids']) ? $json['canonical_ids'] : null; //    ,      .   $success=true       if ($failure || $canonicalIds) { //results   .      ,      (     RegistrationId) $results = isset($json['results']) ? $json['results'] : array(); foreach($results as $result) { $newRegId = isset($result['registration_id']) ? $result['registration_id'] : null; $error = isset($result['error']) ? $result['error'] : null; if ($newRegId) { // $regId  $newRegId; //  ,  Update 1 } else if ($error) { if ($error == self::GCM_ERROR_NOTREGISTERED) { // $regId  ; } else { //  ,   //   ,       http://developer.android.com/google/gcm/gcm.html#error_codes } $success = false; } } } //  ,        . }

अपडेट १
jcrow पंजीकरण के अद्यतन के दौरान प्रतीक्षा कर सकने वाले नुकसान के बारे में एक टिप्पणी में संकेत देता है। स्थिति: उपयोगकर्ता ने एप्लिकेशन को अनइंस्टॉल कर दिया और फिर से => फिर से पंजीकृत किया और एक नया पंजीकरण प्राप्त किया। हमारे डेटाबेस में पहले से ही एक ही उपयोगकर्ता के लिए दो रिकॉर्ड हैं। और एक पुराना RegistrationId के साथ रिकॉर्ड, और दूसरा नए के साथ। यदि हम दोनों RegistrationId को संदेश भेजते हैं, तो पुराने के लिए एक नया RegistrationId आएगा। नतीजतन, हमारे पास एक ही पंजीकरणआईड के साथ एक उपयोगकर्ता के लिए दो प्रविष्टियां हैं।

परिणामस्वरूप: यदि हमारे डेटाबेस में RegistrationId क्षेत्र में एक अद्वितीय सूचकांक है, तो हमें एक त्रुटि मिलती है। यदि कोई इंडेक्स नहीं है, तो एप्लिकेशन उपयोगकर्ता को हर बार दो समान संदेश मिलते हैं।

समाधान: जैसे ही हमें ऑनरस्पेस में एक नया RegistrationId प्राप्त हुआ, हमें डेटाबेस में इसके अस्तित्व की जांच करने की आवश्यकता है। और सकारात्मक मामले में, या तो एक रिकॉर्ड हटा दें या अन्य तालिकाओं से रिकॉर्ड और संबंधित डेटा दोनों रखें।

आगे क्या करना है?

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

यदि आपने आधिकारिक दस्तावेज नहीं पढ़ा है, तो मैं इसे पढ़ने की सलाह देता हूं।

अंतभाषण

मुझे उम्मीद है कि यह ट्यूटोरियल न केवल किसी के लिए एक शुरुआती बिंदु बन जाएगा, बल्कि आपके एंड्रॉइड एप्लिकेशन के बैकएंड के विकास के समय को कम करने में भी मदद करेगा।

Google क्लाउड मैसेजिंग - PHP में बैकएंड लिखना

Google क्लाउड मैसेजिंग - लघु और स्पष्ट

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

GcmSender

लगातार और वर्ग के सदस्य

डिजाइनर

विधि भेजें

GetPackages विधि

OnResponse विधि

आगे क्या करना है?

अंतभाषण

More articles: