Weave Code
Queue Promises Laravel Package
tochka-developers/queue-promises
Laravel package that adds promise-style handling to queued jobs, letting you dispatch work asynchronously and await results through a clean promise API. Simplifies coordinating background tasks while keeping jobs on your existing queue.
Promises for Laravel queue jobs
Frequently asked questions about Queue Promises
- What does tochka-developers/queue-promises do?
- It is a Laravel package that adds promise-style handling to queued jobs. It lets you dispatch work asynchronously and await results through a clean promise API while keeping jobs on your existing queue. It is aimed at simplifying coordination of background tasks.
- How do I install tochka-developers/queue-promises in Laravel?
- Install it with Composer by requiring tochka-developers/queue-promises, then follow the repository README for any service provider or configuration steps. In many Laravel packages, package discovery registers the provider automatically, but verify that in the package composer.json. Commit composer.lock and test the integration on a branch before production.
- Which Laravel and PHP versions are supported by queue-promises?
- The v1.9.0 release note specifically mentions PHP 8.5 support and a Carbon 3 support fix, but it does not list supported Laravel versions. Check the package composer.json and README for current Laravel and PHP constraints before installing. If your app is pinned to Carbon 2 or an older PHP line, verify compatibility or pin an earlier package version.
- Does queue-promises support Carbon 3 and PHP 8.5?
- Yes, the v1.9.0 release note states PHP 8.5 support and a Carbon 3 support fix. That does not guarantee unchanged behavior in your application, so review the changelog and run date and time regression tests. If you remain on Carbon 2, confirm whether this release affects you before upgrading.
- How does promise-style handling work with Laravel queue jobs?
- The package lets you dispatch queued work asynchronously and await its result through a promise-style API instead of manually coordinating job completion. The jobs still run on your existing Laravel queue, so queue workers and drivers remain part of the setup. Review the README for the exact promise methods and failure handling.
- Can I await a queued job result in Laravel with queue-promises?
- The package is intended to let you await results from queued jobs through its promise API. Avoid blocking long-running HTTP requests while awaiting; prefer short waits or move coordination to a background process. Confirm timeout and failure behavior in your queue configuration and the package docs.
- How should I test queue-promises in a Laravel application?
- Use Laravel queue fakes for unit-level dispatch assertions and add integration tests with a real queue driver for promise resolution. Cover success, job failure, timeout, and serialization cases because promise coordination depends on queue behavior. Run the suite against the PHP and Carbon versions you plan to deploy.
- What are the production risks of using queue-promises?
- The main risks are queue reliability, job timeouts, failure propagation, and blocking callers that await results. The v1.9.0 compatibility update also means you should regression-test date and time behavior if you move to Carbon 3 or PHP 8.5. Monitor failed jobs, set timeouts, and keep a rollback path.
- What alternatives exist to queue-promises for async Laravel jobs?
- Laravel's native job chaining, batching, events, and callbacks cover many async coordination needs without an extra package. For monitoring and queue operations, tools like Horizon may help depending on your queue driver. Compare queue-promises when you specifically want a promise-style await API over existing jobs.
- Is queue-promises actively maintained and safe to adopt?
- The v1.9.0 release shows active compatibility maintenance for PHP 8.5 and Carbon 3, but the one-line release note provides limited detail. Review the repository changelog, open issues, test coverage, and security policy before adopting it as a critical dependency. Pin versions and schedule periodic compatibility reviews.
Weaver
How can I help you explore Laravel packages today?