Yurunsoft/php-tdengine
Fork: 9 Star: 76 (更新于 2024-11-01 08:55:44)
license: AGPL-3.0
Language: PHP .
大数据引擎 TDengine 的 PHP 客户端扩展,支持 Swoole!
最后发布版本: v1.0.6 ( 2023-03-21 09:07:18)
php-tdengine
大数据引擎 TDengine 的 PHP 客户端扩展,还支持了 Swoole 协程化。可以运行在传统 PHP 环境和 Swoole 环境下。
编写了在三大操作系统下的编译及测试用例,保证代码的稳定性和可靠性。
环境要求
Windows、Linux、MacOS
PHP >= 7.4
TDengine >= 2.0(已支持 TDengine 3.0)
Swoole >= 4.8 (可选)
编译安装
编译前请先安装 TDengine-client 或者自行编译 TDengine,详见 TDengine 文档:https://www.taosdata.com/cn/documentation/connector
非 Swoole 环境:
phpize && ./configure && make -j && make install
手动指定 tdengine 目录:
phpize && ./configure --with-tdengine-dir=/usr/local/Cellar/tdengine/2.4.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
PHP 代码编写
所有错误都会抛出异常:
TDengine\Exception\TDengineException
基本:
use TDengine\Connection;
// 获取扩展版本号
var_dump(\TDengine\EXTENSION_VERSION);
// 设置客户端选项
\TDengine\setOptions([
\TDengine\TSDB_OPTION_LOCALE => 'en_US.UTF-8', // 区域
\TDengine\TSDB_OPTION_CHARSET => 'UTF-8', // 字符集
\TDengine\TSDB_OPTION_TIMEZONE => 'Asia/Shanghai', // 时区
\TDengine\TSDB_OPTION_CONFIGDIR => '/etc/taos', // 配置目录
\TDengine\TSDB_OPTION_SHELL_ACTIVITY_TIMER => 3, // shell 活动定时器
]);
// 获取客户端版本信息
var_dump(\TDengine\CLIENT_VERSION);
var_dump(\TDengine\getClientInfo());
// 以下值都是默认值,不改可以不传
$host = '127.0.0.1';
$port = 6030;
$user = 'root';
$pass = 'taosdata';
$db = null;
// 实例化
$connection = new Connection($host, $port, $user, $pass, $db);
// 连接
$connection->connect();
// 获取连接参数
$connection->getHost();
$connection->getPort();
$connection->getUser();
$connection->getPass();
$connection->getDb();
// 获取服务端信息
$connection->getServerInfo();
// 选择默认数据库
$connection->selectDb('db1');
// 关闭连接
$connection->close();
查询:
// 查询
$resource = $connection->query($sql); // 支持查询和插入
// 获取结果集时间戳字段的精度,0 代表毫秒,1 代表微秒,2 代表纳秒
$resource->getResultPrecision();
// 获取所有数据
$resource->fetch();
// 获取一行数据
$resource->fetchRow();
// 获取字段数组
$resource->fetchFields();
// 获取列数
$resource->getFieldCount();
// 获取影响行数
$resource->affectedRows();
// 获取 SQL 语句
$resource->getSql();
// 获取连接对象
$resource->getConnection();
// 关闭资源(一般不需要手动关闭,变量销毁时会自动释放)
$resource->close();
参数绑定:
// 查询
$stmt = $connection->prepare($sql); // 支持查询和插入,参数用?占位
// 设置表名和标签
$stmt->setTableNameTags('表名', [
// 支持格式同参数绑定
[TDengine\TSDB_DATA_TYPE_INT, 36],
]);
// 绑定参数方法1
$stmt->bindParams(
// [字段类型, 值]
[TDengine\TSDB_DATA_TYPE_TIMESTAMP, $time1],
[TDengine\TSDB_DATA_TYPE_INT, 36],
[TDengine\TSDB_DATA_TYPE_FLOAT, 44.0],
);
// 绑定参数方法2
$stmt->bindParams([
// ['type' => 字段类型, 'value' => 值]
['type' => TDengine\TSDB_DATA_TYPE_TIMESTAMP, 'value' => $time2],
['type' => TDengine\TSDB_DATA_TYPE_INT, 'value' => 36],
['type' => TDengine\TSDB_DATA_TYPE_FLOAT, 'value' => 44.0],
]);
// 执行 SQL,返回 Resource,使用方法同 query() 返回值
$resource = $stmt->execute();
// 获取 SQL 语句
$stmt->getSql();
// 获取连接对象
$stmt->getConnection();
// 关闭(一般不需要手动关闭,变量销毁时会自动释放)
$stmt->close();
字段类型:
参数名称 | 说明 |
---|---|
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_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\TSDB_DATA_TYPE_JSON |
json |
TDengine\TSDB_DATA_TYPE_VARBINARY |
varbinary |
TDengine\TSDB_DATA_TYPE_DECIMAL |
decimal |
TDengine\TSDB_DATA_TYPE_BLOB |
blob |
TDengine\TSDB_DATA_TYPE_MEDIUMBLOB |
mediumblob |
TDengine\TSDB_DATA_TYPE_BINARY |
binary |
最近版本更新:(数据更新于 2024-09-07 09:06:19)
2023-03-21 09:07:18 v1.0.6
2022-08-27 14:07:06 v1.0.5
2022-06-09 19:23:38 v1.0.4
2022-06-09 11:00:54 v1.0.3
2022-05-13 16:05:37 v1.0.2
2022-03-31 14:51:44 v1.0.1
2022-01-18 16:37:37 v1.0.0
2022-01-12 17:19:34 v0.0.3
2021-12-31 14:08:49 v0.0.2
2021-12-21 13:56:48 v0.0.1
主题(topics):
php, swoole, tdengine
Yurunsoft/php-tdengine同语言 PHP最近更新仓库
2024-11-01 18:37:36 schmittjoh/JMSSerializerBundle
2024-10-31 21:37:53 filamentphp/filament
2024-10-28 00:16:41 symfony/var-dumper
2024-10-28 00:11:41 symfony/symfony
2024-10-11 23:44:26 coollabsio/coolify
2024-10-11 03:27:29 odan/slim4-skeleton