library jira

cpliakas/jira

A PHP client for integrating with the JIRA issue & bug tracker software.

Installation

1. Download the composer.phar executable or use the installer., _(*1)

   sh $ curl -sS https://getcomposer.org/installer | php, _(*2)

2. Create a composer.json defining your dependencies. Note that this example is a short version for applications that are not meant to be published as packages themselves. To create libraries/packages please read the guidelines., _(*3)

   json { "require": { "cpliakas/jira": "~1.0" } }, _(*4)

3. Run Composer: php composer.phar install, _(*5)

Authenticating against JIRA

``` php, <sub>(*6)</sub>

use Jira\JiraClient;, <sub>(*7)</sub>

require_once 'vendor/autoload.php';, <sub>(*8)</sub>

// Modify accordingly, note that in some installations the JIRA instance is // in the document root and not in the "jira" subdirectory. $host = 'http://localhost:8090/jira'; $username = 'my.username'; $password = 'my.password';, <sub>(*9)</sub>

$jira = new JiraClient($host); $jira->login($username, $password);, <sub>(*10)</sub>

## Fetching an issue

``` php

$issue = $jira->issue('AB-123')->get();

Creating an issue

``` php, <sub>(*11)</sub>

use Jira\Remote\RemoteIssue;, <sub>(*12)</sub>

$issue = new RemoteIssue(); $issue ->setProject('AB') ->setType(1) // ID can be found via $jira->issueTypes()->get(). ->setSummary('Issue created via the API') ->setDescription('This is a test issue created throug the API');, <sub>(*13)</sub>

$jira->create($issue);, <sub>(*14)</sub>

## Updating an issue

``` php

use Jira\Remote\RemoteFieldValue;

$updates = [];

$value = new RemoteFieldValue();
$updates[] = $value->setId('assignee')->setValues(['jon.doe']);

$value = new RemoteFieldValue();
$updates[] = $value->setId('due-date')->setValues(['2015-12-31']);

$jira->issue('AB-1')->update($updates);

Add user to group

``` php, <sub>(*15)</sub>

use Jira\Remote\RemoteUser; use Jira\Remote\RemoteGroup;, <sub>(*16)</sub>

$user = $jira->user("id")->get(); $group = $jira->group("id")->get();, <sub>(*17)</sub>

$jira->call("addUserToGroup", $group, $user);, <sub>(*18)</sub>

```, <sub>(*19)</sub>