support ios10 features

Author: Helperhaps

doc/api.md

@@ -76,7 +76,7 @@ $push->setNotificationAlert('alert');
 
 ```php
 // iosNotification($alert = '', array $notification = array())
-// 数组 $notification 的键支持 'sound', 'badge', 'content-available', 'category', 'extras' 中的一个或多个
+// 数组 $notification 的键支持 'sound', 'badge', 'content-available', 'mutable-available', category', 'extras' 中的一个或多个
 
 // 调用示例
 $push->iosNotification();
@@ -96,10 +96,11 @@ $push->iosNotification('hello', [
 
 | 参数 | 说明 |
 | --- | --- |
-| alert |表示通知内容，会覆盖上级统一指定的 alert 信息；默认内容可以为空字符串，表示不展示到通知栏 |
+| alert |表示通知内容，会覆盖上级统一指定的 alert 信息；默认内容可以为空字符串，表示不展示到通知栏, 支持字符串和数组两种形式 |
 | sound | 表示通知提示声音，默认填充为空字符串 |
 | badge | 表示应用角标，把角标数字改为指定的数字；为 0 表示清除，支持 '+1','-1' 这样的字符串，表示在原有的 badge 基础上进行增减，默认填充为 '+1' |
-| available | 表示推送唤醒，仅接受 true 表示为 Background Remote Notification，若不填默认表示普通的 Remote Notification |
+| content-available | 表示推送唤醒，仅接受 true 表示为 Background Remote Notification，若不填默认表示普通的 Remote Notification |
+| mutable-available | 表示通知扩展, 仅接受 true 表示支持 iOS10 的 UNNotificationServiceExtension, 若不填默认表示普通的 Remote Notification |
 | category | IOS8才支持。设置 APNs payload 中的 'category' 字段值 |
 | extras | 表示扩展字段，接受一个数组，自定义 Key/value 信息以供业务使用 |
 

examples/push_example.php

@@ -40,6 +40,7 @@
             'sound' => 'sound.caf',
             // 'badge' => '+1',
             // 'content-available' => true,
+            // 'mutable-available' => true,
             'category' => 'jiguang',
             'extras' => array(
                 'key' => 'value',

src/JPush/PushPayload.php

@@ -356,9 +356,9 @@ private function generateSendno() {
 
     # new methods
     public function iosNotification($alert = '', array $notification = array()) {
-        # $required_keys = array('sound', 'badge', 'content-available', 'category', 'extras');
+        # $required_keys = array('sound', 'badge', 'content-available', 'mutable-available', category', 'extras');
         $ios = array();
-        $ios['alert'] = is_string($alert) ? $alert : '';
+        $ios['alert'] = (is_string($alert) || is_array($alert)) ? $alert : '';
         if (!empty($notification)) {
             if (isset($notification['sound']) && is_string($notification['sound'])) {
                 $ios['sound'] = $notification['sound'];
@@ -369,6 +369,9 @@ public function iosNotification($alert = '', array $notification = array()) {
             if (isset($notification['content-available']) && is_bool($notification['content-available']) && $notification['content-available']) {
                 $ios['content-available'] = $notification['content-available'];
             }
+            if (isset($notification['mutable-available']) && is_bool($notification['mutable-available']) && $notification['mutable-available']) {
+                $ios['mutable-available'] = $notification['mutable-available'];
+            }
             if (isset($notification['category']) && is_string($notification['category'])) {
                 $ios['category'] = $notification['category'];
             }

tests/JPush/PushPayloadTest.php

@@ -139,8 +139,14 @@ public function testIosNotification() {
     }
     public function testIosNotificationWithArray() {
         $payload = $this->payload;
+        $alert_array = array(
+            'alert_k1' => 'alert_v1',
+            'alert_k2' => 'alert_v2',
+            'alert_k3' => 'alert_v3',
+            'alert_k4' => 'alert_v4'
+        );
         $array = array(
-            'sound' => 'hello jpush',
+            'sound' => 'jpush.caf',
             'badge' => 2,
             'content-available' => true,
             'category' => 'jiguang',
@@ -150,8 +156,9 @@ public function testIosNotificationWithArray() {
             ),
             'invalid_key' => 'invalid_value'
         );
-        $result = $payload->iosNotification('', $array)->build();
+        $result = $payload->iosNotification($alert_array, $array)->build();
         $ios = $result['notification']['ios'];
+        $this->assertTrue(is_array($ios['alert']));
         $this->assertEquals(6, count($ios));
         $this->assertFalse(array_key_exists('invalid_key', $ios));
     }
@@ -244,10 +251,15 @@ public function testOptions() {
 
     public function testPushToAll() {
         $payload = $this->payload;
-
         $platform = array('ios', 'android', 'blackberry');
+        $ios_alert = array(
+            'k1' => 'v1',
+            'k2' => 'v2',
+            'k3' => 'v3',
+            'k4' => 'v4'
+        );
         $ios_notification = array(
-            'sound' => 'hello jpush',
+            'sound' => 'jpush.caf',
             'badge' => 2,
             'content-available' => true,
             'category' => 'jiguang',
@@ -277,7 +289,7 @@ public function testPushToAll() {
         );
 
         $result = $payload->setPlatform($platform)
-            ->iosNotification('Hello IOS', $ios_notification)
+            ->iosNotification($ios_alert, $ios_notification)
             ->androidNotification('Hello Android', $android_notification)
             ->message('Hello JPush', $message)
             ->build();