Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Cloudflare Queue

No security coverage Under active development

Part of the Cloudflare ecosystem · 20 projects

This module allows you to run Drupal's queue system using Cloudflare Queues without any code changes. It leverages Cloudflare's managed, global message queue system, eliminating the need to manage your own message broker.

Run Drupal's queue system on Cloudflare Queues with no code changes. Opt a queue (cron queues, the Batch API, or a custom queue worker) onto the Cloudflare backend in settings.php, and items are enqueued and consumed over the Cloudflare Queues HTTP pull/ack API.

Cloudflare Queues is a managed, global message queue. Unlike most queue backends, you do not stand up or wire a broker: the queue is provisioned and tracked for you by the Cloudflare Compute module, and this module runs Drupal's queue on it.

Features

  • Implements Drupal's ReliableQueueInterface and DelayableQueueInterface, so existing queue workers run unchanged and can back off with DelayedRequeueException.
  • Consumes a queue provisioned and tracked by Cloudflare Compute (its id and credentials come from the queue asset); no broker to operate.
  • At-least-once delivery over the Cloudflare Queues HTTP pull/ack API, with visibility-timeout leases and retries.
  • Retries and dead letters follow the queue's HTTP pull consumer, which Cloudflare Compute manages from the queue asset (retry limit and dead-letter queue).
  • Swappable payload codec: JSON by default, or an opt-in PHP-serialize codec that preserves object payloads.

Post-Installation

  1. Register the Cloudflare queue on Cloudflare Compute's Cloudflare Queues page (Configuration > Web services > Cloudflare Queues), or provision it in code through this module's cloudflare_queue_backend capability with the Cloudflare SDK's reconciler. On the queue's form, tick 'Reconcile this queue's HTTP pull consumer' and set a retry limit and a dead-letter queue.
  2. Opt a Drupal queue onto the backend in settings.php, for example: $settings['queue_service_my_worker'] = 'queue.cloudflare';
  3. Optionally change the Cloudflare queue-name prefix (default "drupal-") in the module settings.

Additional Requirements

Requires Drupal 11.2 or later, the Cloudflare API (cloudflare_api), Cloudflare SDK (cloudflare_sdk) and Cloudflare Compute (cloudflare_compute) modules, and a Cloudflare API token with Queues Edit permission (queues#read and queues#write). While the suite is in alpha, install it together with its alpha dependencies:

composer require drupal/cloudflare_queue:^1.0@alpha drupal/cloudflare_compute:^1.0@alpha drupal/cloudflare_sdk:^1.0@alpha drupal/cloudflare_api:^1.0@alpha

Composer applies a stability flag such as @alpha only to packages the root composer.json requires, so on a site with minimum-stability: stable, requiring this module alone fails. Alternatively, allow alpha releases site-wide with minimum-stability: alpha and prefer-stable: true.

None beyond the required dependencies. Cloudflare Compute (a hard dependency) provisions and tracks the queue this backend runs on.

Similar projects

Like the core database queue, or backends such as RabbitMQ and AWS SQS, this provides a Drupal queue implementation. The difference is provisioning: the queue is created and tracked for you as configuration (by Cloudflare Compute), and it runs over Cloudflare's global HTTP API with no broker or separate worker to operate.

Supporting this Module

Issue reports, patches and feedback are welcome in the project's issue queue.

Community Documentation

Ask your assistant about Cloudflare Queue

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
4
Tracked since
Jul 2026
Latest release
3 weeks ago
Releases (12 mo)
4 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.0.0-alpha4 Pre-release 11 PHP >=8.3 Oct 31, 2026
1.0.0-alpha3 Pre-release 11 Jul 11, 2026
1.0.0-alpha2 Pre-release 11 Jul 11, 2026
1.0.0-alpha1 Pre-release 11 Jul 7, 2026