README

一个简单的PHP包，用于通过Slack的入站Web钩子发送消息，注重易用性和优雅的语法。

• Laravel集成: Slack for Laravel
• Symfony集成: NexySlackBundle

要求

• PHP 5.5, 5.6, 7.0或HHVM

安装

您可以使用Composer包管理器安装此包。您可以在项目根目录下运行此命令来安装它

composer require razorpay/slack

然后，为该包在您的Slack账户上创建一个入站Web钩子。您需要Web钩子URL来实例化客户端（或如果使用Laravel，则为配置文件）。

基本用法

实例化客户端

// Instantiate without defaults
$client = new Razorpay\Slack\Client('https://hooks.slack.com/...');

// Instantiate with defaults, so all messages created
// will be sent from 'Cyril' and to the #accounting channel
// by default. Any names like @regan or #channel will also be linked.
$settings = [
	'username' => 'Cyril',
	'channel' => '#accounting',
	'link_names' => true
];

$client = new Razorpay\Slack\Client('https://hooks.slack.com/...', $settings);

设置

默认设置相当不错，但您可能希望为您的客户端设置默认行为，以便用于所有发送的消息。 所有设置都是可选的，您无需提供任何内容。如果没有提供，我们将回退到Web钩子集成上配置的内容，这些内容在Slack上管理，或者使用我们合理的默认设置。

发送消息

发送基本消息（预览）

$client->send('Hello world!');

向非默认频道发送消息

$client->to('#accounting')->send('Are we rich yet?');

向用户发送消息

$client->to('@regan')->send('Yo!');

以不同的bot名称向频道发送消息（预览）

$client->from('Jake the Dog')->to('@FinnTheHuman')->send('Adventure time!');

使用不同图标发送消息（预览）

// Either with a Slack emoji
$client->to('@regan')->withIcon(':ghost:')->send('Boo!');

// or a URL
$client->to('#accounting')->withIcon('http://example.com/accounting.png')->send('Some accounting notification');

使用队列发送消息

$client->to('#accounting')->withIcon('http://example.com/accounting.png')->queue('Some accounting notification');

发送附件（预览）

$client->to('#operations')->attach([
	'fallback' => 'Server health: good',
	'text' => 'Server health: good',
	'color' => 'danger',
])->send('New alert from the monitoring system'); // no message, but can be provided if you'd like

带有字段发送附件（预览）

$client->to('#operations')->attach([
	'fallback' => 'Current server stats',
	'text' => 'Current server stats',
	'color' => 'danger',
	'fields' => [
		[
			'title' => 'CPU usage',
			'value' => '90%',
			'short' => true // whether the field is short enough to sit side-by-side other fields, defaults to false
		],
		[
			'title' => 'RAM usage',
			'value' => '2.5GB of 4GB',
			'short' => true
		]
	]
])->send('New alert from the monitoring system'); // no message, but can be provided if you'd like

带有作者发送附件（预览）

$client->to('@regan')->attach([
	'fallback' => 'Keep up the great work! I really love how the app works.',
	'text' => 'Keep up the great work! I really love how the app works.',
	'author_name' => 'Jane Appleseed',
	'author_link' => 'https://yourapp.com/feedback/5874601',
	'author_icon' => 'https://static.pexels.com/photos/61120/pexels-photo-61120-large.jpeg'
])->send('New user feedback');

高级用法

Markdown

默认情况下，Markdown对消息文本启用，但禁用附件字段。此行为可以在设置中配置，或即时配置

启用或禁用Markdown发送消息

$client->to('#weird')->disableMarkdown()->send('Disable *markdown* just for this message');

$client->to('#general')->enableMarkdown()->send('Enable _markdown_ just for this message');

指定哪些字段应启用Markdown的附件

$client->to('#operations')->attach([
	'fallback' => 'It is all broken, man',
	'text' => 'It is _all_ broken, man',
	'pretext' => 'From user: *JimBob*',
	'color' => 'danger',
	'mrkdwn_in' => ['pretext', 'text']
])->send('New alert from the monitoring system');

显式消息创建

为了方便，通过在客户端上调用消息方法隐式创建消息对象。但是，我们可以显式地这样做，以避免调用魔术方法。

// Implicitly
$client->to('@regan')->send('I am sending this implicitly');

// Explicitly
$message = $client->createMessage();

$message->to('@regan')->setText('I am sending this explicitly');

$message->send();

通过队列发送

// $queue is an instance of Illuminate\Queue\QueueManager
$client = new Razorpay\Slack\Client('http://your.slack.endpoint', $settings, $queue);
$client->to('@regan')->queue('I am sending this implicitly');

如果您正在使用Laravel服务提供程序，您的默认队列将自动使用。

附件

当使用附件时，最简单的方法是提供示例中所示的数据数组，实际上，这些数据在底层转换为Attachment对象。您还可以将Attachment对象附加到消息上。

$attachment = new Attachment([
	'fallback' => 'Some fallback text',
	'text' => 'The attachment text'
]);

// Explicitly create a message from the client
// rather than using the magic passthrough methods
$message = $client->createMessage();

$message->attach($attachment);

// Explicitly set the message text rather than
// implicitly through the send method
$message->setText('Hello world')->send();

每个附件字段也是一个对象，即 AttachmentField。它们也可以用来代替数组中的数据

$attachment = new Attachment([
	'fallback' => 'Some fallback text',
	'text' => 'The attachment text',
	'fields' => [
		new AttachmentField([
			'title' => 'A title',
			'value' => 'A value',
			'short' => true
		])
	]
]);

如果您有很多附件和字段，您也可以直接设置它们

// implicitly create a message and set the attachments
$client->setAttachments($bigArrayOfAttachments);

// or explicitly
$client->createMessage()->setAttachments($bigArrayOfAttachments);

$attachment = new Attachment([]);

$attachment->setFields($bigArrayOfFields);

贡献

如果您遇到问题、发现错误或有功能建议，请登录 Github 并提交一个 issue。如果您想亲自尝试，请 fork 这个包并提交一个 pull request。请包括任何添加或更改的功能的测试。如果是错误，请包括回归测试。