GitHub API v3 client

2.0.1 2016-12-13 13:09 UTC


In 2.0 lib no longer uses guzzle 3.7, instead it has an HTTPlug abstraction layer.

For old version please check:

Build Status StyleCI

A simple Object Oriented wrapper for GitHub API, written with PHP5.

Uses GitHub API v3. The object API is very similar to the RESTful API.


  • Follows PSR-4 conventions and coding standard: autoload friendly
  • Light and fast thanks to lazy loading of API classes
  • Extensively tested and documented


  • PHP >= 5.5
  • Guzzle library,
  • (optional) PHPUnit to run tests.


The new version of php-github-api using Composer. The first step to use php-github-api is to download composer:

$ curl -s http://getcomposer.org/installer | php

Then run the following command to require the library:

$ php composer.phar require knplabs/github-api php-http/guzzle6-adapter

Why php-http/guzzle6-adapter? We are decoupled form any HTTP messaging client with help by HTTPlug. Read about clients in our docs.

Using Laravel?

Laravel GitHub by Graham Campbell might interest you.

Basic usage of php-github-api client


// This file is generated by Composer
require_once 'vendor/autoload.php';

$client = new \Github\Client();
$repositories = $client->api('user')->repositories('ornicar');

From $client object, you can access to all GitHub.

Cache usage

This example uses the PSR6 cache pool redis-adapter. See http://www.php-cache.com/ for alternatives.


// This file is generated by Composer
require_once 'vendor/autoload.php';

use Cache\Adapter\Redis\RedisCachePool;

$client = new \Redis();
$client->connect('', 6379);
// Create a PSR6 cache pool
$pool = new RedisCachePool($client);

$client = new \Github\Client();

// Do some request

// Stop using cache

Using cache, the client will get cached responses if resources haven't changed since last time, without reaching the X-Rate-Limit imposed by github.


See the doc directory for more detailed documentation.


php-github-api is licensed under the MIT License - see the LICENSE file for details


Sponsored by

KnpLabs Team


Thanks to GitHub for the high quality API and documentation.