dmanetwork / slack
与Slack (slack.com) 交互的接口。这里的API尚未完全实现,目前只支持向频道发送消息。
v2.0.0
2016-02-26 01:59 UTC
Requires
- php: >=5.4.0
- netherphp/object: ^2.0.0
- netherphp/option: ^1.0.0
This package is auto-updated.
Last update: 2024-09-05 17:55:29 UTC
README
用于通过Slack API向频道发送消息的Slack (slack.com) 小工具。
安装
使用Composer。
简单用法
在配置应用程序配置时尽早定义Slack选项。您必须指定的唯一选项是API访问令牌,您可以在登录到http://api.slack.com时生成此令牌。
Nether\Option::Set('slack-token','YOUR-SLACK-TOKEN');
创建一个客户端实例以与Slack API交互。
$slack = new DMA\Slack\Client;
然后您可以发送消息。
$slack->Send('Hello from our Slack enabled app.');
如果您不更改其他任何选项,您应该在您的#general频道中看到来自Optimus Prime的消息。
高级用法
在应用程序配置时间提供更多选项...
这些都是在应用程序配置时间可以设置的选项。
Nether\Option::Set([
'slack-token' => 'YOUR-SLACK-TOKEN',
'slack-default-channel' => '#channel',
'slack-default-name' => 'bot name of choice',
'slack-default-icon' => 'url to public accessable image for chat icon',
'slack-channels' => [ 'action-name' => 'channel', ... ]
]);
在实例时间提供更多选项(覆盖前一个选项)...
这些是在创建实例时间可以设置的选项。
$slack = new DMA\Slack\Client([
'DefaultChannel' => '#channel',
'DefaultName' => 'bot name of choice',
'DefaultIcon' => 'url to icon',
'Token' => 'YOUR-SLACK-TOKEN'
]);
在发送消息时间提供更多选项...
在发送消息时间可以设置的选项。
$slack->Send('message here',[
'Channel' => '#DifferentChannel',
'Name' => 'Different Bot Name',
'Icon' => 'url to different icon'
]);
如果您只想发送到默认频道或用户以外的其他频道。
$slack->SendToChannel($chan,$msg);
或者发送到由任何配置的操作指定的不同频道。
// send user-add action notifications to the team.
$slack->SendToChannel('--user-add',$msg);
发送我们没有包装的API请求...
$slack->SendRequest(string method, array args);
方法名称是Slack文档中指定的API URL的最后部分。然后,参数数组将是一个关联数组,其中的键是Slack中提到的参数名称,值是要发送的值。
版权
本软件版权所有(c)2014 Dream Machine Association, LLC。有关更多信息,请参阅捆绑的LICENSE文件(BSD-2-Clause)。