tzk/taiga-php

A PHP wrapper for the Taiga.io API

Monday, March 19, 2018
by TZK-
Repository
3 Watchers
10 Stars
1,789 Installations

PHP
1 Dependents
0 Suggesters
5 Forks
1 Open issues
16 Versions
1 % Grown

The README.md

TaigaPHP

, _(*1)

TaigaPHP is a PHP wrapper used to handle the Taiga.io API easily., _(*2)

(If you want to use this library with Laravel 5.x, take a look at https://github.com/TZK-/TaigaLaravel), _(*3)

Installation (Composer)

TaigaPHP has been written and tested for PHP >=5.5 and and earlier versions. The only constraint is to have the cURL extension enabled., _(*4)

To install the library, just run the command below:, _(*5)

composer require tzk/taiga-php

Authentication

To send HTTP request to the API, you'll need to generate an Auth token., _(*6)

The wrapper has a function to help you and you can just do like the code below or see https://taigaio.github.io/taiga-doc/dist/api.html#_authentication:, _(*7)

// The API Url
$baseUrl = 'https://api.taiga.io/api/v1/';

// The credentials used for the authentification
$credentials = [
    'username' => 'USERNAME',
    'password' => 'PASSWORD',
    'type'    => 'normal'
];

echo generate_taiga_auth_token($baseUrl, $credentials);

Get Taiga instance

$request = TZK\Taiga\CurlRequest();

$headers = [
    'language' => 'fr',
    'x-disable-pagination' => true
];

$taiga = new TZK\Taiga\Taiga($request, $baseUrl, $auth_token, $headers);

Change configuration on the fly

You can change the configuration through HTTP headers on the fly., _(*8)

You just need to call magic method which has the same name as the header you wanna set prefixed by 'set'., _(*9)

Some headers are composed by multiple words separated by dashed (Ex. Accept-Language)., _(*10)

To get it works, you should write the header name without dashes and in a camel-case format., _(*11)

Example

$taiga->setAcceptLanguage('fr')->setAuthorization('Bearer ' . $auth_token);

To ease changing auth token or language on the fly, you can use shortcuts specified in src/config/header_shortcuts.php, _(*12)

// In header_shortcuts.php
return [
    'language' => [
        'header' => 'Accept-Language',
    ],
    'authToken' => [
        'header' => 'Authorization',
        'prefix' => 'Bearer ',
    ],
];

// Will produce the same as the previous example.
$taiga->setLanguage('fr')->setAuthToken($token);

Register a new service

The wrapper is based on 'Services' which wrap the API calls., _(*13)

<?php

namespace TZK\Taiga\Services;

use TZK\Taiga\RestClient;
use TZK\Taiga\Service;

class IssueTypes extends Service
{
    public function __construct(RestClient $taiga)
    {
        parent::__construct($taiga, 'issue-types');
    }

    public function getList(array $param)
    {
        return $this->get(null, $param);
    }

    public function create(array $data)
    {
        return $this->post(null, [], $data);
    }

    public function getById($id)
    {
        return $this->get($id);
    }

    public function edit($id, array $data)
    {
        return $this->put($id, [], $data);
    }

    public function remove($id)
    {
        return $this->delete($id);
    }

    public function vote($id)
    {
        return $this->post(sprintf('%s/upvote', $id));
    }

    public function bulkUpdateOrder(array $data)
    {
        return $this->post('bulk_update_order', [], $data);
    }
}

As you can see, it is very simple to add your own methods and interact with the API itself., _(*14)

If you wanna add new services, the only thing you have to do is to create a new class inside the Service folder and extends the TZK\Taiga\Service class., _(*15)

TaigaPHP will automatically load the service for you and it will be accessible from a public method which has the same name as your service., _(*16)

Examples

Get issue types

// Access with the 'issueTypes' public method
$issues = $taiga->issueTypes()->getList(['project' => $projectId]);

Create a new issue

// Access with the 'issues' public method
$issues = $taiga->issues()->create(['project' => $projectId, 'subject' => 'My super issue']);

Supported features

Applications
Application Tokens
Epics
Issues
Issue Statuses
Issue Types
Priorities
Projects
Resolver
Severities
Users
UserStories

Tests

The library has been tested with Kahlan. If you want to run tests just run the command:, _(*17)

./vendor/bin/kahlan

At the moment, the tests are covering the main fatures of the wrapper., _(*18)

Contributing

TaigaPHP offers a great starting coverage, but there are some endpoints/tests missing., _(*19)

If you use this wrapper, feel free to share if you have found bugs or added new endpoints / features or tests by opening a new PR., _(*20)

The Versions

19/03 2018

dev-feature/attachments

A PHP wrapper for the Taiga.io API

library taiga-php

A PHP wrapper for the Taiga.io API

tzk/taiga-php

The README.md

TaigaPHP

Installation (Composer)

Authentication

Get Taiga instance

Change configuration on the fly

Example

Register a new service

Examples

Get issue types

Create a new issue

Supported features

Tests

Contributing

The Versions

dev-feature/attachments

The Requires

The Development Requires

dev-master

The Requires

The Development Requires

v2.0.4

The Requires

The Development Requires

v2.0.3

The Requires

The Development Requires

v2.0.2

The Requires

The Development Requires

v2.0.1

The Requires

The Development Requires

v2.0.0

The Requires

The Development Requires

v1.1.0

The Requires

v1.0.7

The Requires

v1.0.6

The Requires

v1.0.5

The Requires

v1.0.4

The Requires

v1.0.3

The Requires

v1.0.2

The Requires

v1.0.1

The Requires

v1.0

The Requires