plexophp/php-sdk

Plexo SDK para PHP

维护者

详细信息

github.com/plexouy/PHPClient

源代码

问题

安装次数: 7,451

依赖者: 0

建议者: 0

安全: 0

星标: 4

关注者: 2

分支: 3

开放问题: 4

2.0.6.2 2024-09-11 14:36 UTC

Requires

Requires (Dev)

AGPL-3.0-only 7c5b212ef53d329d5071e16856e72481ea8d3865

This package is auto-updated.

Last update: 2024-09-12 13:22:15 UTC

README

Build Status

Plexo 是一个支付媒体库。它的目标是简化支付工具的使用，通过解耦与支付媒体的集成复杂性。

要求

要运行 SDK，您的系统必须安装 PHP >= 7.4 并编译了 openssl 模块。

第一步

安装

通过 Composer 安装 SDK。

$ composer require plexophp/php-sdk

证书

客户端可以开发并注册自己的证书存储类。这个类必须实现 Plexo\Sdk\Certificate\CertificateStoreInterface 接口。

这样就可以避免对 API 的额外调用，同时给客户端提供选择最方便的存储方式和位置的自由（数据库、文件系统、API 等）。

查看示例

类 Plexo\Sdk\Certificate\Certificate

表示一个证书，包含其指纹、公钥和/或私钥。

  • fingerprint (字符串) 十六进制 SHA1。
  • cert (字符串) Base 64 编码的公钥，包含 "-----BEGIN CERTIFICATE-----" 和 "-----END CERTIFICATE-----" 声明。
  • pkey (字符串) Base 64 编码的私钥，包含 "-----BEGIN PRIVATE KEY-----" 和 "END PRIVATE KEY" 声明。

凭证

通过用户名和签名验证进行认证。所有请求都使用 Plexo 签发的私钥进行签名。

用户名

用户名可以通过设置环境变量 PLEXO_CREDENTIALS_CLIENT 或在实例化 Plexo\Sdk\Client 类时通过选项 client 指定。

私钥

私钥的配置可以通过以下三种方式实现，无论是作为环境变量还是在实例化 Plexo\Sdk\Client 类时在代码中实现

选项 1. 指纹：如果您已注册证书存储类，SDK 将查询 getByFingerprint 方法，传入指纹作为参数，以获取存储的私钥。您的类必须返回一个包含从 pfx 文件提取的私钥的 Plexo\Sdk\Certificate\Certificate 类型的对象。

  • 环境变量
    • PLEXO_CREDENTIALS_PRIVKEY_FINGERPRINT
  • 构造函数选项
    • privkey_fingerprint

选项 2. PEM/指纹：如果私钥已从 pfx 文件提取到 pem 文件，请添加文件路径，SDK 将使用包含的密钥。

  • 环境变量
    • PLEXO_CREDENTIALS_PEM_FILENAME
    • PLEXO_CREDENTIALS_PRIVKEY_FINGERPRINT
  • 构造函数选项
    • pem_filename
    • privkey_fingerprint

选项 3. PFX/Passphrase（较慢）：如果您尚未从 pfx 文件提取数据，可以指定文件路径和安装密码。

  • 环境变量
    • PLEXO_CREDENTIALS_PFX_FILENAME
    • PLEXO_CREDENTIALS_PFX_PASSPHRASE
  • 构造函数选项
    • pfx_filename
    • pfx_passphrase
示例：使用环境变量。
<?php
// Require the Composer autoloader.
require_once 'vendor/autoload.php';

use Plexo\Sdk;

$client = new Sdk\Client();
示例：在实例化 Client 时指定凭证。
<?php
// Require the Composer autoloader.
require_once 'vendor/autoload.php';

use Plexo\Sdk;

$client = new Sdk\Client([
    'client' => $client_name,
    'pem_filename' => $pem_filename,
    'privkey_fingerprint' => $fingerprint,
]);

类 Plexo\Sdk\Client

方法