README

一个用于处理Slack的有用类库。

目前这个库主要关注 slash命令，但未来可能会有所扩展。它支持定义多个命令并在其中匹配动作。

0.0 目录

简介
安装
示例
运行测试
故障排除
变更日志

1.0 简介

Slack是一个跨平台的消息平台，提供了与第三方服务的多种集成。其中最有用的是以slash命令的形式，例如。

/cinema movies tonight

slash命令会对服务器发起HTTP POST请求，并将结果显示给用户。这个库旨在使处理这些命令变得简单一些，包括

解析传入的数据
匹配文本与命令模式
确保安全令牌匹配
筛选可用的团队、频道和用户
服务响应
处理延迟响应

目前没有支持Slack Web API或RTM，因为这些已经在其他地方由其他人实现了。这个库可以让您快速轻松地将slash命令上线。查看示例目录以获取更多信息。

2.0 安装

PHP Slack可以通过Composer在Packagist上获得。要安装，只需运行

composer require hybridlogic/slack

或者克隆git仓库并使用PSR-4兼容的自动加载器。

3.0 示例

Slack::dispatcher()
	->setFilter(
		Slack::filter()
			->allowedTeamIds('T01234567')
			->allowedUserIds('U01234567')
	)
	->addCommand(
		Slack::command('ABCDEF01234567')
			->on('', function(){
				return Slack::response('Welcome to this command');
			})
			->on('^say (.+)$', function($req){
				$text = $req->param(0);
				return Slack::response("Hello $text");
			})
	)
	->dispatch(Slack::request())
	->serve()
;

4.0 运行测试

phpunit测试

5.0 故障排除

请确保您满足运行slash命令主机的要求，即公开可访问且通过HTTPS提供。

6.0 变更日志

[2016-02-21] 初次发布

hybridlogic / slack

维护者

详细信息