Install

Works with Drupal: ^11.2 || ^12

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 67.18 KB
MD5: 55d0cfb88e89990c41125874bf2bb12c
SHA-1: 7120450c2d4f58fe29247c46ed44333db68a9ce7
SHA-256: b00214f7d0391d4284dad1144f80e7761ae59ab84062243a053672acc921601b
Download zip 112.01 KB
MD5: 60b44f45036dcef46f8dfb23e0fde49a
SHA-1: 424c1463f6f3235a2b8a5cad6b06fb292d8d6112
SHA-256: bad1a88e3b2302fed601b167e44f1a6fb5fafd0215ddfe8f2bd3a16c35567582

Release notes

Adds presigned direct-to-R2 uploads and downloads, copies files inside R2 when they move within a scheme, lets the private:// takeover work without a private file path, and fixes renaming a file onto itself, which deleted it. Requires Drupal 11.2 or later.

Changes since 1.0.0-alpha4

  • Issue #3610175: New PresignerInterface service. presignUpload() returns a PUT URL with the Content-Type and Content-Length bound into the signature, so R2 refuses any other type or size; a checksum, Cache-Control, Content-Disposition or x-amz-meta-* header can be bound the same way. presignDownload() returns a GET URL, and verifyUpload() checks an uploaded object against R2.
  • Issue #3610175: Renaming or moving a file within one scheme now copies the object inside R2 instead of downloading and re-uploading it through PHP.
  • Issue #3610175: Renaming a file onto itself no longer deletes it. This affected all earlier alphas: renaming a file to a differently written URI for the same file (for example private:///a and private://a) deleted it.
  • Issue #3610175: With the private:// takeover on, private:// now exists without $settings['file_private_path'].
  • Issue #3610175: The status report shows which bucket each public:// and private:// takeover uses, or why its files cannot reach R2.
  • Issue #3610175: README: the install command for sites with minimum-stability: stable, guidance for presigned uploads (CORS, lifecycle rules, validation), and the private:// takeover without a private path.
  • Issue #3610175: The stream wrappers declare native return types on the PHP stream wrapper methods, which Drupal 12 now expects. A class that extends StorageStreamWrapperBase must add the same native return types to any of these methods it overrides.
  • Issue #3610175: Drupal 11.2 or later is now required (^11.2 || ^12), so the hook_help compatibility shim for older cores is gone.
Created by: zach.bimson
Created on: 31 Oct 2026 at 14:19 UTC
Last updated: 31 Oct 2026 at 14:19 UTC
Bug fixes
New features

Other releases