understeam/yii2-slack

Yii2 slack client based on GuzzleHttp library

Installs: 197 914

Dependents: 2

Suggesters: 0

Security: 0

Stars: 20

Watchers: 5

Forks: 10

Type:extension

v0.3.0 2016-09-23 08:50 UTC

This package is not auto-updated.

Last update: 2024-10-26 18:22:45 UTC


README

Designed to send messages to slack messenger

How it looks

Installation

php composer.phar require understeam/yii2-slack:~0.3 --prefer-dist

Also, you should configure incoming webhook inside your Slack team.

Usage

First of all, configure yiisoft/yii2-httpclient component:

...
    'components' => [
        'httpclient' => [
            'class' => 'yii\httpclient\Client',
        ],
    ],
...

Also you can set it up only inside of slack client:

...
    'components' => [
        'slack' => [
            'httpclient' => [
                'class' => 'yii\httpclient\Client',
            ],
            ...
        ],
    ],
...

Configure component:

...
    'components' => [
        'slack' => [
            'class' => 'understeam\slack\Client',
            'url' => '<slack incoming webhook url here>',
            'username' => 'My awesome application',
        ],
    ],
...

Now you can send messages right into slack channel via next command:

Yii::$app->slack->send('Hello', ':thumbs_up:', [
    [
        // attachment object
        'text' => 'text of attachment',
        'pretext' => 'pretext here',
    ],
]);

To learn more about attachments, read Slack documentation

Also you can use slack as a log target:

...
'components' => [
    'log' => [
        'traceLevel' => 3,
        'targets' => [
            [
                'class' => 'understeam\slack\LogTarget',
                'categories' => ['commandBus'],
                'exportInterval' => 1, // Send logs on every message
                'logVars' => [],
            ],
        ],
    ],
],
...