当前位置：首页 > news >正文

TDengine 语言连接器（PHP）

news 来源：原创 2025/8/21 10:18:07

简介

PHP 语言广泛用于 Web 开发的开源脚本语言。它语法简单，容易学习，既支持面向过程，也支持面向对象编程。具有跨平台性，能与多种数据库交互，可与 HTML 等前端技术配合，动态生成网页内容。常用于开发各类网站、API 及编写命令行脚本，拥有大量开源项目和活跃社区，在 Web 开发领域始终占据重要地位。

php-tdengine 是由社区贡献的 PHP 连接器扩展，还特别支持了 Swoole 协程化。

PHP 连接器依赖 TDengine 客户端驱动。

项目地址：https://github.com/Yurunsoft/php-tdengine

TDengine 服务端或客户端安装后，taos.h 位于：

Linux：/usr/local/taos/include
Windows：C:\TDengine\include
macOS：/usr/local/include

TDengine 客户端驱动的动态库位于：

Linux：/usr/local/taos/driver/libtaos.so
Windows：C:\TDengine\taos.dll
macOS：/usr/local/lib/libtaos.dylib

支持的平台

Windows、Linux、MacOS
PHP >= 7.4
TDengine >= 2.0
Swoole >= 4.8 (可选)

支持的版本

TDengine 客户端驱动的版本号与 TDengine 服务端的版本号是一一对应的强对应关系，建议使用与 TDengine 服务端完全相同的客户端驱动。虽然低版本的客户端驱动在前三段版本号一致（即仅第四段版本号不同）的情况下也能够与高版本的服务端相兼容，但这并非推荐用法。强烈不建议使用高版本的客户端驱动访问低版本的服务端。

安装步骤

安装 TDengine 客户端驱动

TDengine 客户端驱动的安装请参考安装指南

编译安装 php-tdengine

下载代码并解压：

curl -L -o php-tdengine.tar.gz https://github.com/Yurunsoft/php-tdengine/archive/refs/tags/v1.0.2.tar.gz \
&& mkdir php-tdengine \
&& tar -xzf php-tdengine.tar.gz -C php-tdengine --strip-components=1

版本 v1.0.2 可替换为任意更新的版本，可在 TDengine PHP Connector 发布历史。

非 Swoole 环境：

phpize && ./configure && make -j && make install

手动指定 tdengine 目录：

phpize && ./configure --with-tdengine-dir=/usr/local/Cellar/tdengine/3.0.0.0 && make -j && make install

--with-tdengine-dir= 后跟上 tdengine 目录。
适用于默认找不到的情况，或者 MacOS 系统用户。

Swoole 环境：

phpize && ./configure --enable-swoole && make -j && make install

启用扩展：

方法一：在 php.ini 中加入 extension=tdengine

方法二：运行带参数 php -dextension=tdengine test.php

示例程序

本节展示了使用客户端驱动访问 TDengine 集群的常见访问方式的示例代码。

所有错误都会抛出异常：TDengine\Exception\TDengineException

建立连接

<?phpuse TDengine\Connection;
use TDengine\Exception\TDengineException;try {// instantiate$host = 'localhost';$port = 6030;$username = 'root';$password = 'taosdata';$dbname = null;$connection = new Connection($host, $port, $username, $password, $dbname);// connect$connection->connect();
} catch (TDengineException $e) {// throw exceptionthrow $e;
}

插入数据

<?phpuse TDengine\Connection;
use TDengine\Exception\TDengineException;try {// instantiate$host = 'localhost';$port = 6030;$username = 'root';$password = 'taosdata';$dbname = 'power';$connection = new Connection($host, $port, $username, $password, $dbname);// connect$connection->connect();// insert$connection->query('CREATE DATABASE if not exists power');$connection->query('CREATE STABLE if not exists meters (ts TIMESTAMP, current FLOAT, voltage INT, phase FLOAT) TAGS (location BINARY(64), groupId INT)');$resource = $connection->query(<<<'SQL'INSERT INTO power.d1001 USING power.meters TAGS(California.SanFrancisco, 2) VALUES ('2018-10-03 14:38:05.000', 10.30000, 219, 0.31000) ('2018-10-03 14:38:15.000', 12.60000, 218, 0.33000) ('2018-10-03 14:38:16.800', 12.30000, 221, 0.31000)power.d1002 USING power.meters TAGS(California.SanFrancisco, 3) VALUES ('2018-10-03 14:38:16.650', 10.30000, 218, 0.25000)power.d1003 USING power.meters TAGS(California.LosAngeles, 2) VALUES ('2018-10-03 14:38:05.500', 11.80000, 221, 0.28000) ('2018-10-03 14:38:16.600', 13.40000, 223, 0.29000)power.d1004 USING power.meters TAGS(California.LosAngeles, 3) VALUES ('2018-10-03 14:38:05.000', 10.80000, 223, 0.29000) ('2018-10-03 14:38:06.500', 11.50000, 221, 0.35000)SQL);// get affected rowsvar_dump($resource->affectedRows());
} catch (TDengineException $e) {// throw exceptionthrow $e;
}

同步查询

<?phpuse TDengine\Connection;
use TDengine\Exception\TDengineException;try {// instantiate$host = 'localhost';$port = 6030;$username = 'root';$password = 'taosdata';$dbname = 'power';$connection = new Connection($host, $port, $username, $password, $dbname);// connect$connection->connect();$resource = $connection->query('SELECT ts, current FROM meters LIMIT 2');var_dump($resource->fetch());
} catch (TDengineException $e) {// throw exceptionthrow $e;
}

参数绑定

<?phpuse TDengine\Connection;
use TDengine\Exception\TDengineException;try {// instantiate$host = 'localhost';$port = 6030;$username = 'root';$password = 'taosdata';$dbname = 'power';$connection = new Connection($host, $port, $username, $password, $dbname);// connect$connection->connect();// insert$connection->query('CREATE DATABASE if not exists power');$connection->query('CREATE STABLE if not exists meters (ts TIMESTAMP, current FLOAT, voltage INT, phase FLOAT) TAGS (location BINARY(64), groupId INT)');$stmt = $connection->prepare('INSERT INTO ? USING meters TAGS(?, ?) VALUES(?, ?, ?, ?)');// set table name and tags$stmt->setTableNameTags('d1001', [// same format as parameter binding[TDengine\TSDB_DATA_TYPE_BINARY, 'California.SanFrancisco'],[TDengine\TSDB_DATA_TYPE_INT, 2],]);$stmt->bindParams([[TDengine\TSDB_DATA_TYPE_TIMESTAMP, 1648432611249],[TDengine\TSDB_DATA_TYPE_FLOAT, 10.3],[TDengine\TSDB_DATA_TYPE_INT, 219],[TDengine\TSDB_DATA_TYPE_FLOAT, 0.31],]);$stmt->bindParams([[TDengine\TSDB_DATA_TYPE_TIMESTAMP, 1648432611749],[TDengine\TSDB_DATA_TYPE_FLOAT, 12.6],[TDengine\TSDB_DATA_TYPE_INT, 218],[TDengine\TSDB_DATA_TYPE_FLOAT, 0.33],]);$resource = $stmt->execute();// get affected rowsvar_dump($resource->affectedRows());
} catch (TDengineException $e) {// throw exceptionthrow $e;
}

常量

常量	说明
`TDengine\TSDB_DATA_TYPE_NULL`	null
`TDengine\TSDB_DATA_TYPE_BOOL`	bool
`TDengine\TSDB_DATA_TYPE_TINYINT`	tinyint
`TDengine\TSDB_DATA_TYPE_SMALLINT`	smallint
`TDengine\TSDB_DATA_TYPE_INT`	int
`TDengine\TSDB_DATA_TYPE_BIGINT`	bigint
`TDengine\TSDB_DATA_TYPE_FLOAT`	float
`TDengine\TSDB_DATA_TYPE_DOUBLE`	double
`TDengine\TSDB_DATA_TYPE_BINARY`	binary
`TDengine\TSDB_DATA_TYPE_VARBINARY`	varbinary
`TDengine\TSDB_DATA_TYPE_TIMESTAMP`	timestamp
`TDengine\TSDB_DATA_TYPE_NCHAR`	nchar
`TDengine\TSDB_DATA_TYPE_UTINYINT`	utinyint
`TDengine\TSDB_DATA_TYPE_USMALLINT`	usmallint
`TDengine\TSDB_DATA_TYPE_UINT`	uint
`TDengine\TSDB_DATA_TYPE_UBIGINT`	ubigint

TDengine 语言连接器（PHP）

简介 PHP 语言广泛用于 Web 开发的开源脚本语言。它语法简单，容易学习，既支持面向过程，也支持面向对象编程。具有跨平台性，能与多种数据库交互，可与 HTML 等前端技术配合，动态生成网页内容。常用于开发各类…...

编程日记 2025/8/21 10:18:07

使用docker该怎么做：从公有仓库拉取镜像并上传到私有仓库

在容器化部署中，将公有镜像仓库（如Docker Hub）的镜像迁移到私有仓库（如Harbor、Nexus）是常见需求。一、为什么需要将镜像从公有仓库传到私有仓库？ 网络连通性：公有仓库依赖公网访问&#xff…...

编程日记 2025/8/17 18:22:14

list的使用

1：list文档 list文档在之前我们对于链表有过最初始的模拟实现，现在进入C之后，我们可以在STL库中发现到链表这个容器的使用，list的底层也是我们最初实现的双向链表。 2：list的使用 list的接口有很多，我们…...

编程日记 2025/8/20 3:58:06

Redis遇到Hash冲突怎么办

在 Redis 中，哈希冲突通常是指当多个键的哈希值相同或位于相同的哈希槽中时发生冲突。Redis 通过底层的哈希表和一些冲突解决机制（如开放地址法、链表法等）来处理哈希冲突问题。这些通常是透明的，作为开发者，我们无需直…...

编程日记 2025/8/17 21:03:23

OpenCV 图形API（42）颜色空间转换-----将 BGR图像转换为 I420（YUV 4:2:0）格式函数BGR2I420()

操作系统：ubuntu22.04 OpenCV版本：OpenCV4.9 IDE:Visual Studio Code 编程语言：C11 算法描述将图像从BGR色彩空间转换为I420色彩空间。该函数将输入图像从BGR色彩空间转换为I420。R、G和B通道值的传统范围是0到255。输出图像必须是8位无…...

编程日记 2025/8/20 4:26:11

简述Apache RocketMQ

整体架构分析基本流程模块特性发送消息流程原理分析同步发送 sync 异步发送 async 直接发送 one-way 主从同步（HA）机制分析消息投递持久化机制 RocketMQ的RPC通信 RocketMQ中Remoting通信模块的具体实现消息的协议涉及与编码解码消…...

编程日记 2025/8/19 21:15:20

AI融合SEO关键词实战指南

内容概要随着人工智能技术的迭代升级，SEO关键词策略正经历从人工经验驱动向数据智能驱动的范式转变。本指南聚焦AI技术在搜索引擎优化中的系统性应用，通过构建多层技术框架实现关键词全生命周期管理。核心方法论涵盖语义分析引擎的构建原理、基于NLP的…...

编程日记 2025/8/21 10:18:07

RK3588 实现音视频对讲

RK3588 实现音视频对讲方案 RK3588是瑞芯微推出的一款高性能处理器，非常适合用于音视频对讲系统的开发。以下是基于RK3588实现音视频对讲的方案概述： 硬件架构核心处理器：RK3588 (4xCortex-A76 4xCortex-A55)视频处理： 内置8…...

编程日记 2025/8/21 10:13:52

OSPF区域间路由计算

ABR：区域边界路由器，连接两个不同区域的设备就称为ABR（不同厂商不同，定义很模糊） ASBR：自治系统边界路由器，引入了外部路由，将不是自治系统外部的不是OSPF路由的条目变成OSPF路由条目…...

编程日记 2025/8/21 10:13:52

NAT、代理服务、内网穿透

NAT、代理服务、内网穿透 1、NAT1.1、NAT过程1.2、NAPT2、内网穿透3、内网打洞3、代理服务器3.1、正向代理3.2、反向代理1、NAT 1.1、NAT过程之前我们讨论了IPv4协议中IP地址数量不充足的问题。NAT技术是当前解决IP地址不够用的主要手段，是路由器的一个重要功能。 NAT能够将…...

编程日记 2025/8/17 18:26:36

阿尔特拉 EP1C12F324I7N AlteraFPGA Cyclone

EP1C12F324I7N 属于 Altera Cyclone I 系列 FPGA 中的中低密度型号，面向成本敏感、功耗受限的嵌入式与数据通路应用。该器件采用 0.13 μm 全层铜 SRAM 工艺，集成约 12 060 个逻辑单元（LE）、239 616 位片上 RAM、249 路可编…...

编程日记 2025/8/21 10:13:53

解决“驱动程序无法通过使用安全套接字层(SSL)加密与 SQL Server 建立安全连接“问题

参考链接: https://blog.csdn.net/yyj12138/article/details/123073146...

编程日记 2025/8/21 10:16:29

QtApplets-实现应用程序单例模式，防止重复运行

QtApplets-实现应用程序单例模式，防止重复运行文章目录 QtApplets-实现应用程序单例模式，防止重复运行摘要引言实现原理核心代码实现头文件定义实现文件使用方法技术要点解析1. 文件锁机制2. 进程 ID 管理3. Windows 互斥量4. 跨平台兼容注意事项…...

编程日记 2025/8/17 18:26:23

nodejs使用pkg打包文件

pkg配置 "pkg": {"assets": ["*.html","*.css","*.js"],"mirror": "https://npmmirror.com/mirrors/node-v8-compile-cache/"},"bin": "server.js",嵌入到exe中的资源使用assets打…...

编程日记 2025/8/20 20:19:48

学习笔记十六——Rust Monad从头学

🧠 零基础也能懂的 Rust Monad：逐步拆解三大定律通俗讲解实战技巧 📣 第一部分：Monad 是什么？ Monad 是一种“包值链操作保持结构”的代码模式，用来处理带上下文的值，并方便连续处理。 …...

编程日记 2025/8/18 14:30:13

Idea连接远程云服务器上的MySQL，开放云服务器端口

1.开放云服务器的3306端口 （1）进入到云服务器的控制台 （2）点击使用的云服务器 （3）点击配置安全组规则 （4）添加规则 （5）开放端口 2.创建可以远程访问…...

编程日记 2025/8/20 2:06:46

云服务器CVM标准型S5实例性能测评——2025腾讯云

腾讯云服务器CVM标准型S5实例具有稳定的计算性能，CPU采用采用 Intel Xeon Cascade Lake 或者 Intel Xeon Cooper Lake 处理器，主频2.5GHz，睿频3.1GHz，CPU内存配置2核2G、2核4G、4核8G、8核16G等配置，公网带宽可选1M、3…...

编程日记 2025/8/20 22:43:28

【Pytorch之一】--torch.stack()方法详解

torch.stack方法详解 pytorch官网注释 Parameters tensors：张量序列，也就是要进行stack操作的对象们，可以有很多个张量。 dim：按照dim的方式对这些张量进行stack操作，也就是你要按照哪种堆叠方式对张量进行堆叠。dim的…...

编程日记 2025/8/20 13:05:13

监控+日志=DevOps 运维的“千里眼”与“顺风耳”

监控+日志=DevOps 运维的“千里眼”与“顺风耳” 在 DevOps 体系中，监控和日志管理是不可或缺的运维基石。有人说，开发只管把代码写好，运维才是真正的“操盘手”，让系统稳定运行、不宕机、不崩溃。而要做到这一点，精准的监控与日志管理是关键。试想一下：如果没有监控…...

编程日记 2025/8/20 13:26:35

实战｜使用环信Flutter SDK构建鸿蒙HarmonyOS应用及推送配置

本文为大家介绍如何在 Flutter 环境创建 Harmony 项目并集成环信即时通讯IM以及环信 Flutter Harmony 推送配置。已经基于环信的 Flutter 项目也可以参考本文适配鸿蒙端。一、开发环境要求前置条件 1.安装DevEco-Studio 2.安装模拟器 DevEco-Studio 下载与操作指导&…...

编程日记 2025/8/17 18:21:30

构建知识体系

我认为，仅仅建立知识点之间的连接还不足够，还要建立自己的知识体系。那么什么是知识体系呢？ 知识体系，可以理解为立体的知识系统。立体的知识系统，代表着跨越了多个领域、行业、学科的知识，是多个层面…...

编程日记 2025/8/20 18:59:46

Android Mainline简介

关键要点 Android Mainline 是通过模块化更新 Android 核心组件的框架，可能提高安全性。允许通过 Google Play 系统更新分发模块，无需完整固件更新。能简化厂商工作并减少碎片化，但覆盖范围有限。什么是 Android Mainline？ And…...

编程日记 2025/8/21 7:26:19

2026《数据结构》考研复习笔记二（C++面向对象）

C面向对象一、类二、继承三、重载运算符和重载函数四、多态代码示例一、类 1.1类&对象 class classname//class是关键词，classname是类名 { Access specifiers://访问修饰符：private/public/protected Date members/variables;//变量 Member fun…...

编程日记 2025/8/21 8:09:14

【C++】12.list接口介绍

在C标准库中，std::list 是一个基于双向链表实现的顺序容器，它支持高效的插入和删除操作，但无法直接通过下标进行随机访问。以下是关于 std::list 的简单介绍： 核心特性底层结构双向链表实现，每个节点包含数据、前驱指…...

编程日记 2025/8/21 2:34:12

决策卫生问题：考公考编考研能补救高考选取职业的错误吗

对于决策者来说，“认识你自己”是一个永恒的主题；警惕认知中的缺陷，比什么都重要。在判断与决策问题上，管理者和专业人士往往都非常自信。人类远远不如我们想象的那么理性，人类的判断也远远不如我们想象的那么完美。在…...

编程日记 2025/8/19 7:13:57

考研系列-计算机网络-第一章、计算机网络体系结构

一、计算机网络概述 1.知识点总结性能指标： 注意这个指标： 2.习题总结 (一)选择题广域网点对点，局域网广播技术 (二)简答题 (1)概念性题目： (2)计算型题目这个题目主要是注意两种交换方式： 电路交换：…...

编程日记 2025/8/17 19:07:44

状态模式：有限状态机在电商订单系统中的设计与实现

状态模式：有限状态机在电商订单系统中的设计与实现一、模式核心：用状态切换驱动行为变化在电商订单系统中，订单状态会随着用户操作动态变化：「已创建」的订单支付后变为「已支付」，发货后变为「已发货」&#xff0…...

编程日记 2025/8/16 23:43:17

nohup命令使用说明

文章目录如何在后台运行程序呢？如何正常运行代码重定向呢？nohup: ignoring input 如何在后台运行程序呢？ 使用nohup命令即可， nohup python dataset/ReferESpatialDataset.py >>dataset_20250417.log 2>&1 &n…...

编程日记 2025/8/17 18:28:07

使用原生button封装一个通用按钮组件

效果图代码 <script lang"ts" setup> import { computed, ref, watch } from "vue";/*** 按钮属性接口*/ interface ButtonProps {/** 按钮类型：default(默认)/dark/plain/link */type?: "default" | "dark" | &q…...

编程日记 2025/8/21 4:48:35

osu ai 论文笔记 DQN

e https://theses.liacs.nl/pdf/2019-2020-SteeJvander.pdf Creating an AI for the Rhytm Game osu! 20年的论文用监督学习训练移动模型100首歌能达到95准确率点击模型用DQN两千首歌65准确率 V抖用的居然不是强化学习？ 5,6星打96准确度还是有的东西的这是5.…...

编程日记 2025/8/20 8:11:54

perf的架构 1.perf event event are pure kernel counters, in this case they are called software events. Examples include: context-switches, minor-faults.events is the processor itself and its Performance Monitoring Unit (PMU). It provides a list of events …...

编程日记 2025/8/17 19:58:35

简介