Added support for CloudflareR2 Storage adaptar

.github/workflows/tests.yml

@@ -58,7 +58,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        devices: [BackblazeTest, DOSpacesTest, LinodeTest, LocalTest, S3Test, WasabiTest]
+        devices: [BackblazeTest, DOSpacesTest, LinodeTest, LocalTest, S3Test, WasabiTest, CloudflareR2Test]
 
     steps:
       - name: checkout
@@ -75,6 +75,8 @@ jobs:
           WASABI_SECRET: ${{ secrets.WASABI_SECRET }}
           BACKBLAZE_ACCESS_KEY: ${{ secrets.BACKBLAZE_ACCESS_KEY }}
           BACKBLAZE_SECRET: ${{ secrets.BACKBLAZE_SECRET }}
+          CLOUDFLARE_R2_ACCESS_KEY: ${{ secrets.CLOUDFLARE_R2_ACCESS_KEY }}
+          CLOUDFLARE_R2_SECRET: ${{ secrets.CLOUDFLARE_R2_SECRET }}
         run: |
           docker compose up -d
           sleep 10

docker-compose.yml

@@ -20,4 +20,6 @@ services:
       - BACKBLAZE_ACCESS_KEY
       - BACKBLAZE_SECRET
       - WASABI_ACCESS_KEY
-      - WASABI_SECRET
+      - WASABI_SECRET
+      - CLOUDFLARE_R2_ACCESS_KEY
+      - CLOUDFLARE_R2_SECRET

src/Storage/Device/CloudflareR2.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace Utopia\Storage\Device;
+
+use Utopia\Storage\Storage;
+
+class CloudflareR2 extends S3
+{
+    /**
+     * Regions constants
+     * Reference: https://developers.cloudflare.com/durable-objects/platform/data-location/
+     */
+
+    /**
+     * Regions constants
+     */
+    const WNAM = 'us-west-1';
+
+    const ENAM = 'us-east-1';
+
+    const WEUR = 'eu-west-1';
+
+    const EEUR = 'eu-east-1';
+
+    const APAC = 'ap-southeast-1';
+
+    const AUTO = 'auto';
+
+    /**
+     * Cloudflare R2 Constructor
+     *
+     * @param  string  $root
+     * @param  string  $accessKey
+     * @param  string  $secretKey
+     * @param  string  $bucket
+     * @param  string  $region
+     * @param  string  $acl
+     */
+    public function __construct(string $root, string $accessKey, string $secretKey, string $bucket, string $region = self::APAC, string $acl = self::ACL_PRIVATE)
+    {
+        parent::__construct($root, $accessKey, $secretKey, $bucket, $region, $acl);
+        $this->headers['host'] = $bucket.'.'.'s3'.'.'.$region.'.cloudflarestorage.com';
+    }
+
+    /**
+     * @return string
+     */
+    public function getName(): string
+    {
+        return 'Cloudflare R2 Storage';
+    }
+
+    /**
+     * @return string
+     */
+    public function getDescription(): string
+    {
+        return 'Cloudflare R2 Storage';
+    }
+
+    /**
+     * @return string
+     */
+    public function getType(): string
+    {
+        return Storage::DEVICE_CLOUDFLARER2;
+    }
+}

src/Storage/Storage.php

@@ -21,6 +21,8 @@ class Storage
 
     const DEVICE_LINODE = 'linode';
 
+    const CLOUDFARE_R2 = 'cloudflarer2';
+
     /**
      * Devices.
      *

tests/Storage/Device/CloudflareR2Test.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Utopia\Tests\Storage\Device;
+
+use Utopia\Storage\Device\CloudflareR2;
+use Utopia\Tests\Storage\S3Base;
+
+class CloudflareR2Test extends S3Base
+{
+    protected function init(): void
+    {
+        $this->root = '/root';
+        $key = $_SERVER['CLOUDFLARE_R2_ACCESS_KEY'] ?? '';
+        $secret = $_SERVER['CLOUDFLARE_R2_SECRET'] ?? '';
+        $bucket = 'utopia-storage-test';
+
+        $this->object = new CloudflareR2($this->root, $key, $secret, $bucket, CloudflareR2::AUTO, CloudflareR2::ACL_PRIVATE);
+    }
+
+    protected function getAdapterName(): string
+    {
+        return 'Cloudflare R2 Storage';
+    }
+
+    protected function getAdapterType(): string
+    {
+        return $this->object->getType();
+    }
+
+    protected function getAdapterDescription(): string
+    {
+        return 'Cloudflare R2 Storage';
+    }
+}