ebaschiera/pvoutput

PVOutput.org API 实现

v1.2.0 2015-10-04 09:33 UTC

This package is not auto-updated.

Last update: 2024-09-28 16:03:51 UTC


README

实现 PVOutput.org API。更多信息请参阅 http://www.pvoutput.org/help.html#api-spec

当前已实现的函数

这是一个简单的 PHP 类,可以在大型项目中使用以委派与 PVOutput 的通信。它不是一个监控应用程序。

请注意,此类的函数并未处理所有 API 参数。参数覆盖包括

  • 添加输出
  • d
  • g
  • e
  • pp
  • pt
  • c
  • 获取输出
  • df
  • dt
  • a
  • limit
  • tid
  • sid1
  • 添加状态
  • d
  • t
  • v2
  • v4

缺少的参数将在将来实现。

安装

Composer

从命令行

composer require ebaschiera/pvoutput:1.1.*

在你的 composer.json

{
    "require": {
        "ebaschiera/pvoutput": "1.1.*"
    }
}

手动

只需下载发布包,将 src/PVOutput.php 放入你的项目目录中即可。

基本用法

请注意,此类并未处理所有 API 方法参数。

//during the day
$pvoutput = new \PVOutput\PVOutput($system_id, $api_key);
$pvoutput->addStatus(2500, 1500); //sends instant generation and consumption


//at the end of the day
$pvoutput = new \PVOutput\PVOutput($system_id, $api_key);
$pvoutput->addOutput(NULL, 9000, 3100, $peak_output_datetime, 8000, 1000);
//sends generated energy, peak generation power, peak generation datetime, consumed energy, exported energy


//get a full month aggregated output
$start_date = \DateTime::createFromFormat('Ymd', '20150401');
$end_date = \DateTime::createFromFormat('Ymd', '20150430');
$pvoutput = new \PVOutput\PVOutput($system_id, $api_key);
$pvoutput->getOutput($start_date, $end_date, 'm');

许可证

本软件按 GPL-2 提供,有关更多信息,请参阅 LICENSE 文件。