PHPackages                             ipalaus/buffer-php-sdk - 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. [API Development](/categories/api)
4. /
5. ipalaus/buffer-php-sdk

ActiveLibrary[API Development](/categories/api)

ipalaus/buffer-php-sdk
======================

Unofficial Buffer SDK for PHP.

v1.1.1(12y ago)148.9k14[2 issues](https://github.com/ipalaus/buffer-php-sdk/issues)[2 PRs](https://github.com/ipalaus/buffer-php-sdk/pulls)MITPHPPHP >=5.3.0

Since Dec 23Pushed 10y ago1 watchersCompare

[ Source](https://github.com/ipalaus/buffer-php-sdk)[ Packagist](https://packagist.org/packages/ipalaus/buffer-php-sdk)[ RSS](/packages/ipalaus-buffer-php-sdk/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (2)Versions (4)Used By (0)

Buffer PHP SDK
==============

[](#buffer-php-sdk)

[![Build Status](https://camo.githubusercontent.com/24b1619345801726d87e019d4d6b52a66cba84dc2cf06e35c1cb55c6eb10032f/68747470733a2f2f7472617669732d63692e6f72672f6970616c6175732f6275666665722d7068702d73646b2e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/ipalaus/buffer-php-sdk)[![Coverage Status](https://camo.githubusercontent.com/05bc856ec57ed8cacd27caddab5d89969b81caf3bb0004cb2491d17fc8f4e0e0/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6970616c6175732f6275666665722d7068702d73646b2f62616467652e706e67)](https://coveralls.io/r/ipalaus/buffer-php-sdk)

Unofficial Buffer SDK for PHP.

This package is compliant with [PSR-0](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md), [PSR-1](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md), and [PSR-2](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md). If you notice compliance oversights, please send a patch via pull request.

Installation
------------

[](#installation)

Via [Composer](http://getcomposer.org):

```
{
    "require": {
        "ipalaus/buffer-php-sdk": "1.1.*"
    }
}
```

Usage
-----

[](#usage)

First of all, you need a valid token to be able to send authorized requests to the Buffer API. You can [register your app](http://bufferapp.com/developers/apps) and use the provided access token or get a user's token [authenticating](http://bufferapp.com/developers/api/oauth) with OAuth 2.0.

Once you have a valid token, you can create a new `TokenAuthorization` instance and then create a `Client` instance:

```
use Ipalaus\Buffer\Client;
use Ipalaus\Buffer\TokenAuthorization;

$auth = new TokenAuthorization('access_token');

$client = new Client($auth);
```

Methods
-------

[](#methods)

### User

[](#user)

A user represents a single Buffer user account.

#### Get a user

[](#get-a-user)

Returns a single user.

```
$user = $client->getUser();
```

### Profiles

[](#profiles)

A Buffer profile represents a connection to a single social media account.

#### Get profiles

[](#get-profiles)

Returns an array of social media profiles connected to a users account.

```
$profiles = $client->getProfiles();
```

#### Get a single profile

[](#get-a-single-profile)

Returns details of the single specified social media profile.

```
$client->getProfile($id);
```

#### Get posting schedules

[](#get-posting-schedules)

Returns details of the posting schedules associated with a social media profile.

```
$client->getProfileSchedules($id);
```

#### Set posting schedules

[](#set-posting-schedules)

Set the posting schedules for the specified social media profile.

```
use Ipalaus\Buffer\Schedule;

$schedule = new Schedule;

// you can pass a single string or an array
$schedule->addDay('mon');
$schedule->addDay(array('tue', 'wed'));

// same for time
$schedule->addTime('09:00');
$schedule->addTime(array('12:00', '15:00'));

$client->updateProfileSchedules('id', $schedule);

// alternative syntax, even shorter
$schedule = new Schedule(array('mon', 'tue', 'wed'), array('09:00', '12:00', '15:00'));
$client->updateProfileSchedules($id, $schedule);

// multiple schedules
$weekdays = new Schedule(array('mon', 'tue', 'wed', 'thu', 'fri'), array('09:00', '12:00', '16:00');
$weekends = new Schedule(array('sat', 'sun'), array('12:00', '18:00');

$client->updateProfileSchedules($id, array($weekdays, $weekends));
```

**Note**: updating multiple schedules only works for paid plans. Unfortunately, if we try to update multiple schedules in a free plan it will simply erase everything.

### Updates

[](#updates)

An update represents a single post to a single social media account. An update can also include media attachments such as pictures and links.

#### Get a update

[](#get-a-update)

Returns a single social media update.

```
$client->getUpdate('id');
```

#### Get pending updates

[](#get-pending-updates)

Returns an array of updates that are currently in the buffer for an individual social media profile.

```
$client->getProfilePendingUpdates('id');

// optional parameters
$client->getProfilePendingUpdates($id, $page = null, $count = null, $since = null, $utc = false)
```

- `$page integer` Specifies the page of status updates to receive. If not specified the first page of results will be returned.
- `$count integer` Specifies the number of status updates to receive. If provided, must be between 1 and 100.
- `$since integer` Specifies a unix timestamp which only status updates created after this time will be retrieved.
- `$utc boolean` If utc is set times will be returned relative to UTC rather than the users associated timezone.

#### Get sent updates

[](#get-sent-updates)

Returns an array of updates that have been sent from the buffer for an individual social media profile.

```
$client->getProfileSentUpdates($id);

// optional parameters
$client->getProfileSentUpdates($id, $page = null, $count = null, $since = null, $utc = false);
```

- `$page integer` Specifies the page of status updates to receive. If not specified the first page of results will be returned.
- `$count integer` Specifies the number of status updates to receive. If provided, must be between 1 and 100.
- `$since integer` Specifies a unix timestamp which only status updates created after this time will be retrieved.
- `$utc boolean` If utc is set times will be returned relative to UTC rather than the users associated timezone.

#### Get update interactions

[](#get-update-interactions)

Returns the detailed information on individual interactions with the social media update such as favorites, retweets and likes.

```
$client->getUpdateInteractions($id);

// optional parameters
$client->getUpdateInteractions($id, $page = null, $count = null, $event = null);
```

- `$page integer` Specifies the page of interactions to receive. If not specified the first page of results will be returned.
- `$count integer` Specifies the number of interactions to receive. If provided, must be between 1 and 100.
- `$event string` Specifies a type of event to be retrieved, for example "retweet", "favorite", "like", "comment", "mention" or "share". They can also be plural (e.g., "shares"). Plurality has no effect other than visual semantics.

**Note**: I think there is a bug in this endpoint. I've to dig dipper to find out what's going on.

#### Reorder updates

[](#reorder-updates)

Edit the order at which statuses for the specified social media profile will be sent out of the buffer.

```
$client->reorderProfileUpdates($id, array($update1, $update3, $update5));

// optional parameters
$client->reorderProfileUpdates($id, $order, $offset = null, $utc = false)
```

- `$order array` An ordered array of status update id’s. This can be a partial array in combination with the offset parameter or a full array of every update in the profiles Buffer.
- `$offset integer` Specifies the number of status updates to receive. If provided, must be between 1 and 100.
- `$utc boolean` If utc is set times will be returned relative to UTC rather than the users associated timezone.

#### Randomize updates order

[](#randomize-updates-order)

Randomize the order at which statuses for the specified social media profile will be sent out of the buffer.

```
$client->shuffleProfileUpdates($id);

// optional parameters
$client->shuffleProfileUpdates($id, $count = null, $utc = false);
```

- `$count integer` Specifies the number of status updates returned. These will correspond to the first status updates that will be posted.
- `$utc boolean` If utc is set times will be returned relative to UTC rather than the users associated timezone.

#### Create a update

[](#create-a-update)

Create one or more new status updates.

```
use Ipalaus\Buffer\Update;

$update = new Update;

$update->text = 'Check out my website!';
$update->addProfile($id);

$update->shorten = 'false'; // optional, default: true
$update->now = 'false'; // optional, default: true
$update->top = 'true'; // optional, default: false
$update->attachment = 'false'; // optional, default: true

// adding media is optional, available options: link, description, picture, thumbnail
$update->addMedia('link', 'http://ipalaus.com');
$update->addMedia('description', 'Isern Palaus personal website.');
$update->addMedia('picture', 'http://ipalaus.com/img/isern-palaus_smile.jpg');
$update->addMedia('thumbnail', 'http://ipalaus.com/img/isern-palaus_smile.jpg'); // required with picture

// schedule a update is optional
$update->schedule(time() + 3600); // you can use timestamp
$update->schedule('2013-12-23 12:03:23'); // or a valid date/time string

$client->createUpdate($update);
```

- `Update::$text string` The status update text.
- **Profiles** Profile id’s that the status update should be sent to. Invalid profile\_id’s will be silently ignored.
- `Update::$shorten boolean` If shorten is false links within the text will not be automatically shortened, otherwise they will.
- `Update::$now boolean` If now is set, this update will be sent immediately to all profiles instead of being added to the buffer.
- `Update::$top boolean` If top is set, this update will be added to the top of the buffer and will become the next update sent.
- **Media** Media to be attached to the update, currently accepts link, description and picture parameters.
- **Schedule** A date describing when the update should be posted. Overrides any top or now parameter.

#### Update an update

[](#update-an-update)

Edit an existing, individual status update.

```
$update = new Update;
$update->text = 'Lorem ipsum'; // required

$client->updateUpdate($id, $update);
```

- `Update::$text string` The status update text.
- `Update::$now boolean` If now is set, this update will be sent immediately to all profiles instead of being added to the buffer.
- **Media** Media to be attached to the update, currently accepts link, description and picture parameters.
- **Schedule** A date describing when the update should be posted. Overrides any top or now parameter.

#### Share an update

[](#share-an-update)

Immediately shares a single pending update and recalculates times for updates remaining in the queue.

```
$client->shareUpdate($id);
```

#### Destroy an update

[](#destroy-an-update)

Permanently delete an existing status update.

```
$client->destroyUpdate($id);
```

#### Move update to top

[](#move-update-to-top)

Move an existing status update to the top of the queue and recalculate times for all updates in the queue. Returns the update with its new posting time.

```
$client->moveUpdateToTop($id);
```

### Links

[](#links)

A link represents a unique URL that has been shared through Buffer.

#### Shares

[](#shares)

Returns an object with a the numbers of shares a link has had using Buffer. **www** will be stripped, but other subdomains will not.

```
$client->getLinkShares('http://ipalaus.com');
```

### Info

[](#info)

This namespace is used for auxilary information that can be useful when creating your app.

#### Get configuration

[](#get-configuration)

Returns an object with the current configuration that Buffer is using, including supported services, their icons and the varying limits of character and schedules.

The services keys map directly to those on profiles and updates so that you can easily show the correct icon or calculate the correct character length for an update.

```
$client->getConfigurationInfo();
```

Buffer Button
-------------

[](#buffer-button)

You can also generate a [Buffer Button](https://bufferapp.com/extras/button) with the SDK:

```
use Ipalaus\Buffer\Button;

// available count styles: vertical, horizontal or none
echo Button::create('vertical');

// our even simpler
echo Button::vertical();

// optional parameters
Button::create($style, $tweet = null, $url = null, $username = null, $picture = null);
```

- `$style string` Where the counter is positioned, options: vertical, horizontal or none.
- `$tweet string` Blank to use title of the page the button is on.
- `$url string` Blank to use URL for the page the button is on
- `$username string` Twitter username to mention.
- `$picture string ` URL of picture you want to share (optional).

Support
-------

[](#support)

Bugs and feature request are tracked on [GitHub](https://github.com/ipalaus/buffer-php-sdk/issues).

License
-------

[](#license)

This package is released under the MIT License. See the bundled [LICENSE](https://github.com/ipalaus/buffer-php-sdk/blob/master/LICENSE) file for details.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 74.3% 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 ~1 days

Total

3

Last Release

4527d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/65a08025c88ebc33883d89af8d83e928d43cde7800c64f7b29250c020dfbbd1b?d=identicon)[ipalaus](/maintainers/ipalaus)

---

Top Contributors

[![ipalaus](https://avatars.githubusercontent.com/u/248183?v=4)](https://github.com/ipalaus "ipalaus (26 commits)")[![dhjw](https://avatars.githubusercontent.com/u/6329963?v=4)](https://github.com/dhjw "dhjw (9 commits)")

---

Tags

apisdkBuffer

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ipalaus-buffer-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/ipalaus-buffer-php-sdk/health.svg)](https://phpackages.com/packages/ipalaus-buffer-php-sdk)
```

###  Alternatives

[deepseek-php/deepseek-php-client

deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities.

47073.9k5](/packages/deepseek-php-deepseek-php-client)[corbanb/freebird-php

Twitter API v1.1 Application only authoization library

148.6k](/packages/corbanb-freebird-php)

PHPackages © 2026

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