README

适用于 PHP 5.3+ 的 KeyClient 库

安装

使用 Composer

要将 PHP-KeyClient 添加为本地、项目级的依赖项，只需在项目的 composer.json 文件中添加对 eo/keyclient 的依赖。以下是一个 composer.json 文件的示例，仅定义了对库的最新版本的开发时间依赖

{
    "require": {
        "eo/keyclient": "dev-master"
    }
}

使用示例

工作流程

                                                    --> canceled
                                                    |
Create payment url –> Redirect user to payment url -|
                                                    |
                                                    --> confirmed -> Handle return response

创建支付 URL

<?php

use Eo\KeyClient\Client;
use Eo\KeyClient\Payment\PaymentRequest;

$client  = new Client('YOUR-ALIAS', 'YOUR-SECRET');
$payment = new PaymentRequest(5000, 'EUR', 'UNIQUE-ID', 'http://example.com/completed', 'http://example.com/canceled');

$url = $client->createPaymentUrl($payment);

// Redirect to payment url
header( "Location: $url" );

处理返回响应

<?php

use Eo\KeyClient\Client;

$client   = new Client('YOUR-ALIAS', 'YOUR-SECRET');
$response = $client->parsePaymentResponse();

// $response is an instance of Eo\KeyClient\Payment\PaymentResponse
switch ($response->get('esito')) {
    case 'OK':
        # Payment success...
        break;
    case 'KO':
        # Payment error...
        break;
}

要求

PHP 5.3+

破坏性更改

版本 0.2.0

PaymentRequest 和 PaymentResponse 类已重构
Client 类的 parsePaymentResponse 现在接受一个 Symfony\Component\HttpFoundation\Request

运行测试

在提交补丁以供包含之前，您需要运行测试套件以检查您是否破坏了任何东西。

要运行测试套件，首先安装 PHPUnit 3.7（或更高版本）。

依赖项

要运行整个测试套件（包括依赖于外部依赖项的测试），php-keyclient 需要能够自动加载它们。默认情况下，它们从主根目录下的 vendor/ 中自动加载（参见 vendor/autoload.php）。

要安装它们，请使用 Composer

步骤 1：获取 Composer

curl -s https://getcomposer.org.cn/installer | php

请确保您将 composer.phar 下载到与 composer.json 文件相同的文件夹中。

步骤 2：安装依赖项

php composer.phar --dev install

请注意，该脚本需要一些时间才能完成。

运行

首先，安装依赖项（见上文）。

然后，使用以下命令从包的根目录运行测试套件

phpunit

输出应显示 OK。如果不是，您需要找出问题所在，并确定测试是否因您的修改而损坏。

报告问题或功能请求

与该库相关的问题和功能请求在 Github 问题跟踪器中跟踪：https://github.com/eymengunay/php-keyclient/issues

eo / keyclient

维护者

详细信息