m4tthumphrey/php-gitlab-api

GitLab API client

Saturday, July 28, 2018
by m4tthumphrey
Repository
27 Watchers
503 Stars
325,922 Installations

PHP
36 Dependents
3 Suggesters
234 Forks
42 Open issues
39 Versions
18 % Grown

The README.md

GitLab PHP API Client

We present a modern GitLab API v4 client for PHP., _(*1)

Banner , _(*2)

, _(*3)

This is strongly based on php-github-api by KnpLabs. With this in mind, we now have very similar clients for:, _(*4)

Bitbucket - bitbucket/client by Graham Campbell.
GitHub - knplabs/github-api by KnpLabs.
GitLab - m4tthumphrey/php-gitlab-api which is this package!

Check out the change log, releases, security policy, license, code of conduct, and contribution guidelines., _(*5)

Installation

This version supports PHP 7.4-8.3. To get started, simply require the project using Composer. You will also need to install packages that "provide" psr/http-client-implementation and psr/http-factory-implementation., _(*6)

Standard Installation

$ composer require "m4tthumphrey/php-gitlab-api:^11.14" \
  "guzzlehttp/guzzle:^7.8" "http-interop/http-factory-guzzle:^1.2"

Framework Integration

Laravel:

$ composer require "graham-campbell/gitlab:^7.5"

Symfony:

$ composer require "zeichen32/gitlabapibundle:^6.1"

We are decoupled from any HTTP messaging client by using PSR-7, PSR-17, PSR-18, and HTTPlug. You can visit HTTPlug for library users to get more information about installing HTTPlug related packages. The framework integration graham-campbell/gitlab is by Graham Campbell and zeichen32/gitlabapibundle is by Jens Averkamp., _(*7)

General API Usage

// Token authentication
$client = new Gitlab\Client();
$client->authenticate('your_http_token', Gitlab\Client::AUTH_HTTP_TOKEN);

// OAuth2 authentication
$client = new Gitlab\Client();
$client->authenticate('your_oauth_token', Gitlab\Client::AUTH_OAUTH_TOKEN);

// An example API call
$project = $client->projects()->create('My Project', [
    'description' => 'This is a project',
    'issues_enabled' => false,
]);

Self-Hosted GitLab

$client = new Gitlab\Client();
$client->setUrl('https://git.yourdomain.com');
$client->authenticate('your_http_token', Gitlab\Client::AUTH_HTTP_TOKEN);

$pager = new Gitlab\ResultPager($client);
$issues = $pager->fetchAll($client->issues(), 'all', [null, ['state' => 'closed']]);

HTTP Client Builder

By providing a Gitlab\HttpClient\Builder to the Gitlab\Client constructor, you can customize the HTTP client. For example, to customize the user agent:, _(*8)

$plugin = new Http\Client\Common\Plugin\HeaderSetPlugin([
    'User-Agent' => 'Foobar',
]);

$builder = new Gitlab\HttpClient\Builder();
$builder->addPlugin($plugin);

$client = new Gitlab\Client($builder);

One can read more about HTTPlug plugins here. Take a look around the API methods, and please feel free to report any bugs, noting our code of conduct., _(*9)

Contributing

We will gladly receive issue reports and review and accept pull requests, in accordance with our code of conduct and contribution guidelines!, _(*10)

$ make install
$ make test

Security

If you discover a security vulnerability within this package, please send an email to Graham Campbell at hello@gjcampbell.co.uk. All security vulnerabilities will be promptly addressed. You may view our full security policy here., _(*11)

License

GitLab PHP API Client is licensed under The MIT License (MIT)., _(*12)

The Versions

28/07 2018

dev-master

9999999-dev https://github.com/m4tthumphrey/php-gitlab-api

GitLab API client

library php-gitlab-api

GitLab API client

m4tthumphrey/php-gitlab-api

The README.md

GitLab PHP API Client

Installation

Standard Installation

Framework Integration

Laravel:

Symfony:

General API Usage

Self-Hosted GitLab

Example with Pager

HTTP Client Builder

Contributing

Security

License

The Versions

dev-master

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.10.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.9.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.8.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.7.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.6.1

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.6.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.5.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.4.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.3.0

The Requires

The Development Requires

by Thibault Duplessis

by KnpLabs Team

by Matt Humphrey

9.2.0

The Requires