告别手动引入的噩梦：Composer如何助你高效集成MangopayPHPSDK

<code class="json">{
    "require": {
        "mangopay/php-sdk-v2": "^2.1" // 或者你需要的版本范围
    }
}</code>

<code class="bash">composer require mangopay/php-sdk-v2</code>

<code class="php">require_once __DIR__ . '/vendor/autoload.php';</code>

<code class="php"><?php

require_once __DIR__ . '/vendor/autoload.php'; // 引入Composer自动加载器

use MangoPay\MangoPayApi;
use MangoPay\Libraries\ResponseException;
use MangoPay\Libraries\Exception;
use MangoPay\Pagination;

$api = new MangoPayApi();

// 配置你的Mangopay凭据和临时文件夹
$api->Config->ClientId = 'your-client-id';
$api->Config->ClientPassword = 'your-client-password';
$api->Config->TemporaryFolder = '/path/to/your/temp/folder/'; // 请确保PHP有写入权限，且此文件夹在Web根目录之外
// $api->Config->BaseUrl = 'https://api.mangopay.com'; // 切换到生产环境，默认是沙盒环境

try {
    // 示例：获取所有用户
    $pagination = new Pagination(1, 10); // 获取第一页，每页10条
    $users = $api->Users->GetAll($pagination);

    echo "成功获取到 " . count($users) . " 个用户。\n";
    foreach ($users as $user) {
        echo "用户ID: " . $user->Id . ", 姓名: " . $user->FirstName . " " . $user->LastName . "\n";
    }

    // 示例：创建自然人用户
    $mangoUser = new \MangoPay\UserNatural();
    $mangoUser->PersonType = "NATURAL";
    $mangoUser->FirstName = 'John';
    $mangoUser->LastName = 'Doe';
    $mangoUser->Birthday = 1409735187; // Unix时间戳
    $mangoUser->Nationality = "FR";
    $mangoUser->CountryOfResidence = "FR";
    $mangoUser->Email = 'john.doe@example.com';

    $createdUser = $api->Users->Create($mangoUser);
    echo "成功创建用户，ID: " . $createdUser->Id . "\n";

} catch (ResponseException $e) {
    // 处理API响应异常
    echo "API响应错误: " . $e->GetCode() . " - " . $e->GetMessage() . "\n";
    print_r($e->GetErrorDetails());
} catch (Exception $e) {
    // 处理其他SDK内部异常
    echo "SDK内部错误: " . $e->GetMessage() . "\n";
}

// 你还可以集成日志系统 (例如 Monolog)
// use Monolog\Logger;
// use Monolog\Handler\StreamHandler;
// $logger = new Logger('mangopay-logger');
// $logger->pushHandler(new StreamHandler('/path/to/your/log/file.log', Logger::DEBUG));
// $api->setLogger($logger);

// 验证API调用频率限制状态
// $rateLimits = $api->RateLimits;
// if (!empty($rateLimits)) {
//     echo "\n最近15分钟API调用情况: 已调用 " . $rateLimits[0]->CallsMade . " 次, 剩余 " . $rateLimits[0]->CallsRemaining . " 次\n";
// }</code>