yurunsoft / influxdb-orm
一个用于 InfluxDB 时序数据库的 ORM
Installs: 5 866
Dependents: 1
Suggesters: 0
Security: 0
Stars: 21
Watchers: 4
Forks: 4
Open Issues: 0
Requires
- php: >=7.1
- doctrine/annotations: ^1.8.0
- influxdb/influxdb-php: ^1.15
- yurunsoft/yurun-http: ^4.0.0|^5.0.0
Requires (Dev)
- friendsofphp/php-cs-fixer: 2.18.3
- phpstan/phpstan: 0.12.82
- phpunit/phpunit: >=7
- swoole/ide-helper: ^4.7
- symfony/polyfill-php81: ^1.23
README
介绍
一个用于 InfluxDB 时序数据库的 ORM,终结没有 InfluxDB ORM 的时代。
常用操作一把梭,支持 php-fpm、Swoole 环境,一键轻松切换。
可以用于所有传统框架、所有 Swoole 框架中!
Composer
本项目可以使用composer安装,遵循psr-4自动加载规则,在你的 composer.json
中加入下面的内容:
{ "require": { "yurunsoft/influxdb-orm": "~1.2.0" } }
然后执行 composer update
安装。
使用
Swoole 支持
无需做任何事情即可完美兼容 Swoole 环境!
定义模型
具体可参考
example/test.php
<?php namespace Yurun\InfluxDB\ORM\Example\Model; use Yurun\InfluxDB\ORM\BaseModel; use Yurun\InfluxDB\ORM\Annotation\Tag; use Yurun\InfluxDB\ORM\Annotation\Field; use Yurun\InfluxDB\ORM\Annotation\Value; use Yurun\InfluxDB\ORM\Annotation\Timestamp; use Yurun\InfluxDB\ORM\Annotation\Measurement; /** * @Measurement(name="aaa") */ class A extends BaseModel { /** * @Tag(name="id", type="int") * * @var int */ private $id; /** * @Field(name="name", type="string") * * @var string */ private $name; /** * @Timestamp(precision="s") * * @var int|string */ private $time; /** * @Value * * @var int */ private $value; public static function create($id, $name, $time, $value) { return new static(compact('id', 'name', 'time', 'value')); } /** * Get the value of time * * @return int|string */ public function getTime() { return $this->time; } /** * Set the value of time * * @param int|string $time * * @return self */ public function setTime($time) { $this->time = $time; return $this; } /** * Get the value of id * * @return int */ public function getId() { return $this->id; } /** * Set the value of id * * @param int $id * * @return self */ public function setId(int $id) { $this->id = $id; return $this; } /** * Get the value of name * * @return string */ public function getName() { return $this->name; } /** * Set the value of name * * @param string $name * * @return self */ public function setName(string $name) { $this->name = $name; return $this; } /** * Get the value of value * * @return int */ public function getValue() { return $this->value; } /** * Set the value of value * * @param int $value * * @return self */ public function setValue(int $value) { $this->value = $value; return $this; } }
数据写入
use Yurun\InfluxDB\ORM\InfluxDBManager; // 设置客户端名称为test,默认数据库为db_test InfluxDBManager::setClientConfig('test', '127.0.0.1', 8086, '', '', false, false, 0, 0, 'db_test', '/'); // 设置默认数据库为test InfluxDBManager::setDefaultClientName('test'); // 写入数据,支持对象和数组 $r = A::write([ A::create(mt_rand(1, 999999), time(), time(), mt_rand(1, 100)), ['id'=>1, 'name'=>'aaa', 'time'=>time(), 'value'=>mt_rand(1, 100)], ]); var_dump($r);
数据查询
// 获取查询器 $query = A::query(); // 常见用法,反正就那一套,不多说了 $query->field('id,name') ->from('table') ->where([ 'id' => 1 ])->where('id', '=', 1) ->orWhere('id', '=', 1) ->order('time', 'desc') ->group('id') ->limit(0, 10); // 查询结果,与 InfluxDB 官方客户端一样用法 $resultSet = $query->select(); // 查询结果转模型,适合用于查询记录而不是统计数据 $model = $resultSet->getModel(A::class); // 查询结果转模型列表,适合用于查询记录而不是统计数据 $list = $resultSet->getModelList(A::class);
模型快捷查询
适合用于查询记录而不是统计数据
use Yurun\InfluxDB\ORM\Query\QueryBuilder; // 查询结果转模型,适合用于查询记录而不是统计数据 $model = A::find(function(QueryBuilder $query){ $query->where('id', '=', 1)->limit(1); }); // 查询结果转模型列表,适合用于查询记录而不是统计数据 $list = A::select(function(QueryBuilder $query){ $query->where('id', '=', 1)->limit(2); });
获取单个字段值
$count = A::query()->field('count(value)')->select()->getScalar();
免费技术支持
运行环境
版权信息
influxdb-orm
遵循 MIT 开源协议发布,并提供免费使用。
捐赠
开源不求盈利,多少都是心意,生活不易,随缘随缘……