worldline-global-collect/connect-sdk-php

用于与 Worldline Global Collect 平台服务器端 API 通信的 PHP SDK

7.1.0 2024-06-04 07:29 UTC

This package is auto-updated.

Last update: 2024-09-04 07:59:51 UTC


README

简介

Worldline Connect PHP SDK 帮助您与 Worldline Connect 服务器 API 通信。其主要功能包括

  • API 调用和响应的便捷 PHP 封装
    • 将 PHP 请求对象转换为 HTTP 请求
    • 将 HTTP 响应转换为 PHP 响应对象或 PHP 异常
  • 处理与认证相关的所有细节
  • 处理所需的元数据

大部分调用都有示例演示其用法。示例使用提供的 API 密钥执行调用。

有关如何使用 SDK 的更多信息,请参阅 Worldline Connect 开发者中心

此存储库的结构

此存储库由以下组件组成

  1. SDK 本身的源代码:/src/lib
  2. 单元和集成测试的源代码(包括示例):/tests

要求

需要 PHP 5.4 或更高版本。此外,为了支持流式上传,还需要包 robtimus/multipart

通过 Composer 安装

  1. 如果尚未完成,请在项目中初始化 Composer,执行以下命令

    composer init
    
  2. 通过执行以下命令将 SDK 的要求添加到您的 composer.json 文件中

    composer require worldline-global-collect/connect-sdk-php
    
  3. 如果尚未完成,请将 vendor/autoload.php 添加到您的项目中,方法是在代码中添加以下行

    require __DIR__ . '/vendor/autoload.php';
    

手动安装

  1. 从 GitHub 下载 PHP SDK 的最新版本。从 发布页面 选择 connect-sdk-php-x.y.z.tar.gz 文件,其中 x.y.z 是版本号。
  2. tar.gz 文件的内容添加到您的项目中。如果需要,可以将 /src/lib 文件夹的内容合并。
  3. /src/lib 文件夹中的所有类添加到您的自动加载器中;这些文件夹中的所有类都符合 PSR-4

开发和测试

  1. 安装 Composer
  2. 从 sdk-php 项目的根目录运行 composer install
  3. tests/config.json.dist 复制到 tests/config.json 并用实际值替换模板值
  4. 从 sdk-php 项目的根目录,运行 vendor/phpunit/phpunit/phpunit(或当它在您的本地计算机上已安装时直接运行 phpunit