README

This package allows you to add closure based handlers to GitHub or GitLab Webhooks. A 'push' handler for autodeploying is included out-of-the-box but feel free to add your own one.

Features

Auto-deployment
Highly configurable
Middleware protection
GitHub and GitLab support
Custom event handlers

Installation

Run composer require mrcrmn/laravel-webhooks.
Publish the configuration file php artisan vendor:publish --provider=mrcrmn/laravel-webhooks.
Edit the config/webhook.phpfile as needed.

For Laravel < 5.5

If you are not using Laravels auto discovery, you need to add mrcrmn\Webhook\Provider\WebhookServiceProvider::class to the config/app.php provider array, as well as 'Webhook' => mrcrmn\Webhook\Facade\Webhook::class to the facades.

Adding a event handler

To register an event handler, you need to go to your AppServiceProvider and add the following to the boot method:

use mrcrmn\Webhook\Facade\Webhook;

Webhook::handler('push', function($request){
    Artisan::call('deploy');
});

Autodeploy

This package can run several configurable commands once a webhook hits your application. It will execute the given commands from top to bottom in the root laravel directory. If a command returns an exit code > 0, command execution will stop. All outputs will be logged by your default log driver. Make sure to check if everything went as exprected!

Configuration

`repository`

Specify your git repository name here. This is needed so we can verfify the integrity of the webhook request.

`branch`

The branch name your events should respond to.

`adapter`

Currently github and gitlab are supported.

`uri`

This is the uri that is registered in your application. Make sure you point your git providers webhook to this uri.

`controller`

This is the controller that is invoked, once a request hits the uri.

`middleware-name`

This is the name of the middleware group that is registered. You probably don't need to change this.

`middleware`

This are the middleware that is run to verify the request. You can add your own to the array.

`events`

These are the events that your application can listen to. By default only the push event is listened to. You can allow all events by using the * wildcard.

`secret`

This is important. Make sure you provide a secret when you are creating a webhook and put it in your .env file under WEBHOOK_SECRET or else anybody can post to your application and trigger event handlers.

`maintenance-mode`

If you are using the auto deploy feature, setting this to true runs php artisan down before the deployment commands, and php artisan up once all commands are executed. Warning If one of your commands returns a status code >= 1, command execution will stop and your application will stay in maintenance mode.

`commands`

This is the array of commands that are executed when you push to your given branch. Feel free to remove or add your own commands. Make sure you know what you are doing!

Logs

The output of all executed commands are written to the default Log driver.

mrcrmn / laravel-webhooks

Maintainers

Details