README

Slack Extended for Laravel Envoy

Rich Text notification for Laravel Envoy.

This package sends a richly formatted Slack message from your Laravel Envoy deployment scripts. Instead of a plain line of text, it posts a Slack Block Kit attachment with a colored success/failure header, the release number, deployment details (host, branch, PHP version, the user who triggered the deploy) and a button linking back to GitHub.

Installation

Install the package via Composer:

composer require marshmallow/slack-extended-envoy

Usage

The entry point is the Marshmallow\SlackExtended\SlackExtended class. Build a message with make(), optionally set the failing task with task(), and call send() to post it to your Slack Incoming Webhook.

use Marshmallow\SlackExtended\SlackExtended;

SlackExtended::make(
    hook: 'https://hooks.slack.com/services/XXX/YYY/ZZZ',
    channel: '#deployments',
    options: [
        'host'        => 'production',
        'release'     => '20260611120000',
        'user'        => 'stefvanesch',
        'branch'      => 'main',
        'php_version' => '8.5',
        'github_url'  => 'https://github.com/marshmallow-packages/slack-extended-envoy',
    ],
    success: true,
)->send();

Constructor / make() arguments

The options array is rendered into the message body and recognises these keys:

Reporting the failing task

When a deployment fails, use task() to include the name of the task that failed in the message. task() is chainable and returns the instance:

use Marshmallow\SlackExtended\SlackExtended;

SlackExtended::make($hook, $channel, $options, success: false)
    ->task('deploy')
    ->send();

Using it from Envoy

Call the package from your Envoy.blade.php deployment hooks, for example in @error and @finished:

@finished
    @php
        \Marshmallow\SlackExtended\SlackExtended::make(
            $slackHook,
            '#deployments',
            $options,
            success: true,
        )->send();
    @endphp
@endfinished

Credits

• LTKort
• All Contributors

Security Vulnerabilities

Please report security vulnerabilities by email rather than via the public issue tracker.

License

The MIT License. Please see the License File for more information.