testmonitor / jira-client
The TestMonitor Jira Client.
Installs: 8 365
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 3
Open Issues: 0
Requires
- php: ^8.1
- ext-json: *
- devmoath/jql-builder: ^1.4
- guzzlehttp/guzzle: ^7.0
- league/oauth2-client: ^2.7
- mrjoops/oauth2-jira: ^0.3
- testmonitor/adf-tools: ^1.2
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.1
- mockery/mockery: ~1.0
- phpunit/phpunit: ^10.0
- scrutinizer/ocular: ^1.9
- squizlabs/php_codesniffer: ^3.7
README
This package provides a very basic, convenient, and unified wrapper for Jira.
Table of Contents
Installation
To install the client you need to require the package using composer:
$ composer require testmonitor/jira-client
Use composer's autoload:
require __DIR__.'/../vendor/autoload.php';
You're all set up now!
Usage
This client only supports oAuth authentication. You'll need an Atlassian Jira application to proceed. If you haven't done so, please read up with the Jira authentication docs on how to create an application.
When your Jira application is up and running, start with the oAuth authorization:
$oauth = [ 'clientId' => '12345', 'clientSecret' => 'abcdef', 'redirectUrl' => 'https://redirect.myapp.com/', ]; $jira = new \TestMonitor\Jira\Client($oauth); header('Location: ' . $jira->authorizationUrl()); exit();
This will redirect the user to a page asking confirmation for your app getting access to Jira. Make sure your redirectUrl points back to your app. This URL should point to the following code:
$oauth = [ 'clientId' => '12345', 'clientSecret' => 'abcdef', 'redirectUrl' => 'https://redirect.myapp.com/', ]; $jira = new \TestMonitor\Jira\Client($oauth); $token = $jira->fetchToken($_REQUEST['code']);
When everything went ok, you should have an access token (available through Token object).
For any subsequent action, you'll need to retrieve your cloud ID to proceed:
$oauth = [ 'clientId' => '12345', 'clientSecret' => 'abcdef', 'redirectUrl' => 'https://redirect.myapp.com/', ]; $token = new \TestMonitor\Jira\AccessToken('eyJ0...', '0/34ccc...', 1574601877); // the token you got last time $jira = new \TestMonitor\Jira\Client($oauth, null, $token); $account = $jira->account();
Use the cloud ID as a parameter when instantiating the client:
$oauth = [ 'clientId' => '12345', 'clientSecret' => 'abcdef', 'redirectUrl' => 'https://redirect.myapp.com/', ]; $token = new \TestMonitor\Jira\AccessToken('eyJ0...', '0/34ccc...', 1574601877); $jira = new \TestMonitor\Jira\Client($oauth, $account->id, $token);
That's it!
Please note that the access token will be valid for one hour. When it expires, you'll need to refresh it:
if ($token->expired()) { $newToken = $jira->refreshToken(); }
The new token will be valid again for the next hour.
Examples
Retrieve the details for a project using its key:
$project = $jira->project('KEY');
Or create a new issue using the first available issue type:
$issueTypes = $jira->issueTypes('KEY'); $issue = $jira->createIssue(new \TestMonitor\Jira\Resources\Issue([ 'summary' => 'It is time Marty!', 'description' => 'Great Scot!', 'project' => $project, 'type' => $issueType[0], ]));
Tests
The package contains integration tests. You can run them using PHPUnit.
$ vendor/bin/phpunit
Changelog
Refer to CHANGELOG for more information.
Contributing
Refer to CONTRIBUTING for contributing details.
Credits
- Thijs Kok - Lead developer - ThijsKok
- Stephan Grootveld - Developer - Stefanius
- Frank Keulen - Developer - FrankIsGek
License
The MIT License (MIT). Refer to the License for more information.