dmyers/octogun

Simple wrapper for the GitHub v3 API

v0.0.5 2017-08-09 16:12 UTC

This package is auto-updated.

Last update: 2024-04-11 02:39:41 UTC


README

Simple PHP wrapper for the GitHub API. This is an unofficial port of Octokit.rb in PHP. The goal is to have feature parity between languages.

Installation

Simply install using composer:

$ composer require dmyers/octogun

Examples

Show a user

$client = \Octogun\Octogun::users();
$client->user('sferik');

Show a repository

$client = \Octogun\Octogun::repositories();
$client->repo('octogun/octogun.rb');

Authenticated Requests

For methods that require authentication, you'll need to setup a client with your login and password.

$client = new \Octogun\Client(['login' => 'me', 'password' => 'sekret']);
$client->users()->follow('sferik');

Alternately, you can authenticate with a GitHub OAuth2 token.

$client = new \Octogun\Client(['login' => 'me', 'oauth_token' => 'oauth2token']);
$client->users()->follow('sferik');

Using with GitHub Enterprise

To use with GitHub Enterprise, you'll need to set the API and web endpoints before instantiating a client.

$client = new \Octogun\Client(['login' => 'USERNAME', 'password' => 'PASSWORD']);
$client->configuration()->set('api_endpoint', 'https://github.company.com/api/v3';
$client->configuration()->set('web_endpoint', 'https://github.company.com/';

Copyright

Copyright (c) 2013 Derek Myers. See [LICENSE][] for details. [license]: LICENSE.md