增加 Cloudflare 支持

Author: limingxinleo

README.md

@@ -138,3 +138,59 @@ class IndexController extends Controller
 }
 
 ```
+
+### 使用 Cloudflare
+
+安装组件
+
+```shell
+composer require cloudflare/sdk
+```
+
+设置环境变量
+
+```dotenv
+DNS_CLOUD_CLOUDFLARE_EMAIL="xxx"
+DNS_CLOUD_CLOUDFLARE_API_KEY="xxx"
+```
+
+编写测试代码，我们直接把代码全部写到控制器里，开发者请按照实际情况酌情处理
+
+```php
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of Hyperf.
+ *
+ * @link     https://www.hyperf.io
+ * @document https://hyperf.wiki
+ * @contact  group@hyperf.io
+ * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
+ */
+
+namespace App\Controller;
+
+use Cloudflare\API\Adapter\Guzzle;
+use Cloudflare\API\Endpoints\User;
+use Gemini\DnsCloud\Factory;
+use Hyperf\Di\Annotation\Inject;
+
+class IndexController extends Controller
+{
+    #[Inject]
+    protected Factory $factory;
+
+    public function index()
+    {
+        /** @var Guzzle $client */
+        $client = $this->factory->get('cloudflare')->client();
+        
+        $user = new User($client);
+
+        return $this->response->success($user->getUserID());
+    }
+}
+
+```
+

composer.json

@@ -27,6 +27,7 @@
     "require-dev": {
         "alibabacloud/alidns-20150109": "^3.0",
         "alibabacloud/darabonba-openapi": "^0.2.9",
+        "cloudflare/sdk": "^1.3",
         "friendsofphp/php-cs-fixer": "^3.0",
         "hyperf/config": "^3.0",
         "hyperf/support": "^3.0",

publish/dns_cloud.php

@@ -10,6 +10,7 @@
  * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
  */
 use Gemini\DnsCloud\Client\Aliyun\AliyunClient;
+use Gemini\DnsCloud\Client\Cloudflare\CloudflareClient;
 use Gemini\DnsCloud\Client\Tencent\TencentClient;
 
 use function Hyperf\Support\env;
@@ -25,4 +26,9 @@
         'secret_key' => env('DNS_CLOUD_TENCENT_SECRET_KEY'),
         'client' => TencentClient::class,
     ],
+    'cloudflare' => [
+        'email' => env('DNS_CLOUD_CLOUDFLARE_EMAIL'),
+        'api_key' => env('DNS_CLOUD_CLOUDFLARE_API_KEY'),
+        'client' => CloudflareClient::class,
+    ],
 ];

src/Client/Cloudflare/CloudflareClient.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of Hyperf.
+ *
+ * @link     https://www.hyperf.io
+ * @document https://hyperf.wiki
+ * @contact  group@hyperf.io
+ * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
+ */
+
+namespace Gemini\DnsCloud\Client\Cloudflare;
+
+use Cloudflare\API\Adapter\Guzzle;
+use Cloudflare\API\Auth\APIKey;
+use Gemini\DnsCloud\Client\ClientInterface;
+
+class CloudflareClient implements ClientInterface
+{
+    protected APIKey $key;
+
+    protected string $email;
+
+    protected string $apiKey;
+
+    public function __construct(array $config = [])
+    {
+        $this->email = $config['email'];
+        $this->apiKey = $config['api_key'];
+
+        $this->key = new APIKey($this->email, $this->apiKey);
+    }
+
+    public function client(): mixed
+    {
+        return new Guzzle($this->key);
+    }
+}

tests/Cases/CloudflareTest.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * This file is part of Hyperf.
+ *
+ * @link     https://www.hyperf.io
+ * @document https://hyperf.wiki
+ * @contact  group@hyperf.io
+ * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
+ */
+
+namespace HyperfTest\Cases;
+
+use Cloudflare\API\Adapter\Guzzle;
+use Cloudflare\API\Endpoints\User;
+use Gemini\DnsCloud\Client\Cloudflare\CloudflareClient;
+use Gemini\DnsCloud\Factory;
+use Hyperf\Config\Config;
+
+/**
+ * @internal
+ * @coversNothing
+ */
+class CloudflareTest extends AbstractTestCase
+{
+    public function testGetUserID()
+    {
+        $this->markTestSkipped('暂时跳过');
+
+        $config = new Config([
+            'dns_cloud' => [
+                'cloudflare' => [
+                    'email' => 'xxx',
+                    'api_key' => 'xxx',
+                    'client' => CloudflareClient::class,
+                ],
+            ],
+        ]);
+
+        $factory = new Factory($config);
+
+        /** @var Guzzle $client */
+        $client = $factory->get('cloudflare')->client();
+        $user = new User($client);
+
+        $this->assertIsString($user->getUserID());
+    }
+}