padrio / laravel-influxdb
InfluxDB 的 Laravel 实现。
Requires
- php: ^7.0
- illuminate/support: 5.5 - 5.8
- influxdb/influxdb-php: ^1.14
This package is auto-updated.
Last update: 2021-05-18 00:27:55 UTC
README
laravel-influxdb - 将 InfluxDB 带到您的 Laravel 应用程序
许可证:MIT
作者:Pascal Krason p.krason@padr.io
语言:PHP 7.1 Laravel:Min. 5.5 - 5.8
支持 自动发现:是
简介
请注意,此包尚未完成,但可以视为生产就绪。我将在近期内实现一些功能,例如实现一个队列以提升写入性能或支持多个连接。如果您有建议,请打开一个 问题)。
此包仅提供了一种非常基础的实现,通过使所有操作尽可能简单,就像编写配置一样。
要求
在 PHP 方面没有太多要求,您只需要至少 PHP 5.6 或 7.1 以及安装了 curl 扩展。然后您可以通过 Composer 安装所有内容,Composer 将负责其他一切。
安装
步骤 1 - 作为依赖项要求
在您的项目目录内执行 composer 以要求最新版本
composer require padrio/laravel-influxdb
步骤 2 - 启用包(可选)
随着 Laravel 5.5 的发布,"自动发现"功能已经被引入。这将自动为您注册 ServiceProvider 和 Facade。如果这不起作用或者您已经禁用了此功能,请按照以下步骤操作。
在 config/app.php
内您需要注册 ServiceProvider
// config/app.php 'providers' => [ // (...) Padrio\InfluxDB\Providers\ServiceProvider::class, ];
在同一文件中有一个用于注册 facade 别名的部分
// config/app.php 'aliases' => [ // 'InfluxDb' => Padrio\InfluxDB\Facade::class, ];
步骤 3 - 配置
首先您需要使用 artisan 发布我们的预定义配置文件
php artisan vendor:publish --provider="Padrio\InfluxDB\Providers\ServiceProvider"
这将创建 config/influxdb.php
文件,可以修改以满足您的需求。
您也可以设置以下环境变量,或者为了开发目的,可以将它们直接插入到您的 .env 文件中
INFLUXDB_PROTOCOL=http
INFLUXDB_USER=null
INFLUXDB_PASS=null
INFLUXDB_HOST=localhost
INFLUXDB_PORT=8086
INFLUXDB_DATABASE=default
INFLUXDB_QUEUE_ENABLE=false
INFLUXDB_QUEUE_DRIVER=default
INFLUXDB_TIMEOUT=5
INFLUXDB_VERIFY_SSL=true
示例
基本示例
由于这只是官方 php 库的一个简单包装,我这边没有太多要记录的。您可以通过调用辅助函数 InfluxDB()
来获取 InfluxDB\Database
实例。
// Get the Client using a facade $client = InfluxDB::getClient() // ... using the helper $client = InfluxDB(); // Check if the database is existing var_dump(InfluxDB()->exists()); // returns a bool // Create the configured database var_dump(InfluxDB()->craete()); // returns null)
有关进一步说明,请查看官方文档。
多连接 & 队列
这些是即将介绍的功能,请保持关注。