PHPackages                             mahimahi/gitlab-deploy - 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. [DevOps & Deployment](/categories/devops)
4. /
5. mahimahi/gitlab-deploy

ActiveLibrary[DevOps & Deployment](/categories/devops)

mahimahi/gitlab-deploy
======================

Helps automate the deployment of projects onto servers by utilising Gitlab web hooks

v0.3.6(8y ago)042MITPHPPHP >=5.6.4

Since Sep 20Pushed 8y ago3 watchersCompare

[ Source](https://github.com/Mahi-Mahi/GitlabDeploy)[ Packagist](https://packagist.org/packages/mahimahi/gitlab-deploy)[ RSS](/packages/mahimahi-gitlab-deploy/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (10)Used By (0)

Deployments Laravel projects using Git webhooks
===============================================

[](#deployments-laravel-projects-using-git-webhooks)

git-deploy-laravel assists deployment by receiving a push event message from your repository's server and automatically pulling project code.

This should work out-of-the-box with Laravel 5.x using with webhooks from GitHub and GitLab servers.

This is an internal tool to help with our common workflow pattern but please feel free to borrow, change and improve.

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

[](#installation)

### Step 1

[](#step-1)

Add the following to your `composer.json` file then update your composer as normal:

```
{
    "require" : {
        "orphans/git-deploy-laravel" : "dev-master"
    }
}

```

Or run:

```
composer require orphans/git-deploy-laravel

```

### Step 2

[](#step-2)

Add the following line to you providers in `config/app.php`:

```
Orphans\GitDeploy\GitDeployServiceProvider::class,

```

### Step 3

[](#step-3)

Add the */git-deploy* route to CSRF exceptions so your repo's host can send messages to your project.

In file in `app/Http/Middleware/VerifyCsrfToken.php` add:

```
protected $except = [
    'git-deploy',
];

```

Usage
-----

[](#usage)

Add a webhook for  to your project in GitHub/GitLab and this package will take care of the rest. The webhook should fire on push-events.

Your website will automatically receive POST messages from the repo manager and perform a Git pull.

Configuration
-------------

[](#configuration)

In most cases the package will find the correct Git repository and Git executable but we advise publishing our config anyway because it will let you enable extra security options and email notifications.

To add custom configuration run:

```
php artisan vendor:publish --provider="Orphans\GitDeploy\GitDeployServiceProvider"

```

Then edit `/config/gitdeploy.php`, which has been well commented.

Future Plans
------------

[](#future-plans)

- Branch management (i.e. only tigger on changes to active branch).
- Email report on code conflicts that prevent a pull.

###  Health Score

25

—

LowBetter than 36% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~93 days

Recently: every ~0 days

Total

8

Last Release

3282d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c8a232e9a92da0d800420966d0ce8967a3219cb8389a7143104a522797a078fe?d=identicon)[olivM](/maintainers/olivM)

---

Top Contributors

[![Muffinman](https://avatars.githubusercontent.com/u/1319568?v=4)](https://github.com/Muffinman "Muffinman (14 commits)")[![olivM](https://avatars.githubusercontent.com/u/855?v=4)](https://github.com/olivM "olivM (12 commits)")[![edjeavons](https://avatars.githubusercontent.com/u/735284?v=4)](https://github.com/edjeavons "edjeavons (6 commits)")

---

Tags

laravelgitlabgitdeployment

### Embed Badge

![Health badge](/badges/mahimahi-gitlab-deploy/health.svg)

```
[![Health](https://phpackages.com/badges/mahimahi-gitlab-deploy/health.svg)](https://phpackages.com/packages/mahimahi-gitlab-deploy)
```

###  Alternatives

[fadion/maneuver

Easily deploy Laravel projects via FTP or SFTP, using Git for versioning.

1729.1k](/packages/fadion-maneuver)[ecotone/laravel

Ecotone for Laravel — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Laravel Queue, via PHP attributes.

21313.7k3](/packages/ecotone-laravel)[webklex/laravel-git-hook

Laravel Git Hook

171.2k](/packages/webklex-laravel-git-hook)[innocenzi/deployer-recipe-forge

Seamless zero-downtime deployment on Forge with Deployer

1916.6k](/packages/innocenzi-deployer-recipe-forge)

PHPackages © 2026

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