polidog / php-chatwork-api
PHP的Chatwork API库
3.2.0
2023-08-17 01:52 UTC
Requires
- php: >=7.4
- ext-json: *
- cakephp/utility: ^4.3
- friendsofphp/php-cs-fixer: ^3.23
- guzzlehttp/guzzle: ^7.0
Requires (Dev)
- phpspec/prophecy: ^1.17
- phpspec/prophecy-phpunit: ^2.0
- phpunit/phpunit: ^9.6
README
这是一个用于从PHP中利用Chatwork API的库。
安装
$ composer require polidog/php-chatwork-api
快速示例
在使用之前,请务必准备ChatWork的API密钥。
请查看API密钥的确认方法。
获取对象
// ChatWork API Clientオブジェクトの初期化
$chatwork = \Polidog\Chatwork\Chatwork::create("chatwork api token");
获取自身信息(API密钥的所有者)
$user = $chatwork->me()->show();
// APIのレスポンスはすべてオブジェクトの形で取得できます
var_dump($user);
获取聊天室列表
$rooms = $chatwork->rooms()->show();
var_dump($rooms);
创建聊天室
// まずはRoomクラスを用意する
$room = new \Polidog\Chatwork\Entity\Room();
$room->name = 'test chat';
// 次にメンバー一覧を用意する
$members = new \Polidog\Chatwork\Entity\Collection\MembersCollection();
$member = new \Polidog\Chatwork\Entity\Member();
$member->role = 'admin';
$member->account = $user;
$members->add($member);
$chatwork->rooms()->create($room, $members)
获取聊天室成员列表
$members = $client->rooms()->members(123456/* roomidを指定します。*/);
var_dump($members);
获取聊天室消息列表
// $force(0: 新しいメッセージのみ, 1: ラスト100メッセージ)
$messages = $client->rooms()->messages($room_id)->show($force);
发送消息
$message = new \Polidog\Chatwork\Entity\Message();
$message->body = 'メッセージ内容';
$client->rooms()->messages($room_id)->create($message);
更新消息
$message = new \Polidog\Chatwork\Entity\Message();
$message->body = 'メッセージ内容';
// $message_id(メッセージのID)
$client->rooms()->messages($room_id)->update($message, $message_id);
删除消息
// $message_id(メッセージのID)
$client->rooms()->messages($room_id)->delete($message_id);
获取聊天室文件列表
$files = $client->rooms()->files($room_id)->show();
获取文件信息
$files = $client->rooms()->files($room_id)->detail($file_id);