Looking to hire Laravel developers? Try LaraJobs

laravel-cpanel-hosting maintained by awaisjameel

Description
A robust, secure, and production-ready Laravel package that makes deploying Laravel applications on **cPanel / shared hosting** painless and professional.
Author
awaisjameel
Last update
2026/04/21 23:15 (dev-dependabot/github_actions/dependabot/fetch-metadata-3.1.0)
License
MIT
Links
Homepage - GitHub - Packagist
Downloads
0
Tags
laravel - awaisjameel - laravel-cpanel-hosting

dev-dependabot/github_actions/dependabot/fetch-metadata-3.1.0

Last update
2026/04/21 23:15
License
MIT
Require
  • php ^8.2
  • spatie/laravel-package-tools ^1.16
  • illuminate/contracts ^10.0|^11.0|^12.0
  • illuminate/support ^10.0|^11.0|^12.0
dev-dependabot/github_actions/dependabot/fetch-metadata-3.0.0

Last update
2026/03/31 23:16
License
MIT
Require
  • php ^8.2
  • spatie/laravel-package-tools ^1.16
  • illuminate/contracts ^10.0|^11.0|^12.0
  • illuminate/support ^10.0|^11.0|^12.0
dev-dependabot/github_actions/ramsey/composer-install-4

Last update
2026/03/17 22:16
License
MIT
Require
  • php ^8.2
  • spatie/laravel-package-tools ^1.16
  • illuminate/contracts ^10.0|^11.0|^12.0
  • illuminate/support ^10.0|^11.0|^12.0
dev-main

Last update
2026/02/10 21:28
License
MIT
Require
  • php ^8.2
  • spatie/laravel-package-tools ^1.16
  • illuminate/contracts ^10.0|^11.0|^12.0
  • illuminate/support ^10.0|^11.0|^12.0
v1.0.0

Last update
2026/02/10 21:24
License
MIT
Require
  • php ^8.2
  • spatie/laravel-package-tools ^1.16
  • illuminate/contracts ^10.0|^11.0|^12.0
  • illuminate/support ^10.0|^11.0|^12.0
Comments
comments powered by Disqus

Laravel cPanel Hosting

Laravel package for secure shared-hosting deployment endpoints and cPanel-friendly root hosting setup.

Features

  • Secure deploy endpoints with token or webhook signature validation
  • Configurable deployment pipeline (/deploy)
  • .env sync with optional backup and required-key validation
  • Storage link fallback (symlink -> recursive copy)
  • Installer command for config + root index.php and .htaccess stubs
  • Dedicated deploy logging channel
  • Optional MySQL legacy index-length compatibility

Installation

composer require awaisjameel/laravel-cpanel-hosting

Run installer:

php artisan cpanel-hosting:install

Configuration

Publish config manually if needed:

php artisan vendor:publish --tag="cpanel-hosting-config"

Key env values:

CPANEL_DEPLOY_ENABLED=false
CPANEL_DEPLOY_TOKEN=
CPANEL_DEPLOY_WEBHOOK_SECRET=
CPANEL_DEPLOY_PREFIX=deploy
CPANEL_DEPLOY_ALLOWED_IPS=
CPANEL_DEPLOY_LOG_CHANNEL=deploy

Endpoints

When enabled, routes are exposed under CPANEL_DEPLOY_PREFIX (default deploy):

  • GET /deploy full pipeline
  • GET /deploy/sync-env
  • GET /deploy/clear
  • GET /deploy/migrate
  • GET /deploy/migrate-fresh
  • GET /deploy/cache
  • GET /deploy/queue-restart
  • GET /deploy/storage-link
  • GET /deploy/maintenance-down
  • GET /deploy/maintenance-up
  • GET /deploy/optimize
  • GET /deploy/health

Authentication:

  • X-Deploy-Token: {token} header (preferred)
  • ?token={token} query parameter
  • X-Hub-Signature-256 / X-Gitlab-Token webhook verification when configured

Security Notes

  • Keep CPANEL_DEPLOY_TOKEN secret and rotate on exposure.
  • Prefer header token over query token.
  • Restrict with CPANEL_DEPLOY_ALLOWED_IPS when possible.
  • Do not expose deploy routes with APP_DEBUG=true.
  • migrate-fresh is destructive.

Testing

composer test