PHPackages firevel/cloud-tasks-queue-driver - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Queues & Workers](/categories/queues) 4. / 5. firevel/cloud-tasks-queue-driver ActiveLibrary[Queues & Workers](/categories/queues) firevel/cloud-tasks-queue-driver ================================ Cloud Tasks queue driver for Laravel apps running inside Google App Engine. 1.2.0(1mo ago)412.9k↓62.3%MITPHPCI passing Since Oct 8Pushed 1mo ago1 watchersCompare [ Source](https://github.com/firevel/cloud-tasks-queue-driver)[ Packagist](https://packagist.org/packages/firevel/cloud-tasks-queue-driver)[ RSS](/packages/firevel-cloud-tasks-queue-driver/feed)WikiDiscussions master Synced 2w ago READMEChangelog (8)Dependencies (4)Versions (9)Used By (0) Cloud Tasks Queue Driver for Laravel ==================================== [](#cloud-tasks-queue-driver-for-laravel) [![tests](https://github.com/firevel/cloud-tasks-queue-driver/actions/workflows/tests.yml/badge.svg)](https://github.com/firevel/cloud-tasks-queue-driver/actions/workflows/tests.yml) A Laravel queue driver for [Google Cloud Tasks](https://cloud.google.com/tasks), enabling serverless job processing for applications running on Google App Engine or Google Cloud Run. Compatible with both [Firevel](https://github.com/firevel/firevel) and standard Laravel applications. Requirements ------------ [](#requirements) - PHP 8.0+ (tested on 8.2, 8.3, and 8.4) - Laravel 8.x – 12.x (tested against 11.x and 12.x) - Google Cloud Project with Cloud Tasks API enabled Installation ------------ [](#installation) ``` composer require firevel/cloud-tasks-queue-driver ``` The package auto-discovers and registers itself via Laravel's package discovery. Configuration ------------- [](#configuration) Add the connection to your `config/queue.php`: ``` 'connections' => [ 'cloudtasks' => [ 'driver' => 'cloudtasks', 'project' => env('GOOGLE_CLOUD_PROJECT'), 'location' => env('CLOUD_TASKS_LOCATION', 'us-central1'), 'queue_name' => env('CLOUD_TASKS_QUEUE', 'default'), 'route' => env('CLOUD_TASKS_ROUTE', '/_cloudtasks'), // App Engine specific (optional) 'service' => env('GAE_SERVICE'), 'version' => env('GAE_VERSION'), // Cloud Run specific (optional) 'url' => env('CLOUD_TASKS_URL'), ], ], ``` Set your default queue connection in `.env`: ``` QUEUE_CONNECTION=cloudtasks CLOUD_TASKS_LOCATION=us-central1 ``` > **Note:** The `location` must match your App Engine or Cloud Run region. ### Configuration Options [](#configuration-options) OptionDescription`project`Google Cloud project ID`location`Cloud Tasks queue location (must match your compute region)`queue_name`Default queue name`route`HTTP endpoint path for task callbacks`service`App Engine service name (falls back to the `GAE_SERVICE` env variable when not set)`version`App Engine version to route tasks to (when not set, tasks go to the service's default version)`url`Custom URL for Cloud Run or when behind a proxy/load balancerCloud Tasks Setup ----------------- [](#cloud-tasks-setup) Create a queue using `gcloud`: ``` gcloud tasks queues create default ``` Or via `queue.yaml`: ``` queue: - name: default rate: 500/s ``` See the [Cloud Tasks documentation](https://cloud.google.com/tasks/docs/queue-yaml) for advanced queue configuration. Usage ----- [](#usage) Use Laravel's standard queue API: ``` // Dispatch a job dispatch(new ProcessOrder($order)); // Dispatch with delay dispatch(new ProcessOrder($order))->delay(now()->addMinutes(5)); // Dispatch to a specific queue dispatch(new ProcessOrder($order))->onQueue('orders'); ``` > **Note:** Queue names map directly to Cloud Tasks queues, so `onQueue('orders')` requires a Cloud Tasks queue named `orders` to exist. How It Works ------------ [](#how-it-works) Unlike traditional queue drivers, there is no `queue:work` process. Cloud Tasks delivers each job back to your application over HTTP: 1. Dispatching a job creates a Cloud Task with the serialized job as its payload, signed with an HMAC-SHA256 signature derived from your `APP_KEY`. 2. Cloud Tasks sends the payload via HTTP POST to the handler route (`/_cloudtasks` by default), which the package registers automatically. 3. The handler verifies the signature, rejects unauthenticated requests with a 403, and processes valid jobs through Laravel's queue worker. > **Note:** Since job payloads are signed with `APP_KEY`, rotating the key will invalidate tasks that were queued before the rotation. Retries, Attempts and Overlapping --------------------------------- [](#retries-attempts-and-overlapping) - **Retries** are managed by the Cloud Tasks queue configuration (`maxAttempts`, backoff, etc.). A failed job returns a 500 response and Cloud Tasks redelivers it according to the queue's retry policy. - **Per-job attempts** are supported: when a job defines `$tries`, it is marked as failed once the limit is reached and the handler responds with a 200 so Cloud Tasks stops redelivering it. `$job->attempts()` is 1-based (1 on the first attempt), derived from the `X-CloudTasks-TaskRetryCount` / `X-AppEngine-TaskRetryCount` headers. - **Releasing** (`$this->release($delay)`) creates a fresh Cloud Task with the same payload, since Cloud Tasks has no native release. The attempt count is carried over in the payload. This also makes the [`WithoutOverlapping`](https://laravel.com/docs/queues#preventing-job-overlaps) job middleware work as expected — overlapping jobs are pushed back instead of lost. It requires a cache store that supports atomic locks. - **Unique jobs** (`ShouldBeUnique`) work out of the box; the unique lock is handled by Laravel at dispatch time and also requires a lock-capable cache store. - To process an entire queue serially (one task at a time), set `maxConcurrentDispatches=1` on the Cloud Tasks queue — no application code needed. Routing Behavior ---------------- [](#routing-behavior) - **App Engine:** Tasks are routed to the specific service and version that dispatched them, ensuring version consistency during deployments. - **Cloud Run:** Tasks are routed to the currently promoted revision. Testing ------- [](#testing) The test suite uses [Orchestra Testbench](https://github.com/orchestral/testbench) and runs without any Google Cloud credentials (the Cloud Tasks client is mocked). ``` composer install composer test ``` Tests run automatically via GitHub Actions on PHP 8.2, 8.3, and 8.4 for every push and pull request. License ------- [](#license) MIT ### Health Score 51 — FairBetter than 95% of packages Maintenance92 Actively maintained with recent releases Popularity29 Limited adoption so far Community9 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 90% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~300 days Recently: every ~292 days Total 8 Last Release 39d ago Major Versions 0.1.1 → 1.0.02026-07-03 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/2696038?v=4)[Michael Slowik](/maintainers/sl0wik)[@sl0wik](https://github.com/sl0wik) --- Top Contributors [![sl0wik](https://avatars.githubusercontent.com/u/2696038?v=4)](https://github.com/sl0wik "sl0wik (36 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (4 commits)") --- Tags laravelqueuefirevelcloud tasks ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/firevel-cloud-tasks-queue-driver/health.svg) ``` [![Health](https://phpackages.com/badges/firevel-cloud-tasks-queue-driver/health.svg)](https://phpackages.com/packages/firevel-cloud-tasks-queue-driver) ``` ### Alternatives [stackkit/laravel-google-cloud-tasks-queue Google Cloud Tasks queue driver for Laravel 89714.3k](/packages/stackkit-laravel-google-cloud-tasks-queue)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 46273.9k](/packages/harris21-laravel-fuse)[pmatseykanets/artisan-beans Easily manage your Beanstalkd job queues right from the Laravel artisan command 4282.5k](/packages/pmatseykanets-artisan-beans) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)