README

注意：在 bml api 更新后，此包不再维护

PHP 包，用于从 BML 获取交易。（实验性）此包封装了官方的 BML Web API。

安装

composer require baraveli/bml-transaction

使用

登录

此方法将尝试使用 BML API 进行认证。第一个参数是您的 bml 用户名，第二个是 bml 密码。登录时，将有两个可用的属性 authenticationStatus 和 userID。

use Baraveli\BMLTransaction\BML;

$bml = new BML;

$bml->login("username", "password");

获取今天的交易 : 数组

use Baraveli\BMLTransaction\BML;

$bml = new BML;

$bml->login("username", "password")
    ->GetTodayTransactions();

获取待处理的交易 : 数组

use Baraveli\BMLTransaction\BML;

$bml = new BML;

$bml->login("username", "password")
    ->GetPendingTransactions();

获取日期范围内的交易。

传递给函数参数的日期通过 php strtotime() 函数进行处理。它可以解析几乎任何英文文本日期时间的描述为 Unix 时间戳。您可以根据需要以任何格式传递参数。交易通过 BML API 进行分页。如果您希望获取请求的下一页，可以向函数传递第三个参数，该参数对应于页码。

use Baraveli\BMLTransaction\BML;

$bml = new BML;

$bml->login("username", "password")
    ->GetTransactionsBetween("December 15 2019", "August 1 2020");

这将返回 2019 年 12 月 15 日至 2020 年 8 月 1 日的所有交易。您只能获取 12 个月内的交易。

多账户支持

获取与 bml 用户关联的所有账户。

use Baraveli\BMLTransaction\BML;

$bml = new BML;

$bml->login("username", "password")
    ->GetAccounts();

从指定账户获取今天的交易

use Baraveli\BMLTransaction\BML;

$bml = new BML;

// Get todays transaction from first account
$bml->login("username", "password", 0)
    ->GetTodayTransactions();
    
// Get todays transaction from second account
$bml->login("username", "password", 1)
    ->GetTodayTransactions();    

运行测试

在克隆仓库的根目录中创建 .env.testing。填写凭证

BML_USERNAME=
BML_PASSWORD=

要运行测试，请执行

vendor/bin/phpunit