🛩️ 🍗 👞 PHP के साथ संयोजन में Android और iOS के लिए पुशओवर पुश अधिसूचना सेवा ⛎ 🛋️ 🖨️

संक्षेप में, पुश सूचनाएं एक प्रोग्राम या सेवा से छोटे महत्वपूर्ण संदेश हैं जो ऑपरेटिंग सिस्टम द्वारा प्रदर्शित किए जाते हैं जब आप सीधे निर्दिष्ट एप्लिकेशन या सेवा के साथ काम नहीं कर रहे होते हैं। कार्यक्रम को हमेशा के लिए स्मृति में रखने की आवश्यकता के अभाव में ऐसी सूचनाओं का लाभ, इसे प्रोसेसर शक्ति और मेमोरी पर खर्च करना।
मैं यहां दूरस्थ सूचनाओं को वितरित करने के लिए पूरी तकनीक का वर्णन नहीं करूंगा, क्योंकि यह मेरे सामने पहले ही हो चुका है । यह कुछ इस तरह दिखता है: समय-समय पर डेमॉन सर्वर को पोल करता है और, यदि कोई संदेश दिखाई देता है, तो वह हमें दिखाता है।
IOS के लिए, वे एंड्रॉइड, C2DM-GCM के लिए APNS के साथ आए, लेकिन मैं क्रॉस-प्लेटफॉर्म (लाउड) पुशओवर सेवा और इसके php साइट के साथ कनेक्शन के बारे में बात करना चाहता हूं।

कार्य उदाहरण

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

छोटी बात

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

संदेश, 512 वर्णों की लंबाई के साथ संदेश के मुख्य पाठ के अलावा, एक बड़ा शीर्षक, URL (तब संदेश की लंबाई बढ़कर 500 हो सकती है) और इसका शीर्षक (सब कुछ अलग-अलग गठित ब्लॉकों में प्रदर्शित होता है, इसलिए ऐसा अंतर है)। एक संदेश चयनित चयनित प्राथमिकता पर दिया जा सकता है। उपयोगकर्ता "शांत" घंटों को निर्दिष्ट कर सकता है, जब सूचनाओं को जगाने के लिए इसके लायक नहीं है, साथ ही डिवाइस कनेक्ट करें और डिस्कनेक्ट करें जिससे सूचनाएं आएंगी।
अधिसूचना उन उपयोगकर्ताओं तक पहुंचाई जा सकती है, जिन्होंने इस उपयोगकर्ता के सभी डिवाइसों को या पसंद के अनुसार अपना कोड प्रदान किया है। संदेश प्राप्त करने के लिए, उपयोगकर्ता को सेवा में पंजीकृत होना चाहिए और कम से कम एक काम करने वाला उपकरण होना चाहिए।

उपयोगकर्ता जोड़ें

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

सेवा जोड़ना

सेवा जोड़ना कोई अधिक जटिल नहीं है। अपने व्यक्तिगत खाते से, एप्लिकेशन बनाने के लिए पृष्ठ पर जाएं , जहां उत्पाद का वर्णन करना प्रस्तावित है:

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

एप्लिकेशन और प्राप्तकर्ता जोड़ना

... किसी भी तरह से नहीं किया गया। कोई भी ऐप्लीकेशन किसी भी यूजर को नोटिफिकेशन भेज सकती है अगर उसे उसका टोकन पता है। आबादी से टोकन की स्वीकृति आवेदन की अंतरात्मा की आवाज पर रहती है। साथ ही न्यूज़लेटर्स से सदस्यता समाप्त करना।

एपीआई

छोटा , समतल और समझने योग्य। POST अनुरोध में api.pushover.net/1/messages.json या api.pushover.net/1/messages.xml पर संदेश भेजने के लिए , आपको न्यूनतम निर्दिष्ट करना होगा:

टोकन - आपके आवेदन या सेवा का हैश टोकन।
उपयोगकर्ता - उपयोगकर्ता का हैश टोकन जिसे आप एक अधिसूचना भेज रहे हैं।
संदेश - संदेश का पाठ भाग।

इसके अतिरिक्त, आप जोड़ सकते हैं:

डिवाइस - उपयोगकर्ता के डिवाइस की पहचानकर्ता, ताकि उसके सभी उपकरणों को तुरंत सूचनाएं न भेजें
शीर्षक - संदेश का शीर्षक, यदि निर्दिष्ट नहीं है, तो सेवा का नाम प्रदर्शित किया जाएगा
url - यदि आवश्यक हो, तो वेब पेज से लिंक करें
url_title - लिंक का शीर्षक
प्राथमिकता - संदेश की प्राथमिकता, उच्च प्राथमिकता के लिए 1 पर सेट, सभी "शांत" घंटे और -1 चुप सूचना के लिए।
टाइमस्टैम्प - UNIX टाइमस्टैम्प जब यह अधिसूचना बनाई गई थी। सेवा वितरण समय सारिणी प्रदान नहीं की जाती है।

सर्वर प्रतिक्रिया

सर्वर प्रतिक्रिया को json या xml प्रारूप में प्रस्तुत किया जाएगा (जिसे निर्दिष्ट स्क्रिप्ट के विस्तार पर निर्भर करता है)।
यदि सब कुछ ठीक रहा, तो 1 के बराबर स्थिति फ़ील्ड की सामग्री के साथ एक ऑब्जेक्ट दिया जाएगा।
अन्यथा, स्थिति फ़ील्ड में कुछ और होगा, और त्रुटि फ़ील्ड में त्रुटि विवरणों की एक सरणी होगी। यहाँ सफल और असफल XML प्रस्तुतियाँ के लिए नमूना प्रतिक्रियाएँ हैं:

<?xml version="1.0" encoding="UTF-8"?> <hash> <status type="integer">1</status> </hash>

और

 <?xml version="1.0" encoding="UTF-8"?> <hash> <token>invalid</token> <errors type="array"> <error>application token is invalid</error> </errors> <status type="integer">0</status> </hash>

पीएचपी

मुख्य पृष्ठ पर और खंडों में फैक्स में "देखो यह कितना आसान है!"
CURL का उपयोग हर जगह किया जाता है, जो हालांकि, समझ में आता है।

ज़फीगरिम अपनी कक्षा

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

वर्ग PushoverException

 class PushoverException extends Exception { /** * Messages array * @var array */ private $fMessages; /** * Exception constructor * @param array $aMessages An array of messages */ public function __construct(array $aMessages) { parent::__construct('PushoverException exception'); $this->fMessages = $aMessages; } /** * Get messages array * @return array */ public function getMessages() { return empty($this->fMessages) ? array() : $this->fMessages; } }

कक्षा धक्का

 class Pushover { /* * Pushover json api service url */ const C_API_URL = 'https://api.pushover.net/1/messages.json'; /** * Properties storage array * @var array */ private $fProperties; /** * cURL instance */ private $fCurl; //--------------------------------------------------------------------------// /** * Properties getter * @param string $aPropertyName Property name * @return mixed */ public function __get($aPropertyName) { if(array_key_exists($aPropertyName, $this->fProperties)) return $this->fProperties[$aPropertyName]; return null; } /** * Properties setter * @param string $aPropertyName Property name * @param mixed $aValue Property value */ public function __set($aPropertyName, $aValue) { $this->fProperties[$aPropertyName] = $aValue; } //--------------------------------------------------------------------------// /** * Class constructor * @param string $aApplicationToken Application token */ public function __construct($aApplicationToken = null) { if(!empty($aApplicationToken)) $this->applicationToken = $aApplicationToken; $this->fCurl = curl_init(); curl_setopt($this->fCurl, CURLOPT_URL, self::C_API_URL); curl_setopt($this->fCurl, CURLOPT_HEADER, false); curl_setopt($this->fCurl, CURLOPT_RETURNTRANSFER, true); curl_setopt($this->fCurl, CURLOPT_SSL_VERIFYPEER, false); } /** * Class destructor */ public function __destruct() { curl_close($this->fCurl); } //--------------------------------------------------------------------------// /** * Throws an exceprion with single message * @param mixed $aMessage * @throws PushoverException */ public function throwMessage($aMessage) { throw new PushoverException(array($aMessage)); } /** * Throws an exceprion with an array of messages * @param array $aMessages * @throws PushoverException */ public function throwMessages(array $aMessages) { throw new PushoverException($aMessages); } //--------------------------------------------------------------------------// /** * Send pushover notification */ public function send() { if(!strlen($this->applicationToken)) $this->throwMessage('Application token is empty'); if(!strlen($this->userToken)) $this->throwMessage('User token is empty'); if(!strlen($this->notificationMessage)) $this->throwMessage('Notification message is empty'); if(intval($this->notificationTimestamp) <= 0) $this->notificationTimestamp = time(); $lSendParams = array( 'token' => $this->applicationToken, 'user' => $this->userToken, 'device' => $this->userDevice, 'title' => $this->notificationTitle, 'message' => $this->notificationMessage, 'priority' => $this->notificationPriority, 'timestamp' => $this->notificationTimestamp, 'url' => $this->notificationUrl, 'url_title' => $this->notificationUrlTitle ); foreach($lSendParams as $lKey => $lParam) if(empty($lParam)) unset($lSendParams[$lKey]); curl_setopt($this->fCurl, CURLOPT_POSTFIELDS, $lSendParams); $lResponseJson = curl_exec($this->fCurl); if($lResponseJson === false) $this->throwMessage('API request error'); $lResponse = json_decode($lResponseJson, true); if(empty($lResponse) || !is_array($lResponse)) $this->throwMessage('Bad API response'); if(!empty($lResponse['errors'])) $this->throwMessages($lResponse['errors']); if(empty($lResponse['status']) || intval($lResponse['status']) != 1) $this->throwMessage('Unknown notification send error'); } }

न्यूनतम संदेश अब भेजने के लिए काफी सरल है, त्रुटियों को हल किया जा सकता है:

 $lPushover = new Pushover(' '); $lPushover->userToken = ' '; $lPushover->notificationMessage = ' '; try { $lPushover->send(); echo '<font color="green">Message sent</font>', PHP_EOL; } catch (PushoverException $aException) { echo '<font color="red">Error sending messages</font><br>', PHP_EOL; echo '<ul>', PHP_EOL; foreach($aException->getMessages() as $lMessage) echo '<li>', $lMessage, '</li>', PHP_EOL; echo '</ul>', PHP_EOL; }

उपयोगकर्ता ने पहले ही संदेश स्वीकार कर लिया है।

कुल मिलाकर

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

PHP के साथ संयोजन में Android और iOS के लिए पुशओवर पुश अधिसूचना सेवा