README

Trolley PHP SDK 提供了对 Trolley API 的集成访问。

要求

需要 PHP 版本 >= 5.4.0。

需要以下 PHP 扩展

curl json mbstring openssl

安装与使用

SDK

git clone https://github.com/PaymentRails/php-sdk.git

Composer

安装 PHP Composer

要使用 Composer 安装绑定，请在 composer.json 中添加以下内容

composer require trolley/core

然后运行 composer install

入门

请按照 安装过程 进行操作，然后运行以下命令

<?php

// This line is for the Composer autoloader
require_once 'vendor/autoload.php';

// Or use this if installed via git clone
// require_once 'php-sdk/lib/autoload.php';

use Trolley;

Trolley\Configuration::publicKey(YOUR_ACCESS_KEY);
Trolley\Configuration::privateKey(YOUR_SECRET_KEY);

try {
    $recipients = Trolley\Recipient::all();

    foreach ($recipients as $rcpt) {
      print_r($rcpt->id . "\n");
    }
} catch (Exception $e) {
    echo 'Exception when calling Trolley\\Recipient::all ', $e->getMessage(), PHP_EOL;
}

API 端点文档

所有 URI 都可在 https://docs.trolley.com/ 找到

从源运行 SDK

1. 克隆此仓库。
2. 从项目根目录运行 composer install 安装依赖。
3. 使用 Trolley 命名空间，根据您放置 SDK 源代码的路径从您的代码中访问 SDK 源代码。

环境变量

在本地运行时，您可以使用 .env 文件提供自定义服务器 URL。

测试仍然使用 .env 文件来加载 API 密钥。
如果您正在运行测试，请确保在项目根目录中存在 .env 文件。

为了您的方便，提供了一个示例 .env.example 文件，可以复制以创建 .env 文件

$ cp .env.example .env

复制后，编辑 .env 文件以提供所需的值。

从 SDK 运行测试

要在终端中运行测试，您需要设置 .env 文件以提供 API 密钥，然后从 tests 目录中使用 PHPUnit 测试套件，如下所示

$ cp .env.example .env
 // Edit the .env file to supply API Keys

$ cd tests
$ ../vendor/bin/phpunit integration/RecipientTest.php

如果您想提供自定义服务器 URL，请在 .env 文件中提供服务器 URL，并将 SDK 配置为使用 development 服务器

Configuration::environment('development');

有关此内容的详细信息，请参阅测试设置文件中的内联文档： /tests/Setup.php:38