Download the PHP package oneduo/laravel-gitlab-webhook-client without Composer

A client to handle incoming Gitlab webhook requests

This a tiny client that allows you to listen to Gitlab webhooks in your Laravel application. You may use the events dispatched and use the data they provide to perform actions in your application.

Webhook types supported:

• [x] Push Events
• [ ] Tag Events
• [x] Issue Events
• [x] Comments Events
• [x] Merge request Events
• [ ] Wiki page Events
• [x] Pipeline Events
• [ ] Job Events
• [ ] Deployment Events
• [ ] Release Events
• [ ] Subgroup Events
• [ ] Feature flag Events
• [ ] Release events

Installation

You can install the package via composer:

You can publish the config file with:

This is the contents of the published config file:

Usage

Setting up Gitlab

To get started, you must first set up a webhook in your Gitlab project.
You may follow the official documentation provided here https://docs.gitlab.com/ee/user/project/integrations/webhooks.html.

Setting up the webhook url

By default, when the route_enabled config is set to true, the package automatically registers a route to handle all incoming webhook requests.
It is registered as POST /gitlab-webhook and you may inspect your routes using the php artisan route:list command.

Note If you wish to implement your own route, please take a look at the WebhookController to implement a similar logic to dispatch events.

When Gitlab sends a webhook request to your application, the package will dispatch an event based on the type of webhook received.

For instance, if Gitlab sends a merge request webhook, the package will dispatch a MergeRequestEvent event.

You may register your own listener like this:

All the events are type-hinted to provide easy access to the event attributes and data:

Note You may use individual event listeners for each event type or use a single listener that listens to WebhookEventContract that will catch all events dispatched.

Note Please note that some attributes and data is considered nullable, and you must implement the necessary null checks on these values.

Deduplication

Webhook deduplication is not guaranteed by Gitlab. You may use the uuid property on each event to handle deduplication within your application.

Security

Each event exposes the headers provided by Gitlab. You may use the X-Gitlab-Token header to verify the request authenticity against the secret token you have set in your Gitlab project settings.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Charaf Rezrazi
• Mikaël Popowicz
• All Contributors

License

The MIT License (MIT). Please see License File for more information.