oveleon/youtrack-api-php

PHP Adapter for the YouTrack REST API

0.1.5 2023-12-11 12:57 UTC

Requires

• php: >=8.1
• symfony/http-client: ^5.0|^6.0
• symfony/http-foundation: ^5.0|^6.0

AGPL-3.0-or-later

• Daniele Sciannimanica

• symfony
• api
• youtrack

README

This bundle is a PHP wrapper for the YouTrack REST API. It allows communication with your YouTrack instance.

Installation

$ composer require oveleon/youtrack-api-php

Getting Started

use Oveleon\YouTrack\Client;
use Oveleon\YouTrack\HttpClient\HttpClient;

// Create http client to use.
//  You can write your own adapter and use the HttpClientInterface to use e.g. the Guzzle HttpClient.
//  By default, the HttpClient of Symfony is used.
$httpClient = new HttpClient('https://example.myjetbrains.com', 'perm:your-token');

// Create api client
$api = new Client($httpClient);

// Get issues
$issues = $api->issues()
              ->all();

// Refine the query using the filter method
$issues = $api->issues()
              ->filter('state:resolved')
              ->all();

// Cool, but now we would like to specify the return fields...
$issues = $api->issues()
              ->fields(['summary', 'description'])
              ->filter('state:resolved')
              ->all();

// The query on a specific Project can also be refined in exactly the same way
$issues = $api->issues()
              ->filter('state:unresolved')
              ->project('PROJECT_ID');

// The predefined query `findByProject` does nothing more than define a filter for you (In YouTrack the
// filter is described as `query`), so you could also define the following filter to get the same result
$issues = $api->issues()
              ->filter('project:SampleProject')
              ->all();

// Use pagination...
$issues = $api->issues()
              ->paginate(0, 10)
              ->all();

// And now we use another endpoint
$projects = $api->projects()
                ->all();

// ...

Documentation

Read the full Documentation.

References

• YouTrack REST API Documentation
• Use Parsedown or other Markdown parsers to convert descriptions of issues and the like into HTML.
• A simple ticket system based on this API for the open source CMS Contao

Contributing

The API currently supports only a subset of the available options. The basic structure has been prepared so that contributing and adding new endpoints is easy. The structure should be self-explanatory, but feel free to open an issue if you have any questions or comments. Supplementary queries or new entry points must be provided as pull requests.

ToDo:

• Provide more endpoints
• Extend existing endpoints (e.g. create Issue)
• Documentation