Removed MPNS, deprecated old APNS (#124)

marcin-cebo · pubnub-release-bot · web-flow · commit 5e9faf51c101 · 2025-10-30T13:09:13.000+01:00
* Removed possibility to use deprecated PushType MPNS - Microsoft Push Notification Service.
* Added deprecation warning for old APNS PushType.
* In case FCM is chosen as PushType type REST query param gets fcm value instead of gcm.

* PubNub SDK 9.0.0 release.

---------

Co-authored-by: PubNub Release Bot &lt;120067856+pubnub-release-bot@users.noreply.github.com&gt;
diff --git a/.pubnub.yml b/.pubnub.yml
@@ -1,8 +1,17 @@
 name: php
-version: 8.0.2
+version: 9.0.0
 schema: 1
 scm: github.com/pubnub/php
 changelog:
+  - date: 2025-10-30
+    version: 9.0.0
+    changes:
+      - type: feature
+        text: "Added limit and offset parameters for hereNow. Number of returned users per channel by default is limited to 1000. Breaking change."
+      - type: bug
+        text: "Removed possibility to use deprecated MPNS(Microsoft Push Notification Service). Breaking change."
+      - type: bug
+        text: "Added deprecation warning for old APNS PushType. ."
   - date: 2025-05-29
     version: 8.0.2
     changes:
@@ -534,8 +543,8 @@ sdks:
                     - x86-64
           - distribution-type: library
             distribution-repository: GitHub release
-            package-name: php-8.0.2.zip
-            location: https://github.com/pubnub/php/releases/tag/8.0.2
+            package-name: php-9.0.0.zip
+            location: https://github.com/pubnub/php/releases/tag/9.0.0
             requires:
               - name: rmccue/requests
                 min-version: 1.0.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,13 @@
+## 9.0.0
+October 30 2025
+
+#### Added
+- Added limit and offset parameters for hereNow. Number of returned users per channel by default is limited to 1000. Breaking change.
+
+#### Fixed
+- Removed possibility to use deprecated MPNS(Microsoft Push Notification Service). Breaking change.
+- Added deprecation warning for old APNS PushType. .
+
 ## 8.0.2
 May 29 2025
 
diff --git a/README.md b/README.md
@@ -41,7 +41,7 @@ You will need the publish and subscribe keys to authenticate your app. Get your
          {
              "require": {
                  <!-- include the latest version from the badge at the top -->
-                 "pubnub/pubnub": "8.0.2"
+                 "pubnub/pubnub": "9.0.0"
              }
          }
          ```
diff --git a/composer.json b/composer.json
@@ -5,7 +5,7 @@
   "keywords": ["api", "real-time", "realtime", "real time", "ajax", "push"],
   "homepage": "http://www.pubnub.com/",
   "license": "proprietary",
-  "version": "8.0.2",
+  "version": "9.0.0",
   "authors": [
     {
       "name": "PubNub",
diff --git a/examples/basic_usage/mobile_push.php b/examples/basic_usage/mobile_push.php
@@ -20,13 +20,13 @@
 // Define channels to enable push notifications on
 $channelsForPush = ["news", "alerts", "promotions"];
 
-// FCM/GCM device token (typically a long string generated by Firebase)
+// FCM device token (typically a long string generated by Firebase)
 $deviceId = "fcm-device-registration-token-from-firebase";
 
 try {
     // Register the device to receive push notifications on the specified channels
     $result = $pubnub->addChannelsToPush()
-        ->pushType(PNPushType::FCM)  // Use GCM/FCM for Android devices
+        ->pushType(PNPushType::FCM)  // Use FCM for Android devices
         ->channels($channelsForPush)
         ->deviceId($deviceId)
         ->sync();
diff --git a/phpstan-baseline.neon b/phpstan-baseline.neon
@@ -5740,11 +5740,6 @@ parameters:
 			count: 1
 			path: tests/functional/push/ListPushProvisionsTest.php
 
-		-
-			message: "#^Method Tests\\\\Functional\\\\Push\\\\ListPushProvisionsTest\\:\\:testListChannelGroupMPNS\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/functional/push/ListPushProvisionsTest.php
-
 		-
 			message: "#^Method Tests\\\\Functional\\\\Push\\\\RemoveChannelsFromPushExposed\\:\\:buildParams\\(\\) return type has no value type specified in iterable type array\\.$#"
 			count: 1
@@ -5780,11 +5775,6 @@ parameters:
 			count: 1
 			path: tests/functional/push/RemoveDeviceFromPushTest.php
 
-		-
-			message: "#^Method Tests\\\\Functional\\\\Push\\\\RemoveDeviceFromPushTest\\:\\:testRemovePushMPNS\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/functional/push/RemoveDeviceFromPushTest.php
-
 		-
 			message: "#^Method Tests\\\\Integrational\\\\AddChannelChannelGroupEndpointTest\\:\\:testChannelMissing\\(\\) has no return type specified\\.$#"
 			count: 1
@@ -6130,11 +6120,6 @@ parameters:
 			count: 1
 			path: tests/integrational/ListPushProvisionsTest.php
 
-		-
-			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ListPushProvisionsTest\\:\\:testMicrosoftSuccess\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/integrational/ListPushProvisionsTest.php
-
 		-
 			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ListPushProvisionsTest\\:\\:testNullDeviceId\\(\\) has no return type specified\\.$#"
 			count: 1
@@ -6170,11 +6155,6 @@ parameters:
 			count: 1
 			path: tests/integrational/ModifyPushChannelsForDeviceTest.php
 
-		-
-			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ModifyPushChannelsForDeviceTest\\:\\:testAddMicrosoftSuccessSync\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/integrational/ModifyPushChannelsForDeviceTest.php
-
 		-
 			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ModifyPushChannelsForDeviceTest\\:\\:testAppleSuccessRemove\\(\\) has no return type specified\\.$#"
 			count: 1
@@ -6240,16 +6220,6 @@ parameters:
 			count: 1
 			path: tests/integrational/ModifyPushChannelsForDeviceTest.php
 
-		-
-			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ModifyPushChannelsForDeviceTest\\:\\:testMicrosoftSuccessRemove\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/integrational/ModifyPushChannelsForDeviceTest.php
-
-		-
-			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ModifyPushChannelsForDeviceTest\\:\\:testMicrosoftSuccessRemoveAll\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/integrational/ModifyPushChannelsForDeviceTest.php
-
 		-
 			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ModifyPushChannelsForDeviceTest\\:\\:testMissingChannels\\(\\) has no return type specified\\.$#"
 			count: 1
@@ -7025,11 +6995,6 @@ parameters:
 			count: 1
 			path: tests/integrational/push/ListPushProvisionsEndpointTest.php
 
-		-
-			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ListPushProvisionsEndpointTest\\:\\:testListChannelGroupMPNS\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/integrational/push/ListPushProvisionsEndpointTest.php
-
 		-
 			message: "#^Method Tests\\\\Integrational\\\\Push\\\\ListPushProvisionsEndpointTest\\:\\:testWarningWhenUsingDeprecatedGCMType\\(\\) has no return type specified\\.$#"
 			count: 1
@@ -7070,11 +7035,6 @@ parameters:
 			count: 1
 			path: tests/integrational/push/RemoveDeviceFromPushEndpointTest.php
 
-		-
-			message: "#^Method Tests\\\\Integrational\\\\Push\\\\RemoveDeviceFromPushEndpointTest\\:\\:testRemovePushMPNS\\(\\) has no return type specified\\.$#"
-			count: 1
-			path: tests/integrational/push/RemoveDeviceFromPushEndpointTest.php
-
 		-
 			message: "#^Method Tests\\\\Integrational\\\\Push\\\\RemoveDeviceFromPushEndpointTest\\:\\:testWarningWhenUsingDeprecatedGCMType\\(\\) has no return type specified\\.$#"
 			count: 1
diff --git a/src/PubNub/Endpoints/Push/PushEndpoint.php b/src/PubNub/Endpoints/Push/PushEndpoint.php
@@ -66,6 +66,10 @@ protected function validatePushType()
             trigger_error("GCM is deprecated. Please use FCM instead.", E_USER_DEPRECATED);
         }
 
+        if ($this->pushType === PNPushType::APNS) {
+            trigger_error("APNS is deprecated. Please use APNS2 instead.", E_USER_DEPRECATED);
+        }
+
         if (!in_array($this->pushType, PNPushType::all())) {
             throw new PubNubValidationException("Invalid push type");
         }
@@ -149,6 +153,6 @@ protected function getName()
 
     protected function getPushType(): string
     {
-        return $this->pushType == PNPushType::FCM ? 'gcm' : $this->pushType;
+        return $this->pushType == PNPushType::FCM ? 'fcm' : $this->pushType;
     }
 }
diff --git a/src/PubNub/Enums/PNPushType.php b/src/PubNub/Enums/PNPushType.php
@@ -4,18 +4,24 @@
 
 class PNPushType
 {
-    public const APNS = "apns";
     public const APNS2 = "apns2";
-    public const MPNS = "mpns";
-    public const GCM = "gcm";
     public const FCM = "fcm";
 
+    /**
+     * @deprecated Use APNS2 instead. APNS will be removed in a future version.
+     */
+    public const APNS = "apns";
+
+    /**
+     * @deprecated Use FCM instead. GCM will be removed in a future version.
+     */
+    public const GCM = "gcm";
+
     public static function all()
     {
         return [
             self::APNS,
             self::APNS2,
-            self::MPNS,
             self::GCM,
             self::FCM
         ];
diff --git a/src/PubNub/PubNub.php b/src/PubNub/PubNub.php
@@ -69,7 +69,7 @@
 
 class PubNub implements LoggerAwareInterface
 {
-    protected const SDK_VERSION = "8.0.2";
+    protected const SDK_VERSION = "9.0.0";
     protected const SDK_NAME = "PubNub-PHP";
 
     public static $MAX_SEQUENCE = 65535;
diff --git a/tests/functional/push/AddChannelsToPushTest.php b/tests/functional/push/AddChannelsToPushTest.php
@@ -43,7 +43,7 @@ public function testPushAddMultipleChannels()
         $add = new AddChannelsToPushExposed($this->pubnub);
 
         $add->channels(["ch1", "ch2"])
-            ->pushType(PNPushType::MPNS)
+            ->pushType(PNPushType::FCM)
             ->deviceId("coolDevice");
 
         $this->assertEquals(sprintf(
@@ -55,7 +55,7 @@ public function testPushAddMultipleChannels()
         $this->assertEquals([
             "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
             "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "mpns",
+            "type" => "fcm",
             "add" => "ch1,ch2"
         ], $add->buildParams());
 
@@ -110,7 +110,7 @@ public function testPushAddFCM()
         $this->assertEquals([
             "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
             "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "gcm",
+            "type" => "fcm",
             "add" => "ch1,ch2,ch3"
         ], $add->buildParams());
 
diff --git a/tests/functional/push/ListPushProvisionsTest.php b/tests/functional/push/ListPushProvisionsTest.php
@@ -75,29 +75,7 @@ public function testListChannelGroupFCM()
         $this->assertEquals([
             "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
             "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "gcm"
-        ], $list->buildParams());
-    }
-
-    public function testListChannelGroupMPNS()
-    {
-        $this->pubnub->getConfiguration()->setUuid("sampleUUID");
-
-        $list = new ListPushProvisionsExposed($this->pubnub);
-
-        $list->pushType(PNPushType::MPNS)
-            ->deviceId("coolDevice");
-
-        $this->assertEquals(sprintf(
-            ListPushProvisions::PATH,
-            $this->pubnub->getConfiguration()->getSubscribeKey(),
-            "coolDevice"
-        ), $list->buildPath());
-
-        $this->assertEquals([
-            "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
-            "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "mpns"
+            "type" => "fcm"
         ], $list->buildParams());
     }
 }
diff --git a/tests/functional/push/RemoveChannelsFromPushTest.php b/tests/functional/push/RemoveChannelsFromPushTest.php
@@ -41,7 +41,7 @@ public function testPushRemoveMultipleChannels()
         $remove = new RemoveChannelsFromPushExposed($this->pubnub);
 
         $remove->channels(['ch1', 'ch2'])
-            ->pushType(PNPushType::MPNS)
+            ->pushType(PNPushType::FCM)
             ->deviceId('coolDevice');
 
         $this->assertEquals(sprintf(
@@ -53,7 +53,7 @@ public function testPushRemoveMultipleChannels()
         $this->assertEquals([
             "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
             "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "mpns",
+            "type" => "fcm",
             "remove" => "ch1,ch2"
         ], $remove->buildParams());
     }
@@ -77,7 +77,7 @@ public function testPushRemoveFCM()
         $this->assertEquals([
             "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
             "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "gcm",
+            "type" => "fcm",
             "remove" => "ch1,ch2,ch3"
         ], $remove->buildParams());
     }
diff --git a/tests/functional/push/RemoveDeviceFromPushTest.php b/tests/functional/push/RemoveDeviceFromPushTest.php
@@ -32,28 +32,6 @@ public function testRemovePushAPNS()
         ], $remove->buildParams());
     }
 
-    public function testRemovePushMPNS()
-    {
-        $this->pubnub->getConfiguration()->setUuid("sampleUUID");
-
-        $remove = new RemoveDeviceFromPushExposed($this->pubnub);
-
-        $remove->pushType(PNPushType::MPNS)
-            ->deviceId('coolDevice');
-
-        $this->assertEquals(sprintf(
-            RemoveDeviceFromPush::PATH,
-            $this->pubnub->getConfiguration()->getSubscribeKey(),
-            "coolDevice"
-        ), $remove->buildPath());
-
-        $this->assertEquals([
-            "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
-            "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "mpns",
-        ], $remove->buildParams());
-    }
-
     public function testRemovePushFCM()
     {
         $this->pubnub->getConfiguration()->setUuid("sampleUUID");
@@ -72,7 +50,7 @@ public function testRemovePushFCM()
         $this->assertEquals([
             "pnsdk" => PubNubUtil::urlEncode(PubNub::getSdkFullName()),
             "uuid" => $this->pubnub->getConfiguration()->getUuid(),
-            "type" => "gcm",
+            "type" => "fcm",
         ], $remove->buildParams());
     }
 }
diff --git a/tests/integrational/ListPushProvisionsTest.php b/tests/integrational/ListPushProvisionsTest.php
diff --git a/tests/integrational/ModifyPushChannelsForDeviceTest.php b/tests/integrational/ModifyPushChannelsForDeviceTest.php
diff --git a/tests/integrational/push/AddChannelsToPushEndpointTest.php b/tests/integrational/push/AddChannelsToPushEndpointTest.php
diff --git a/tests/integrational/push/ListPushProvisionsEndpointTest.php b/tests/integrational/push/ListPushProvisionsEndpointTest.php
diff --git a/tests/integrational/push/RemoveChannelsFromPushEndpointTest.php b/tests/integrational/push/RemoveChannelsFromPushEndpointTest.php
diff --git a/tests/integrational/push/RemoveDeviceFromPushEndpointTest.php b/tests/integrational/push/RemoveDeviceFromPushEndpointTest.php

Original file line number	Diff line number	Diff line change
`@@ -41,7 +41,7 @@ You will need the publish and subscribe keys to authenticate your app. Get your`
`41`	`41`	`{`
`42`	`42`	`"require": {`
`43`	`43`	`<!-- include the latest version from the badge at the top -->`
`44`		`- "pubnub/pubnub": "8.0.2"`
	`44`	`+ "pubnub/pubnub": "9.0.0"`
`45`	`45`	`}`
`46`	`46`	`}`
`47`	`47`	```
Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@`
`5`	`5`	`"keywords": ["api", "real-time", "realtime", "real time", "ajax", "push"],`
`6`	`6`	`"homepage": "http://www.pubnub.com/",`
`7`	`7`	`"license": "proprietary",`
`8`		`- "version": "8.0.2",`
	`8`	`+ "version": "9.0.0",`
`9`	`9`	`"authors": [`
`10`	`10`	`{`
`11`	`11`	`"name": "PubNub",`
Original file line number	Diff line number	Diff line change
`@@ -66,6 +66,10 @@ protected function validatePushType()`
`66`	`66`	`trigger_error("GCM is deprecated. Please use FCM instead.", E_USER_DEPRECATED);`
`67`	`67`	`}`
`68`	`68`
	`69`	`+ if ($this->pushType === PNPushType::APNS) {`
	`70`	`+ trigger_error("APNS is deprecated. Please use APNS2 instead.", E_USER_DEPRECATED);`
	`71`	`+ }`
	`72`	`+`
`69`	`73`	`if (!in_array($this->pushType, PNPushType::all())) {`
`70`	`74`	`throw new PubNubValidationException("Invalid push type");`
`71`	`75`	`}`
`@@ -149,6 +153,6 @@ protected function getName()`
`149`	`153`
`150`	`154`	`protected function getPushType(): string`
`151`	`155`	`{`
`152`		`- return $this->pushType == PNPushType::FCM ? 'gcm' : $this->pushType;`
	`156`	`+ return $this->pushType == PNPushType::FCM ? 'fcm' : $this->pushType;`
`153`	`157`	`}`
`154`	`158`	`}`
Original file line number	Diff line number	Diff line change
`@@ -69,7 +69,7 @@`
`69`	`69`
`70`	`70`	`class PubNub implements LoggerAwareInterface`
`71`	`71`	`{`
`72`		`- protected const SDK_VERSION = "8.0.2";`
	`72`	`+ protected const SDK_VERSION = "9.0.0";`
`73`	`73`	`protected const SDK_NAME = "PubNub-PHP";`
`74`	`74`
`75`	`75`	`public static $MAX_SEQUENCE = 65535;`