PHPackages                             testmonitor/jira-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. testmonitor/jira-client

ActiveLibrary[API Development](/categories/api)

testmonitor/jira-client
=======================

The TestMonitor Jira Client.

v3.0.0(8mo ago)18.9k↓50%3MITPHPPHP ^8.1

Since Dec 8Pushed 6mo ago2 watchersCompare

[ Source](https://github.com/testmonitor/jira-client)[ Packagist](https://packagist.org/packages/testmonitor/jira-client)[ RSS](/packages/testmonitor-jira-client/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (9)Versions (11)Used By (0)

TestMonitor Jira Client
=======================

[](#testmonitor-jira-client)

[![Latest Stable Version](https://camo.githubusercontent.com/6782bb28855c136411b2446d663f211e391172c997b05137394577148a5190f2/68747470733a2f2f706f7365722e707567782e6f72672f746573746d6f6e69746f722f6a6972612d636c69656e742f762f737461626c65)](https://packagist.org/packages/testmonitor/jira-client)[![CircleCI](https://camo.githubusercontent.com/46d2edd1c49e29f247e09b54d0ae67c729a8f8d27299a6fac294a62796f968dc/68747470733a2f2f696d672e736869656c64732e696f2f636972636c6563692f70726f6a6563742f6769746875622f746573746d6f6e69746f722f6a6972612d636c69656e742e737667)](https://circleci.com/gh/testmonitor/jira-client)[![StyleCI](https://camo.githubusercontent.com/3dee1bda39804664797178f3e8b9dd2cc762462cf68e1a3425e664241b075cf2/68747470733a2f2f7374796c6563692e696f2f7265706f732f3232323935373434382f736869656c64)](https://styleci.io/repos/222957448)[![codecov](https://camo.githubusercontent.com/433ad1423b8deda74969dae4ebd127d7b7d2439989ac2bbceea78f8918eda149/68747470733a2f2f636f6465636f762e696f2f67682f746573746d6f6e69746f722f6a6972612d636c69656e742f67726170682f62616467652e7376673f746f6b656e3d32473438394a45564138)](https://codecov.io/gh/testmonitor/jira-client)[![License](https://camo.githubusercontent.com/9f83852991a390675d8c5115ec5d411eb8016816bc8cbee34454b7cba9d1faa7/68747470733a2f2f706f7365722e707567782e6f72672f746573746d6f6e69746f722f6a6972612d636c69656e742f6c6963656e7365)](https://packagist.org/packages/testmonitor/jira-client)

This package provides a very basic, convenient, and unified wrapper for Jira.

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Usage](#usage)
- [Examples](#examples)
- [Tests](#tests)
- [Changelog](#changelog)
- [Contributing](#contributing)
- [Credits](#credits)
- [License](#license)

Installation
------------

[](#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
-----

[](#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](https://developer.atlassian.com/console/myapps/) 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
--------

[](#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
-----

[](#tests)

The package contains integration tests. You can run them using PHPUnit.

```
$ vendor/bin/phpunit

```

Changelog
---------

[](#changelog)

Refer to [CHANGELOG](CHANGELOG.md) for more information.

Contributing
------------

[](#contributing)

Refer to [CONTRIBUTING](CONTRIBUTING.md) for contributing details.

Credits
-------

[](#credits)

- **Thijs Kok** - *Lead developer* - [ThijsKok](https://github.com/thijskok)
- **Stephan Grootveld** - *Developer* - [Stefanius](https://github.com/stefanius)
- **Frank Keulen** - *Developer* - [FrankIsGek](https://github.com/frankisgek)

License
-------

[](#license)

The MIT License (MIT). Refer to the [License](LICENSE.md) for more information.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance64

Regular maintenance activity

Popularity25

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 59.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~234 days

Recently: every ~131 days

Total

10

Last Release

240d ago

Major Versions

v1.4.0 → v2.0.02024-04-10

v2.3.0 → v3.0.02025-09-17

PHP version history (4 changes)v1.0.0PHP ^7.2

v1.3.0PHP ^7.4|^8.0

v1.4.0PHP ^8.0

v2.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/47f66133b6b4806a16aaed043daa733f5e97adb7a10c9982d01a1cda9f492040?d=identicon)[stefanius](/maintainers/stefanius)

![](https://www.gravatar.com/avatar/39f48c881813b7d3b044ca5660aa5ab9e60b5dd7c34ed4a47acbb11bd20b7593?d=identicon)[thijskok](/maintainers/thijskok)

---

Top Contributors

[![thijskok](https://avatars.githubusercontent.com/u/1344550?v=4)](https://github.com/thijskok "thijskok (40 commits)")[![stefanius](https://avatars.githubusercontent.com/u/2707905?v=4)](https://github.com/stefanius "stefanius (26 commits)")[![Frankisgek](https://avatars.githubusercontent.com/u/487218?v=4)](https://github.com/Frankisgek "Frankisgek (1 commits)")

---

Tags

clientjiratestmonitor

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/testmonitor-jira-client/health.svg)

```
[![Health](https://phpackages.com/badges/testmonitor-jira-client/health.svg)](https://phpackages.com/packages/testmonitor-jira-client)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[resend/resend-php

Resend PHP library.

564.7M21](/packages/resend-resend-php)[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[markrogoyski/numverify-api-client-php

Numverify API Client for PHP

1220.9k](/packages/markrogoyski-numverify-api-client-php)[spinen/laravel-clickup

SPINEN's Laravel Package for ClickUp.

282.2k](/packages/spinen-laravel-clickup)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
