An easy to use gcm library for PHP
Switch branches/tags
Clone or download
Latest commit 732d13c Jun 24, 2016


Build Status Total Downloads


Google Cloud Messaging for Android is very powerful, but there are a lot of details to handle. This library takes care of the details and makes GCM very easy to use with PHP.


php-gcm supports the HTTP server protocol for GCM. There is not currently support for XMPP, but implementations and pull requests for XMPP are welcome. See #3 for more details.

php-gcm supports PHP versions >= 5.3.10. php-gcm may work on older versions of PHP, but has not been tested on them.


Composer is the easiest way to manage dependencies in your project. Create a file named composer.json with the following:

    "require": {
        "php-gcm/php-gcm": "^1.1.1"

And run Composer to install php-gcm:

$ curl -s | php
$ composer.phar install


php-gcm follows SEMVER. If you would like to try out the latest, possibly unstable or incorrect code, the dependency can be pointed to dev-master.

    "require": {
        "php-gcm/php-gcm": "dev-master"


$sender = new Sender($gcmApiKey);
$message = new Message($collapseKey, $payloadData);

try {
    $result = $sender->send($message, $deviceRegistrationId, $numberOfRetryAttempts);
} catch (\InvalidArgumentException $e) {
    // $deviceRegistrationId was null
} catch (PHP_GCM\InvalidRequestException $e) {
    // server returned HTTP code other than 200 or 503
} catch (\Exception $e) {
    // message could not be sent


php-gcm is licensed under the Apache 2.0 License. See the LICENSE file for more details.