README

支持 Fio API。读取通过JSON文件提供。

安装到项目

安装 coro/fio 的最佳方式是使用Composer。

$ composer require coro/fio

如何使用

这里有示例，并通过cli运行。此脚本需要与相同目录中的 account.ini 文件，其外观如下。

[my-account]
account = 123456789
token = abcdefghijklmn

[wife-account]
account = 987654321
token = zyxuvtsrfd

FioFactory 类帮助您创建 FioPay 和 FioRead 类的实例。

use coro\Fio;
$fioFactory = new Fio\Utils\FioFactory([
	'my-alias' => [
		'account' => '123456789',
		'token' => 'abcdefg'
	],
	'next-alias' => [
		'account' => '987654321',
		'token' => 'tuvwxyz'
	]
]);

$fioRead = $fioFactory->createFioRead('my-account');
$fioPay = $fioFactory->createFioPay('wife-account');

读取

读取日期之间的范围。

use coro\Fio;
/* @var $fioRead Fio\FioRead */
/* @var $list Fio\Response\Read\TransactionList */
$list = $fioRead->movements(/* $from, $to */); // default is last week

foreach ($list as $transaction) {
    /* @var $transaction Fio\Response\Read\Transaction */
    var_dump($transaction->moveId);
    foreach ($transaction as $property => $value) {
        var_dump($property, $value);
    }
}

var_dump($list->getInfo());

您可以通过年份的ID下载交易。

use coro\Fio;
/* @var $fioRead Fio\FioRead */
/* @var $list Fio\Response\Read\TransactionList */
$list = $fioRead->movementId(2, 2015); // second transaction of year 2015

一个非常有用的方法，可以下载最后交易。

下载后自动设置新的断点。

use coro\Fio;
/* @var $fioRead Fio\FioRead */
/* @var $list Fio\Response\Read\TransactionList */
$list = $fioRead->lastDownload();
// same use like above
var_dump($list->getInfo()->idLastDownload);

更改您的断点。

按日期。

$fioRead->setLastDate('1986-12-30');
$list = $fioRead->lastDownload();
var_dump($list->getInfo()->idLastDownload);

按移动ID。

$fioRead->setLastId(123456789);
$list = $fioRead->lastDownload();
var_dump($list->getInfo()->idLastDownload); // 123456789

自定义交易类

默认为 coro\Fio\Response\Read\Transaction，如果您想为属性使用其他名称，请将其定义为 FioFactory 的第二个参数。

定义注解，并不要忘记括号中的id。

<?php

use coro\Fio\Response\Read\TransactionAbstract

/**
 * @property-read float $amount [1]
 * @property-read string $to_account [2]
 * @property-read string $bank_code [3]
 */
class MyTransaction extends TransactionAbstract
{
	/** custom method */
	public function setBank_code($value)
	{
		return str_pad($value, 4, '0', STR_PAD_LEFT);
	}
}

$fioFactory = new Utils\FioFactory([/* ... */], 'MyTransaction');

支付（写入）

API有三种响应语言，默认设置为 cs。要更改

/* @var $fioPay coro\Fio\FioPay */
$fioPay->setLanguage('en');

要发送请求，请使用 send 方法，它接受文件路径到您的xml或abo文件或 Property 类的实例。

$myFile = '/path/to/my/xml/or/abo/file'
$fioPay->send($myFile);

仅对捷克或斯洛伐克的对象进行支付

/* @var $national coro\Fio\Request\Pay\Payment\National */
$national = $fioPay->createNational($amount, $accountTo);
$national->setVariableSymbol($vs);
/* set next payment property $national->set* */
$fioPay->send($national);

欧元区支付

/* @var $euro coro\Fio\Request\Pay\Payment\Euro */
$euro = $fioPay->createEuro($amount, $accountTo, $name);
$euro->setVariableSymbol($vs);
/* set next payment property $euro->set* */
$fioPay->send($euro);

国际支付

/* @var $international coro\Fio\Request\Pay\Payment\International */
$international = $fioPay->createInternational($amount, $accountTo, $bic, $name, $street, $city, $country, $info);
$international->setRemittanceInfo2('foo');
/* set next payment property $international->set* */
$fioPay->send($international);

在一个请求中发送更多支付

foreach($pamentsRows as $row) {
	/* @var $national coro\Fio\Request\Pay\Payment\National */
	$national = $fioPay->createNational($row->amount, $row->accountTo);
	$national->setVariableSymbol($row->vs);
	$fioPay->addPayment($national);
}
$fioPay->send();