Download the PHP package nassirian/laravel-github-deployer without Composer
On this page you can find all versions of the php package nassirian/laravel-github-deployer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download nassirian/laravel-github-deployer
More information about nassirian/laravel-github-deployer
Files in nassirian/laravel-github-deployer
Download nassirian/laravel-github-deployer
More information about nassirian/laravel-github-deployer
Files in nassirian/laravel-github-deployer
Vendor nassirian
Package laravel-github-deployer
Short Description A simple GitHub webhook-based deployer for Laravel applications.
License MIT
Package laravel-github-deployer
Short Description A simple GitHub webhook-based deployer for Laravel applications.
License MIT
Please rate this library. Is it a good library?
Informations about the package laravel-github-deployer
Laravel GitHub Deployer
Simple and flexible Laravel package to automate deployments using GitHub Webhooks.
This package supports both:
- ๐ Synchronous deployments (runs directly on the server)
- ๐งต Queue-based deployments (offloaded to dedicated queue workers โ e.g., Docker container or remote worker)
โ Features
- Git pull
- Composer install
- Docker container restart
- Laravel migrations, route/config caching
- Dedicated
deployqueue support - Secure signature verification from GitHub
๐ฆ Installation
โ๏ธ Configuration (Optional)
Publish the config file to customize deployment behavior:
This creates: config/github-deployer.php
๐ก GitHub Webhook Setup
- Expose your webhook route
Laravel will respond to:
-
Add Webhook in GitHub:
- Go to Repo Settings โ Webhooks โ Add Webhook
- Payload URL:
https://your-domain.com/github/webhook - Content type:
application/json - Secret:
your-random-string - Events: โ Push event only
- Set secret in
.env:
โ๏ธ Sync vs Queue Mode
| Mode | Description |
|---|---|
sync |
Runs deployment commands immediately in the HTTP request (for small projects or simple VPS) |
queue |
Dispatches a background job to the deploy queue (best for Docker, Horizon, supervisors) |
Set this in your .env:
Then, in supervisord or Docker, run:
โ How It Works
- GitHub sends a webhook โ
/github/webhook - Laravel verifies the HMAC signature
- Based on config mode:
sync: Runs the deploy shell commands right awayqueue: Dispatches a background job to thedeployqueue
- Commands are run in 3 phases:
pre_deploy_commandsdeploy_commandspost_deploy_commands
๐ Tips & Extensions
- Need
npm run build? Add it todeploy_commands - Want zero-downtime? Use
php artisan down/upinpre/post - Using Horizon? Just isolate
deployworkers separately
๐ Security
- Verifies GitHub
X-Hub-Signature-256 - Jobs can self-check queue name (
EnsureDeployQueue) - Workers on wrong queues will back off with throttling
๐ Requirements
- PHP 8.1+
- Laravel 9.x โ 12.x
- GitHub webhook support
- Docker (optional)
- Supervisor or Horizon (for queue mode)
๐ผ License
This package is open-sourced under the MIT license.
โจ Deployment Flow Example
Fully automated. No manual SSH. No downtime.
๐ฅ Your deployments are now modern and effortless.
All versions of laravel-github-deployer with dependencies
PHP Build Version
Package Version
The package nassirian/laravel-github-deployer contains the following files
Loading the files please wait ...