ably / ably-php
Ably REST client library for PHP.
Installs: 4 934 174
Dependents: 20
Suggesters: 24
Security: 0
Stars: 56
Watchers: 25
Forks: 16
Open Issues: 39
Requires
- php: ^7.2 || ^8.0
- ext-curl: *
- ext-json: *
- ext-openssl: *
- rybakit/msgpack: >=0.9.1
Requires (Dev)
- phpunit/phpunit: ^8.5 || ^9.5
This package is auto-updated.
Last update: 2025-09-03 07:48:57 UTC
README
Ably Pub/Sub PHP SDK
Build using Ably’s Pub/Sub PHP SDK, supported on all popular platforms and frameworks.
Ably Pub/Sub provides flexible APIs that deliver features such as pub-sub messaging, message history, presence, and push notifications. Utilizing Ably’s realtime messaging platform, applications benefit from its highly performant, reliable, and scalable infrastructure.
Find out more:
Getting started
Everything you need to get started with Ably:
Supported platforms
Ably aims to support a wide range of platforms. If you experience any compatibility issues, open an issue in the repository or contact Ably support.
Important
PHP SDK versions < 1.1.9 will be deprecated from November 1, 2025.
Laravel packages
For Laravel applications, consider these framework-integrated alternatives that provide Laravel integration with automatic configuration and native broadcasting support, eliminating the boilerplate setup required when using the raw PHP SDK directly:
- Ably Pub/Sub PHP Laravel SDK - Laravel integration package with clean facade and dependency injection interface.
- Ably Broadcaster for Laravel - Official Laravel broadcaster for real-time event broadcasting.
Installation
To get started with your project, install the package:
composer require ably/ably-php
Usage
The following code connects to Ably's REST messaging service, gets reference to a channel to receive messages, and publishes a test message to that same channel:
// Initialize Ably REST client $ably = new AblyRest(['key' => 'your-ably-api-key', 'clientId' => 'me']); // Get a reference to the 'test-channel' channel $channel = $ably->channel('test-channel'); // Publish a test message to the channel $channel->publish('test-event', 'hello world');
Releases
The CHANGELOG.md contains details of the latest releases for this SDK. You can also view all Ably releases on changelog.ably.com.
Contributing
Read the CONTRIBUTING.md guidelines to contribute to Ably.
Support, feedback, and troubleshooting
For help or technical support, visit the Ably Support page.
Ably REST API
This SDK currently supports only the Ably REST API. For realtime capabilities, you can use the MQTT adapter alongside Mosquitto PHP to implement Ably's Realtime features.