README

一个简单的基于 PHP7.4 编写的 Trello API 对象封装器。

使用 Trello API v1。对象 API 非常类似于 RESTful API。

特性

• 遵循 PSR-0 规范和编码标准：易于自动加载
• 轻量级且快速，因为 API 类支持延迟加载
• 广泛测试
• 支持 Symfony 5

要求

• PHP >= 7.4，并带有 cURL 扩展
• Guzzle 库
• （可选）使用 PHPUnit 运行测试

安装

建议使用 composer

$ composer require alihankoc/php-trello-api

但是，php-trello-api 遵循 PSR-0 命名规范，这意味着您可以轻松地将 php-trello-api 类加载集成到自己的自动加载器中。

基本用法

use Trello\Client;

$client = new Client();
$client->authenticate('api_key', 'token', Client::AUTH_URL_CLIENT_ID);

$boards = $client->api('member')->boards()->all();

$client 对象为您提供了对整个 Trello API 的访问。

使用 Trello 管理器的进阶用法

此包在 API 之上包含一个简单的模型层，并具有一个链式 API，允许对 Trello 对象进行后续操作

use Trello\Client;
use Trello\Manager;

$client = new Client();
$client->authenticate('api_key', 'token', Client::AUTH_URL_CLIENT_ID);

$manager = new Manager($client);

$card = $manager->getCard('547440ad3f8b882bc11f0497');

$card
    ->setName('Test card')
    ->setDescription('Test description')
    ->save();

将 Trello 事件分派到您的应用程序

该服务使用 Symfony EventDispatcher 组件来分派发生在传入 webhooks 上的事件。

查看 Events 类常量以获取名称和相关的事件类。

use Trello\Client;
use Trello\Service;
use Trello\Events;

$client = new Client();
$client->authenticate('api_key', 'token', Client::AUTH_URL_CLIENT_ID);

$service = new Service($client);

// Bind a callable to a given event...
$service->addListener(Events::BOARD_UPDATE, function ($event) {
    $board = $event->getBoard();

    // do something
});

// Check if the current request was made by a Trello webhook
// This will dispatch any Trello event to listeners defined above
$service->handleWebhook();

文档

• 包 API
• 官方 API 文档

贡献

请随意发表评论、提交问题或发起 pull request。

许可

php-trello-api 采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件

致谢

• 由 cdaguerre/php-trello-api 分支