PHPackages                             pruno/github-webhooks - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. pruno/github-webhooks

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

pruno/github-webhooks
=====================

Utility to handle multiple Github web-hooks on the same platform

2.0.0(12y ago)516BSD-3-ClausePHPPHP &gt;=5.3.3

Since Jan 20Pushed 12y ago3 watchersCompare

[ Source](https://github.com/pruno/github-webhooks)[ Packagist](https://packagist.org/packages/pruno/github-webhooks)[ Docs](https://github.com/pruno/github-hooks)[ RSS](/packages/pruno-github-webhooks/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (2)Dependencies (2)Versions (4)Used By (0)

Github WebHooks 2.0.0 [![Build Status](https://camo.githubusercontent.com/ee3f8a1e2568b08da82325bcf102d8e3b2eaef560658a186adfa34f17404abf5/68747470733a2f2f7472617669732d63692e6f72672f7072756e6f2f6769746875622d776562686f6f6b732e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/pruno/mongo-vc) [![Latest Stable Version](https://camo.githubusercontent.com/3d6fae1c8daa2ca2906bad40074e4c510ca312951f5200d50b41c42b4f184040/68747470733a2f2f706f7365722e707567782e6f72672f7072756e6f2f6769746875622d776562686f6f6b732f762f737461626c652e706e67)](https://packagist.org/packages/pruno/github-webhooks)
======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#github-webhooks-200-)

Github Webhooks Library (with events support).

Introduction
------------

[](#introduction)

This library aims to provide:

- A simple and embeddable event-based library
- A handy stand-alone server class
- An event listener to perform `git pull`

    - Support multiple deploy key
    - *NOTE*: Linux only

Requirements
------------

[](#requirements)

- php &gt;=5.3.3

Optionally:

- git (to use the Pull event listener)

Installation
------------

[](#installation)

Using [composer](http://getcomposer.org/):

Add the following to your `composer.json` file:

```
"require": {
    "pruno/github-webhooks": "2.0.*",
},
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/pruno/github-webhooks.git"
    }
]

```

Alternately with git submodules:

```
git submodule add https://github.com/pruno/github-webhooks.git pruno/github-webhooks

```

Quick implementation (Pull on Push event)
-----------------------------------------

[](#quick-implementation-pull-on-push-event)

1 - Create a [Github Webhook](https://developer.github.com/webhooks/):

```
 - Set an arbitrary URL path (this will be your hook id)
   (e.g: https://example.com/POSTRECEIVE)
 - Both payload versions are supported.
 - The push event is enough.

```

1 - Copy `sample/composer.json` to your project root directory.

2 - Run `composer install`.

3 - Copy `sample/index.php` to your public directory.

4 - Edir `sample/index.php` with:

```
 - hook information (line 9).
 - git working copy information (line 14).

```

5 - You may remove line 12 once finished.

Notice:
Remember that the user who is running your webserver (or fast-cgi process) need to have write permissions on your git working copy.

Embedding
---------

[](#embedding)

Refer to `library/GithubWebhooks/Server.php` as an example implementation.

Contribute
----------

[](#contribute)

Please do. Fork it and send pull requests.

License
-------

[](#license)

This software is released under the New-BSD License.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~29 days

Total

2

Last Release

4468d ago

Major Versions

1.0.0 → 2.0.02014-02-18

PHP version history (2 changes)1.0.0PHP &gt;=5.3.0

2.0.0PHP &gt;=5.3.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/5ce7789f1ad18bbc933ccbcf2d3ba2c6ee87f7da6eb0c5437cdb83f38ea3d495?d=identicon)[pruno](/maintainers/pruno)

---

Top Contributors

[![pruno](https://avatars.githubusercontent.com/u/1735022?v=4)](https://github.com/pruno "pruno (56 commits)")

---

Tags

githubgitwebhook

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pruno-github-webhooks/health.svg)

```
[![Health](https://phpackages.com/badges/pruno-github-webhooks/health.svg)](https://phpackages.com/packages/pruno-github-webhooks)
```

###  Alternatives

[czproject/git-php

Library for work with Git repository in PHP.

5544.9M81](/packages/czproject-git-php)[cypresslab/gitelephant

An abstraction layer for git written in PHP

6131.0M23](/packages/cypresslab-gitelephant)[marcocesarato/php-conventional-changelog

Generate changelogs and release notes from a project's commit messages and metadata and automate versioning with semver.org and conventionalcommits.org

2511.3M109](/packages/marcocesarato-php-conventional-changelog)[ramsey/conventional-commits

A PHP library for creating and validating commit messages according to the Conventional Commits specification. Includes a CaptainHook action!

1931.2M122](/packages/ramsey-conventional-commits)[sebastianfeldmann/git

PHP git wrapper

466.9M18](/packages/sebastianfeldmann-git)[producer/producer

Tools for releasing library packages; supports Git, Mercurial, Github, Gitlab, and Bitbucket.

10418.7k2](/packages/producer-producer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
