Merge pull request #17 from CodeMonkeysRu/release/v0.5

Release/v0.5

Author: iVariable

README.md

@@ -27,6 +27,7 @@ $message
     ->setTtl(123)
     ->setRestrictedPackageName("com.example.trololo")
     ->setDryRun(true)
+    ->setPriority(GCM\MessageMessage::PRIORITY_HIGH)
 ;
 
 try {
@@ -132,6 +133,7 @@ $sender = new GCM\Sender("YOUR GOOGLE API KEY", false, "/path/to/cacert.crt");
 
 ChangeLog
 ----------------------
+* v0.5 - Added support for "priority" flag (https://github.com/CodeMonkeysRu/GCMMessage/pull/16)
 * v0.4 - Code cleanup, PHP5.5 support dropped
 * v0.3 - Content-available added (https://github.com/CodeMonkeysRu/GCMMessage/pull/11)
 * v0.2 - Notifications added

library/CodeMonkeysRu/GCM/Message.php

@@ -8,6 +8,8 @@
  */
 class Message
 {
+    const PRIORITY_NORMAL = 'normal';
+    const PRIORITY_HIGH   = 'high';
 
     /**
      * A string array with the list of devices (registration IDs) receiving the message.
@@ -96,6 +98,21 @@ class Message
      */
     private $contentAvailable = true;
 
+    /**
+     * Sets the priority of the message. Valid values are "normal" and "high." On iOS, these
+     * correspond to APNs priority 5 and 10. By default, messages are sent with normal
+     * priority. Normal priority optimizes the client app's battery consumption, and should
+     * be used unless immediate delivery is required. For messages with normal priority, the
+     * app may receive the message with unspecified delay.
+     * When a message is sent with high priority, it is sent immediately, and the app can wake
+     * a sleeping device and open a network connection to your server.
+     *
+     * Optional.
+     *
+     * @var string
+     */
+    private $priority = self::PRIORITY_NORMAL;
+
     /**
      * Allows developers to test their request without actually sending a message.
      *
@@ -222,4 +239,23 @@ public function setContentAvailable($contentAvailable)
         $this->contentAvailable = $contentAvailable;
         return $this;
     }
+
+    public function getPriority()
+    {
+        return $this->priority;
+    }
+
+    public function setPriority($priority)
+    {
+        $allowedPriorities = array(self::PRIORITY_HIGH, self::PRIORITY_NORMAL);
+
+        if (!in_array($priority, $allowedPriorities, true)) {
+            throw new \InvalidArgumentException(
+                'Invalid priority "' . $priority . '", allowed are only these: ' . implode(', ', $allowedPriorities)
+            );
+        }
+
+        $this->priority = $priority;
+        return $this;
+    }
 }

library/CodeMonkeysRu/GCM/Sender.php

@@ -156,6 +156,7 @@ private function formMessageData(Message $message)
             'restricted_package_name' => 'getRestrictedPackageName',
             'dry_run' => 'getDryRun',
             'content_available' => 'getContentAvailable',
+            'priority' => 'getPriority',
         );
 
         foreach ($dataFields as $fieldName => $getter) {