kfreiman/pslackr

Slack.com 的入站 Webhook 集成

0.1.4 2014-03-08 23:40 UTC

This package is not auto-updated.

Last update: 2024-09-18 18:45:27 UTC


README

Build Status Code Climate

pslackr [slak-er]

pSlackr 是一个库,用于将 Slack.com 的入站 Webhook 集成到您的应用程序中,使您能够从应用程序向您的群聊频道发送消息

安装

通过 Composer

composer require fullybaked/pslackr

### Slack API Token

Pslackr 使用旧样式的请求发送 token 到 Slack,因此要找到正确的 token,请转到 Slack 的入站 Webhook,您应该会看到

https://hooks.slack.com/services/A111AA1AA/B00BB0BBB/aBCDe1FGHijKlmNoP

无论 Pslackr 在哪里需要 API token,您都需要使用上面示例中的 URL 中的最后一个字符串 aBCDe1FGHijKlmNoP

## 使用

使用提供类的基本用法示例

<?php
require_once 'vendor/autoload.php';

use FullyBaked\Pslackr\Messages\CustomMessage;
use FullyBaked\Pslackr\Pslackr;

$message = new CustomMessage('Testing from Pslackr');

$config = ['token' => 'YOUR_TOKEN', 'domain' => 'YOUR_DOMAIN'];
$slack = new Pslackr($config);
$slack->send($message);

自定义消息

提供的 CustomMessage 类详细说明了可以作为请求一部分发送的可选参数。这些参数允许您自定义消息。

  1. 频道
  2. 用户名
  3. 图标(url 或表情符号)
<?php 

use FullyBaked\Pslackr\Messages\CustomMessage;

$message = new CustomMessage('Testing from Pslackr');

$message->channel('#my-other-channel');

$message->username('slackbot');

$message->iconUrl('http://example.tld/path/to/my.png');
// OR //
$message->iconEmoji(':ghost:');

更改 HTTP 客户端

默认情况下,Pslackr 使用 Guzzle 构建,并将其列为依赖项,但是出于各种原因,您可能希望使用自己的 HTTP 客户端。如果是这样,可以通过使用您选择的 HTTP 客户端实现 Transport 接口来实现。