timo-reymann/gitlab-webhook-lib

Simple PHP library for working with gitlab webhooks

GitLab Webhook Library

, _(*1)

What is this?

Simple library for PHP to work with Gitlab webhooks in a easy and natural way, _(*2)

Usage

Installation

Install using composer: composer require timo-reymann/gitlab-webhook-lib, _(*3)

Documentation

For PHP class documentation please visit timo-reymann.github.io/gitlab-webhook-lib, _(*4)

Use in your scripts

First create a webhook object and pass your secret token, _(*5)

$hook = new \TimoReymann\GitlabWebhookLibrary\Core\Webhook(
  new \TimoReymann\GitlabWebhookLibrary\Token\SecretToken('mySuperSecretToken')
);

To evaluate the header for your secret token and the event. Be aware that this method may throw an exception if the request is not valid!, _(*6)

$hook->parse();

Finally you can work with the result, if you would like to, the "expensive" members are internally cached after you first call them. So you don't have hidden performance bottlenecks. The resulting object is based on the gitlab event type passed via header., _(*7)

$hook->getResult()