Skip to content
A simple PHP GitHub API client, Object Oriented, tested and documented. For 5.5+.
Branch: master
Clone or download
acrobat Merge pull request #803 from acrobat/gist-missing-endpoints
Missing gist revision api endpoint
Latest commit 325b315 Aug 13, 2019


Build Status StyleCI Latest Stable Version Total Downloads Latest Unstable Version Monthly Downloads Daily Downloads

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

Uses GitHub API v3 & supports GitHub API v4. The object API (v3) is very similar to the RESTful API.


  • Light and fast thanks to lazy loading of API classes
  • Extensively tested and documented



Via Composer:

$ composer require knplabs/github-api php-http/guzzle6-adapter "^1.1"

Why php-http/guzzle6-adapter? We are decoupled from 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 __DIR__ . '/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 for alternatives.


// This file is generated by Composer
require_once __DIR__ . '/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


Please read this post first.

This library is maintained by the following people (alphabetically sorted) :

  • @acrobat
  • @Nyholm


Thanks to GitHub for the high quality API and documentation.

You can’t perform that action at this time.