| Package Data | |
|---|---|
| Maintainer Username: | antonkomarev |
| Maintainer Contact: | anton@komarev.com (Anton Komarev) |
| Package Create Date: | 2017-05-18 |
| Package Last Update: | 2024-07-11 |
| Home Page: | https://komarev.com |
| Language: | PHP |
| License: | MIT |
| Last Refreshed: | 2024-11-19 03:04:07 |
| Package Statistics | |
|---|---|
| Total Downloads: | 976 |
| Monthly Downloads: | 0 |
| Daily Downloads: | 0 |
| Total Stars: | 18 |
| Total Watchers: | 6 |
| Total Forks: | 6 |
| Total Open Issues: | 0 |
Laravel wrapper for the PHP YouTrack SDK library provides set of tools to interact with JetBrains YouTrack Issue Tracking and Project Management software.
The preferred method is via composer. Follow the installation instructions if you do not already have composer installed.
Once composer is installed, execute the following command in your project root to install this library:
$ composer require cybercog/laravel-youtrack-sdk
Laravel YouTrack SDK designed to work with default config, but it always could be modified. First of all publish it:
php artisan vendor:publish --tag="youtrack-config"
This will create a config/youtrack.php file in your app that you can modify to set your configuration. Also, make sure you check for changes to the original config file in this package between releases.
YouTrack instance location could be defined in .env file:
YOUTRACK_BASE_URI=https://youtrack.custom.domain
Starting with YouTrack 2017.1 release authorization based on permanent tokens is recommended as the main approach for the authorization in your REST API calls.
By default Token authorization will be used. You could redefine it in .env file:
YOUTRACK_AUTH=token
YOUTRACK_TOKEN=your-permanents-token
YOUTRACK_AUTH=cookie
YOUTRACK_USERNAME=username
YOUTRACK_PASSWORD=secret
$youtrack = app(\Cog\Contracts\YouTrack\Rest\Client\Client::class);
As result instantiated \Cog\YouTrack\Rest\Client\YouTrackClient class should be returned.
$method = 'POST'; // GET, POST, PUT, DELETE, PATCH or any custom ones
$response = $youtrack->request($method, '/issue', [
'project' => 'TEST',
'summary' => 'New test issue',
'description' => 'Test description',
]);
You can customize requests created and transferred by a client using request options. Request options control various aspects of a request including, headers, query string parameters, timeout settings, the body of a request, and much more.
$options = [
'debug' => true,
'sink' => '/path/to/dump/file',
];
$response = $youtrack->request('POST', '/issue', [
'project' => 'TEST',
'summary' => 'New test issue',
'description' => 'Test description',
], $options);
$response = $youtrack->get('/issue/TEST-1');
$response = $youtrack->post('/issue', [
'project' => 'TEST',
'summary' => 'New test issue',
'description' => 'Test description',
]);
$response = $youtrack->put('/issue/TEST-1', [
'summary' => 'Updated summary',
'description' => 'Updated description',
]);
$response = $youtrack->delete('/issue/TEST-1');
Each successful request to the API returns instance of \Cog\Contracts\YouTrack\Rest\Response\Response contract. By default it's \Cog\YouTrack\Rest\Response\YouTrackResponse class.
PSR HTTP response could be accessed by calling httpResponse method on API Response.
$youtrackResponse = $youtrack->get('/issue/TEST-1');
$psrResponse = $youtrackResponse->httpResponse();
Returns Set-Cookie headers as string from the HTTP response.
$apiResponse = $youtrack->get('/issue/TEST-1');
$cookieString = $apiResponse->cookie();
Returns Location header from the HTTP response.
$apiResponse = $youtrack->get('/issue/TEST-1');
$location = $apiResponse->location();
$apiResponse = $youtrack->get('/issue/TEST-1');
$location = $apiResponse->toArray();
$apiResponse = $youtrack->get('/issue/TEST-1');
$location = $apiResponse->statusCode();
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Run the tests with:
$ composer test
If you discover any security related issues, please email open@cybercog.su instead of using the issue tracker.
| 
Laravel YouTrack SDK contributors list
Alternatives not found.
Feel free to add more alternatives as Pull Request.
Laravel YouTrack SDK package is open-sourced software licensed under the MIT License by Anton Komarev.CyberCog is a Social Unity of enthusiasts. Research best solutions in product & software development is our passion.