A simple Laravel package for sending messages to Slack with incoming webhooks.

• PHP 5.4 or greater
• Laravel 4.1 or greater

You can install the package using the Composer package manager. Assuming you have Composer installed globally:

composer require maknz/slack:0.1.*

Next, add the Maknz\Slack\SlackServiceProvider service provider to the providers array in your app/config.php file.

'providers' => array(
  ...
  'Maknz\Slack\SlackServiceProvider',
),

and then add the facade to your aliases array in your app/config.php file.

'aliases' => array(
  ...
  'Slack' => 'Maknz\Slack\Facades\Slack',
),

Publish the configuration with

php artisan config:publish maknz/slack

This will add the boilerplate configuration to app/config/packages/maknz/slack/config.php. You need to add the URL to the webhook the package should use. If you haven't already created an incoming webhook for the package to use, create one in your Slack backend. The URL will be available under the "Instructions for creating Incoming WebHooks" panel. You can also configure the default channel and username in the config file.

You can change the icon that will be used when editing the webhook in the Slack backend.

// Sending a message using the defaults in the configuration
Slack::send('Hello world!');

// Sending a message to a specific channel
Slack::send('Hello world!', '#accounting');

// Sending a message to a user
Slack::send('Hello world!', '@maknz');

// Sending a message to a channel, overriding the default username
Slack::send('Hello world!', '#general', 'Robot');

I will happily look at any pull requests to improve the package and provide attribution for your contributions. Help share the improvements with everyone!