PHPackages                             simplon/helium - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. simplon/helium

ActiveLibrary[Mail & Notifications](/categories/mail)

simplon/helium
==============

Library to handle iOS Push Notifications via Urban Airship

1.1.1(12y ago)59553MITPHPPHP >=5.3.3

Since Oct 21Pushed 12y agoCompare

[ Source](https://github.com/fightbulc/simplon_helium)[ Packagist](https://packagist.org/packages/simplon/helium)[ Docs](https://github.com/fightbulc/simplon_helium)[ RSS](/packages/simplon-helium/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (1)Dependencies (1)Versions (7)Used By (0)

```
     _                 _               _          _ _
 ___(_)_ __ ___  _ __ | | ___  _ __   | |__   ___| (_)_   _ _ __ ___
/ __| | '_ ` _ \| '_ \| |/ _ \| '_ \  | '_ \ / _ \ | | | | | '_ ` _ \
\__ \ | | | | | | |_) | | (_) | | | | | | | |  __/ | | |_| | | | | | |
|___/_|_| |_| |_| .__/|_|\___/|_| |_| |_| |_|\___|_|_|\__,_|_| |_| |_|
                |_|
```

Simplon/Helium
==============

[](#simplonhelium)

For one of my projects I had the need to talk to Urbain Airship's [Push API](https://docs.urbanairship.com/display/DOCS/Server%3A+iOS+Push+API).
So, I took today off to write an abstract project as composer package so that it is easy to implement in other projects too.

### Setup

[](#setup)

Since its a composer package all you need to to do is require it within your composer package definitions and install/update it:

```
{
     "require": {
        "simplon/helium": "1.1.*"
     }
}
```

If you dont know what `composer` is you should have a look at [Composer's Webpage](http://getcomposer.org/doc/00-intro.md).

### Anything else needed?

[](#anything-else-needed)

Since we're relying here on Urban Airship's Push API you should have registered yourself to receive:

- 1x Key
- 1x Secret Key
- 1x Master Secret Key

If you did not register yourself yet just [head over here](https://go.urbanairship.com/accounts/register/) and register for Urbain Airship's.
The basic plan is free and offers 1,000,000 free notifications / month. That gets us started. Sweet!

A Simple Example
----------------

[](#a-simple-example)

### 1. Add Device Token

[](#1-add-device-token)

The simplest creation of a device token would be as followed:

```
// API keys
$key = '12345';
$secret = '12345';

// device token entity
$deviceToken = \Simplon\Helium\DeviceToken::init()->setToken('111111222233344455AAABBBCCCDDDD');

// remote register device token
$response = \Simplon\Helium\Air::init()
     ->setApplicationKey($key)
     ->setApplicationSecret($secret)
     ->registerDeviceToken($deviceToken);
```

You're cool if your response results in "OK". If not, dont worry you're still cool but your token didn't get registered unfortunately.
Make sure that you used the correct authentication keys.

### 2. Send Push Notification

[](#2-send-push-notification)

Based on the device token we just registered we can now send a notification to the device via:

```
// API keys
$key = '12345';
$secret = '12345';
$master = '12345';

// push notification entity
$pushNotifications = array();
$pushNotifications[] = \Simplon\Helium\PushNotification::init()
     ->setDeviceTokens(array('111111222233344455AAABBBCCCDDDD'))
     ->setAlert("Howdy!")
     ->getData();

// send push to UA's API
$response = \Simplon\Helium\Air::init()
     ->setApplicationKey($key)
     ->setApplicationSecret($secret)
     ->setApplicationMasterSecret($master)
     ->setNotifications($pushNotifications)
     ->sendSinglePush();
```

If all went through your response should result in something like:

```
{ "push_id": "12345-1ad5-11e2-b16d-001b21ce3d90" }
```

Meanwhile you also should have received your push notification on your device.

An Example with more options
----------------------------

[](#an-example-with-more-options)

Well, as always there is more. Registering/managing a device token offers the following other options:

```
$deviceToken = \Simplon\Helium\DeviceToken::init()
     ->setToken('111111222233344455AAABBBCCCDDDD')
     ->setAlias('USER_ID')
     ->setTags(array('tag1', 'tag2'))
     ->setBadge(5)
     ->setQuietTime('22:00', '8:00')
     ->setTimezone('Europe/Berlin');
```

Now, if we come back to sending a push notification to our device we can use the `alias` instead of the `deviceToken`:

```
// API keys
$key = '12345';
$secret = '12345';
$master = '12345';

// push notification entity
$pushNotifications = array();
$pushNotifications[] = \Simplon\Helium\PushNotification::init()
     ->setAliases(array('USER_ID'))
     ->setAlert("Howdy again!")
     ->setMetadata('type', 'fresh')
     ->setMetadata('smile', 'on')
     ->getData();

// send push to UA's API
$response = \Simplon\Helium\Air::init()
     ->setApplicationKey($key)
     ->setApplicationSecret($secret)
     ->setApplicationMasterSecret($master)
     ->setNotifications($pushNotifications)
     ->sendSinglePush();
```

We also could have used `setTags(array('tag1'))` to define our notification recipients.

Manage a Device Token
---------------------

[](#manage-a-device-token)

### Get device data from remote (UA)

[](#get-device-data-from-remote-ua)

Explanation comes soon. If you cannot wait have a look in to the code.

### Update device data

[](#update-device-data)

Explanation comes soon. If you cannot wait have a look in to the code.

### Unregister a device

[](#unregister-a-device)

Explanation comes soon. If you cannot wait have a look in to the code.

### Get all device tokens

[](#get-all-device-tokens)

Explanation comes soon. If you cannot wait have a look in to the code.

### Get inactive device tokens

[](#get-inactive-device-tokens)

Explanation comes soon. If you cannot wait have a look in to the code.

Send/Manage a Push Notification
-------------------------------

[](#sendmanage-a-push-notification)

Explanation comes soon. If you cannot wait have a look in to the code.

License
=======

[](#license)

Simplon/Helium is freely distributable under the terms of the MIT license.

Copyright (c) 2012 Tino Ehrich

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~81 days

Recently: every ~102 days

Total

6

Last Release

4594d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/451061?v=4)[Tino Ehrich](/maintainers/fightbulc)[@fightbulc](https://github.com/fightbulc)

---

Top Contributors

[![maciejhirsz](https://avatars.githubusercontent.com/u/1096222?v=4)](https://github.com/maciejhirsz "maciejhirsz (4 commits)")

---

Tags

notificationsandroidiosurban airship

### Embed Badge

![Health badge](/badges/simplon-helium/health.svg)

```
[![Health](https://phpackages.com/badges/simplon-helium/health.svg)](https://phpackages.com/packages/simplon-helium)
```

###  Alternatives

[paragraph1/php-fcm

PHP application server for google firebase cloud messaging (FCM)

1991.3M11](/packages/paragraph1-php-fcm)[redjanym/php-firebase-cloud-messaging

PHP SDK for Firebase Cloud Messaging from Google

37864.6k2](/packages/redjanym-php-firebase-cloud-messaging)[redjanym/fcm-bundle

A Symfony Bundle for projects to send notifications in mobile devices through Firebase Cloud Messaging HTTP V1 API

43457.4k](/packages/redjanym-fcm-bundle)[ivkos/pushbullet

Push notifications to devices and browsers via Pushbullet

22263.4k2](/packages/ivkos-pushbullet)[vyconsulting-group/push-notification

PHP wrapper FCM

154.4k](/packages/vyconsulting-group-push-notification)[kedniko/firebase-cloud-messaging-http-v1-php

Firebase cloud messaging http v1 php

126.0k](/packages/kedniko-firebase-cloud-messaging-http-v1-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)