nexylan/slack-bundle

Symfony bundle integration of nexylan/slack library

NexySlackBundle

Symfony bundle integration of the nexylan/slack library (old popular maknz/slack)., _(*1)

, _(*2)

, _(*3)

, _(*4)

Documentation

All the installation and usage instructions are located in this README. Check it for specific version:, _(*5)

• 1.x with support for Symfony >=2.7
• 2.x with support for Symfony >=3.4

Prerequisites

This version of the project requires:, _(*6)

• PHP 7.1+
• Symfony 3.4+

Installation

First of all, you need to require this library through composer:, _(*7)

``` bash $ composer require nexylan/slack-bundle php-http/guzzle6-adapter, <sub>(*8)</sub>

Why `php-http/guzzle6-adapter`? We are decoupled from any HTTP messaging client thanks to [HTTPlug](http://httplug.io/).

Then, enable the bundle on the `AppKernel` class:

``` php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Http\HttplugBundle\HttplugBundle(),
        new Nexy\SlackBundle\NexySlackBundle(),
    );

    // ...

    return $bundles
}

Configuration

If it is not already done, you have to configure httplug-bundle first. Check the official documentation for this., <sub>(*9)</sub>

Configure the bundle to your needs (example with default values):, <sub>(*10)</sub>

nexy_slack:

    # If you want to use an another httplug client service.
    http:
        client: httplug.client

    # The Slack API Incoming WebHooks URL.
    endpoint:             ~ # Required
    channel:              null
    username:             null
    icon:                 null
    link_names:           false
    unfurl_links:         false
    unfurl_media:         true
    allow_markdown:       true
    markdown_in_attachments: []

Excepted endpoint, all the other configuration keys are related to the Slack client default settings., <sub>(*11)</sub>

All those settings are described on the nexylan/slack documentation., <sub>(*12)</sub>

Usage

The Slack client instance can be retrieved from the nexy_slack.client service., <sub>(*13)</sub>

Here is an example:, <sub>(*14)</sub>

<?php

namespace AppBundle\Controller;

use Nexy\Slack\Attachment;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;

class DefaultController extends Controller
{
    public function indexAction()
    {
        $slack = $this->get('nexy_slack.client');

        $message = $slack->createMessage();

        $message
            ->to('#test')
            ->from('John Doe')
            ->withIcon(':ghost:')
            ->setText('This is an amazing message!')
        ;

        $message->attach((new Attachment())
             ->setFallback('Some fallback text')
             ->setText('The attachment text')
         );

        $slack->sendMessage($message);
    }
}

All the how to manipulate the Slack client is on the nexylan/slack documentation., <sub>(*15)</sub>