Hic Sunt Dracones

Author: edbizarro

.editorconfig

@@ -0,0 +1,20 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+indent_style = space
+
+[**.php]
+indent_size = 4
+
+[**.json]
+indent_size = 4
+
+[**.yml]
+indent_size = 2

.gitignore

@@ -0,0 +1,4 @@
+/vendor/
+.bundle
+composer.lock
+/build/

.php_cs

@@ -0,0 +1,36 @@
+<?php
+/**
+ * Config for PHP-CS-Fixer ver2
+ */
+$rules = [
+    '@PSR2' => true,
+    // addtional rules
+    'array_syntax' => ['syntax' => 'short'],
+    'no_multiline_whitespace_before_semicolons' => true,
+    'no_short_echo_tag' => true,
+    'no_unused_imports' => true,
+    'not_operator_with_successor_space' => true,
+];
+$excludes = [
+    // add exclude project directory
+    'vendor',
+    'node_modules',
+    'storage',
+    'public',
+    'docker',
+    'bootstrap',
+    'resources'
+];
+return PhpCsFixer\Config::create()
+    ->setRules($rules)
+    ->setFinder(
+        PhpCsFixer\Finder::create()
+            ->exclude($excludes)
+            ->notName('README.md')
+            ->notName('_ide_helper.php')
+            ->notName('_ide_helper_models.php')
+            ->notName('.phpstorm.meta.php')
+            ->notName('server.php')
+            ->notName('*.xml')
+            ->notName('*.yml')
+    );

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 TrayLabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,94 @@
+# Laravel Influxdb
+
+A service made to provide, set up and use [influxdb-php](https://github.com/influxdata/influxdb-php/) in Laravel 5.6
+
+## Installation
+
+Follow this steps to use this package on your Laravel installation
+
+### 1. Require it on composer
+
+```bash
+composer require power-data-hub/laraflux
+```
+
+The package will automatically register it's service provider.
+
+For Laravel <= 5.4 add the provider manually
+
+### 2. Load service provider (optional Laravel <= 5.4 only)
+
+You need to update your `config/app.php` configuration file to register our service provider, adding this line on `providers` array:
+
+```php
+PowerDataHub\Laraflux\ServiceProvider::class
+```
+
+```
+'aliases' => [
+//  ...
+    'InfluxDB' => PowerDataHub\Laraflux\Facades\InfluxDB::class,
+]
+```
+
+* Define `.env` variables to connect to InfluxDB
+
+```ini
+INFLUXDB_HOST=localhost
+INFLUXDB_PORT=8086
+INFLUXDB_USER=some_user
+INFLUXDB_PASSWORD=some_password
+INFLUXDB_SSL=false
+INFLUXDB_VERIFYSSL=false
+INFLUXDB_TIMEOUT=0
+INFLUXDB_DBNAME=some_database
+```
+
+* Write this into your terminal inside your project
+
+```ini
+php artisan vendor:publish
+```
+
+## Reading Data
+
+```php
+<?php
+
+// executing a query will yield a resultset object
+$result = InfluxDB::query('select * from test_metric LIMIT 5');
+
+// get the points from the resultset yields an array
+$points = $result->getPoints();
+```
+
+## Writing Data
+
+```php
+<?php
+
+// create an array of points
+$points = array(
+    new InfluxDB\Point(
+        'test_metric', // name of the measurement
+        null, // the measurement value
+        ['host' => 'server01', 'region' => 'us-west'], // optional tags
+        ['cpucount' => 10], // optional additional fields
+        time() // Time precision has to be set to seconds!
+    ),
+    new InfluxDB\Point(
+        'test_metric', // name of the measurement
+        null, // the measurement value
+        ['host' => 'server01', 'region' => 'us-west'], // optional tags
+        ['cpucount' => 10], // optional additional fields
+        time() // Time precision has to be set to seconds!
+    )
+);
+
+$result = InfluxDB::writePoints($points, \InfluxDB\Database::PRECISION_SECONDS);
+```
+
+License
+----
+
+This project is licensed under the MIT License

composer.json

@@ -0,0 +1,34 @@
+{
+	"name": "power-data-hub/laraflux",
+    "description": "A service made to provide, set up and use influxphp in Laravel.",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Power Data Hub",
+            "email": "[email protected]"
+        }
+    ],
+    "autoload": {
+        "psr-4": {
+            "PowerDataHub\\Laraflux\\": "src/"
+        }
+    },
+    "require": {
+        "php": "^7.1.3",
+        "influxdb/influxdb-php": "^1.14"
+    },
+    "require-dev": {
+        "orchestra/testbench": "^3.6",
+        "phpunit/phpunit": "^7.0",
+        "friendsofphp/php-cs-fixer": "^2.11"
+    },
+    "minimum-stability": "dev",
+    "extra": {
+    "laravel": {
+        "providers": [
+          "PowerDataHub\\Laraflux\\ServiceProvider"
+        ]
+      }
+    }
+}

config/laraflux.php

@@ -0,0 +1,12 @@
+<?php
+
+return [
+    'host' => env('INFLUXDB_HOST', 'localhost'),
+    'port' => env('INFLUXDB_PORT', 8086),
+    'username' => env('INFLUXDB_USER', ''),
+    'password' => env('INFLUXDB_PASSWORD', ''),
+    'ssl' => env('INFLUXDB_SSL', false),
+    'verifySSL' => env('INFLUXDB_VERIFYSSL', false),
+    'timeout' => env('INFLUXDB_TIMEOUT', 0),
+    'dbname' => env('INFLUXDB_DBNAME', ''),
+];

src/Facades/InfluxDB.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace PowerDataHub\Laraflux\Facades;
+
+use Illuminate\Support\Facades\Facade as LaravelFacade;
+use InfluxDB\Database;
+
+class InfluxDB extends LaravelFacade
+{
+    /**
+     * Get the registered name of the component.
+     *
+     * @return string
+     */
+    protected static function getFacadeAccessor()
+    {
+        return Database::class;
+    }
+}

src/Providers/ServiceProvider.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace PowerDataHub\Laraflux\Providers;
+
+use Illuminate\Support\ServiceProvider as LaravelServiceProvider;
+use InfluxDB\Client as InfluxClient;
+use InfluxDB\Database as InfluxDB;
+
+class ServiceProvider extends LaravelServiceProvider
+{
+    /**
+     * Indicates if loading of the provider is deferred.
+     *
+     * @var bool
+     */
+    protected $defer = true;
+
+    /**
+     * Bootstrap any application services.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        $this->publishes([
+            __DIR__ . '/../../config/laraflux.php' => config_path('laraflux.php')
+        ]);
+    }
+
+    /**
+     * Register the service provider.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->app->singleton(InfluxDB::class, function($app) {
+            $client = new InfluxClient(
+                config('influxdb.host'),
+                config('influxdb.port'),
+                config('influxdb.username'),
+                config('influxdb.password'),
+                config('influxdb.ssl'),
+                config('influxdb.verifySSL'),
+                config('influxdb.timeout')
+            );
+            return $client->selectDB(config('influxdb.dbname'));
+        });
+    }
+
+    /**
+     * Get the services provided by the provider.
+     *
+     * @return array
+     */
+    public function provides()
+    {
+        return [
+            InfluxDB::class,
+        ];
+    }
+}