支持 TDengine 3.0 时区配置 (#9)

* 新增时区配置

* 规范时区配置

* 增加timezone配置项的说明

* php-cs-fixer格式代码

* Update README.md

Co-authored-by: Yurun <admin@yurunsoft.com>

Author: onlyshow

README.md

@@ -38,6 +38,7 @@
     // 'timestampFormat' => \Yurun\TDEngine\Constants\TimeStampFormat::LOCAL_STRING, // 此配置 TDengine 3.0 下失效，统一返回格式为：2022-11-25T05:41:04.690Z
     // 'keepAlive'       => true,
     // 'version'         => '3', // TDengine 版本
+    // 'timezone'        => 'UTC', // TDengine >= 3.0 时支持，可选参数，指定返回时间的时区
 ]));
 // 设置默认数据库为test
 \Yurun\TDEngine\TDEngineManager::setDefaultClientName('test');
@@ -59,6 +60,7 @@ $client = new \Yurun\TDEngine\Client(new \Yurun\TDEngine\ClientConfig([
     // 'timestampFormat' => \Yurun\TDEngine\Constants\TimeStampFormat::LOCAL_STRING, // 此配置 TDengine 3.0 下失效，统一返回格式为：2022-11-25T05:41:04.690Z
     // 'keepAlive'       => true,
     // 'version'         => '3', // TDengine 版本
+    // 'timezone'        => 'UTC', // TDengine >= 3.0 时支持，可选参数，指定返回时间的时区
 ]));
 
 // 通过 sql 方法执行 sql 语句

src/Client.php

@@ -43,8 +43,16 @@ public function getConfig(): ClientConfig
     public function buildUrl(string $path): string
     {
         $config = $this->getConfig();
+        if (version_compare($config->getVersion(), '3', '<'))
+        {
+            $query = '';
+        }
+        else
+        {
+            $query = http_build_query(['tz' => $config->getTimezone()]);
+        }
 
-        return Uri::makeUri($config->getHost(), $path, '', $config->getPort(), $config->getSsl() ? 'https' : 'http', '', $config->getUser() . ':' . $config->getPassword())->__toString();
+        return Uri::makeUri($config->getHost(), $path, $query, $config->getPort(), $config->getSsl() ? 'https' : 'http', '', $config->getUser() . ':' . $config->getPassword())->__toString();
     }
 
     private function getHttpClient(): HttpRequest

src/ClientConfig.php

@@ -60,6 +60,11 @@ class ClientConfig
      */
     protected $version = '3';
 
+    /**
+     * @var string
+     */
+    protected $timezone = 'UTC';
+
     public function __construct(array $config = [])
     {
         if ($config)
@@ -190,4 +195,16 @@ public function setVersion(string $version): self
 
         return $this;
     }
+
+    public function getTimezone(): string
+    {
+        return $this->timezone;
+    }
+
+    public function setTimezone(string $timezone): self
+    {
+        $this->timezone = $timezone;
+
+        return $this;
+    }
 }