Download the PHP package softpyramid/forge-status without Composer

On this page you can find all versions of the php package softpyramid/forge-status. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of softpyramid/forge-status

Informations about the package forge-status

Laravel Forge Webhook Status

Latest Version on Packagist Total Downloads Laravel Version PHP Version

Real-time deployment status indicator for Laravel Forge using webhooks. Get instant visual feedback when your deployments start, succeed, or fail.

Features

Requirements

Installation

The package will automatically register its routes and service provider. No manual configuration needed!

Configuration

1. Publish config (optional):

2. Add to .env (optional):

3. Register Webhook in Laravel Forge

In your Forge site settings:

  1. Go to "Webhooks"
  2. Add new webhook URL: https://yourdomain.com/forge-webhook
  3. Optionally add token parameter: https://yourdomain.com/forge-webhook?token=your-secret-token

Usage

Auto-inject into layouts

Add the component to your layout file (e.g., resources/views/layouts/app.blade.php):

That's it! The indicator will automatically appear when deployments start and update in real-time.

How It Works

  1. Forge sends webhook POST request when deployment starts/finishes
  2. Package receives webhook and stores status in cache
  3. Frontend polls the status endpoint every few seconds
  4. Indicator updates automatically when status changes
  5. No database storage - uses cache for current status only
  6. Simple and reliable - no WebSocket complexity

Laravel Version Compatibility

Laravel Version Package Version PHP Version
Laravel 12.x ^1.0 ^8.2
Laravel 11.x ^1.0 ^8.2
Laravel 10.x ^1.0 ^8.1

Testing

Testing

Test the package functionality

This command will test all package functionality including cache storage, webhook endpoint, and status endpoint.

Test with your data

Then open your Laravel app in the browser to see the overlay in action!

Debugging

Check if routes are registered

This command will show you all registered Forge Status routes and verify they're working correctly.

Manual route discovery

If routes aren't auto-registered, run:

Troubleshooting

Laravel 12 Compatibility Issues

If you encounter issues with Laravel 12, ensure you have:

  1. PHP 8.2+ installed
  2. Updated dependencies - run composer update
  3. Cleared caches - run php artisan config:clear && php artisan cache:clear

Polling Not Working

Make sure you have:

  1. Polling interval configured in your .env:

  2. Status endpoint is accessible at /forge-status

  3. Cache is working - check your cache configuration

Webhook Not Receiving Data

Verify:

  1. Webhook URL is correctly registered in Laravel Forge
  2. Token verification is properly configured (if using)
  3. Route is accessible - check /forge-webhook endpoint

License

MIT License. See LICENSE file for details.

Author

Fakhar Zaman Khan - SoftPyramid

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

All versions of forge-status with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/cache Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
illuminate/routing Version ^10.0|^11.0|^12.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package softpyramid/forge-status contains the following files

Loading the files please wait ...