spatie / laravel-dynamic-servers
Dynamically create and destroy servers
Requires
- php: ^8.2
- illuminate/contracts: ^10.0|^11.0
- illuminate/http: ^10.0|^11.0
- spatie/laravel-package-tools: ^1.13.3
Requires (Dev)
- guzzlehttp/guzzle: ^7.5
- nunomaduro/collision: ^7.0|^8.0
- nunomaduro/larastan: ^2.2
- orchestra/testbench: ^8.0|^9.0
- pestphp/pest: ^v2.34
- pestphp/pest-plugin-laravel: ^2.4
- phpunit/phpunit: ^9.5|^10.5|^11.0
- spatie/pest-plugin-test-time: ^1.1.1|^2.0
- vlucas/phpdotenv: ^5.4.1
README
This package can help you start and stop servers when you need them. The prime use case is to spin up extra working servers that can help you process the workload on queues.
You can think of this as a sort of PHP based version of Kubernetes that has 5% of its features, but covers that 80% use case. For most PHP and Laravel developers, this package will also be easier to learn and use.
Typically, on your hosting provider, you would prepare a server snapshot, that will be used as a template when starting new servers.
After the package is configured, spinning up an extra servers is as easy as:
// typically, in a service provider use Laravel\Horizon\WaitTimeCalculator; use Spatie\DynamicServers\Facades\DynamicServers; use Spatie\DynamicServers\Support\DynamicServersManager; /* * The package will call the closure passed * to `determineServerCount` every minute */ DynamicServers::determineServerCount(function(DynamicServersManager $servers) { /* * First, we'll calculate the number of servers needed. * * In this example, we will take a look at Horizon's * reported waiting time. Of course, in your project you can * calculate the number of servers needed however you want. */ $waitTimeInMinutes = app(WaitTimeCalculator::class)->calculate('default'); $numberOfServersNeeded = round($waitTimeInMinutes / 10); /* * Next, we will pass the number of servers needed to the `ensure` method. * * If there currently are less that that number of servers available, * the package will start new ones. * * If there are currently more than that number of servers running, * the package will stop a few servers. */ $servers->ensure($numberOfServersNeeded); });
Out of the box, the package supports UpCloud. You can create your own server provider to add support for your favourite hosting service.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Documentation
All documentation is available on our documentation site.
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
This idea behind this package was... spawned 🥁 by streams and a blog post by Jason McCreary on Spawning workers based on queue workload.
License
The MIT License (MIT). Please see License File for more information.