Slack-API lets you build simple response system for slack's slash command API.

For production make sure you have composer installed. Then run:

composer require clawrock/slack-api

After installing, you need to require Composer's autoloader:

require 'vendor/autoload.php';

Basic example with anonymous function.

use ClawRock\Slack\SlackFactory;

//Create new dispatcher
$dispatcher = SlackFactory::dispatcher();


//Add commands to respond to your request
$dispatcher->addCommand(SlackFactory::slashCommand('your-command-token')
          ->run(function ($req, $res){
                $res->addText('Hello world!');
          }))->dispatch(SlackFactory::getRequest())
      ->create()
      ->toRequest()
      ->serve();

You can also add Guard to manage the user/team/channel permissions.

use ClawRock\Slack\Enums\Permissions;

$dispatcher->addGuard(SlackFactory::guard()
        ->defaultBehavior(Permissions::DenyAll())
        ->allowUserIds(['U01'])
        ->allowTeamIds(['T01']))
    ->addCommand(//commands)
    ->dispatch(SlackFactory::getRequest())
    ->create()
    ->toRequest()
    ->serve();

It's worth to notice that every callable object can be used in addCommand() method.

You can send messages via Incoming webhooks

use ClawRock\Slack\SlackFactory;

SlackFactory::getMessageService('')->sendText("Hello world!");

There are very well documented examples in examples/ directory. You should take a look on them.

Simply run

vendor/bin/phpunit

Slack API requires server with SSL enabled. Please refer to the Slack's API reference to get more informations.

If you wish to participate in the development, you may use grunt to generate the documentation files. To do so make sure you have node and npm installed.

$ node -v
v4.7.0
$ npm -v
2.15.11

Then run

$ npm install
$ grunt init

And then to generate docs run

grunt build

This will also launch unit tests.

Slack-API was initiated with generator-composer, a Yeoman generator that builds a PHP Composer project.

This project uses the following as development dependencies:

• PHPUnit
• PhpDocumentor
• Php Copy/Paste Detector

Author: cr-team [email protected]