Target365 SDK 对 PHP 7.0 的支持

dev-master 2022-10-20 12:11 UTC

This package is auto-updated.

Last update: 2024-09-20 16:38:53 UTC


README

Strex AS 是一家挪威支付和短信网关(Strex Connect)提供商。Strex 持有电子货币许可证,并每年处理超过 7000 万笔交易。Strex 在挪威拥有超过 420 万客户,并由挪威移动网络运营商(Telenor、Telia 和 Ice)拥有。Strex Connect 基于Target365 营销和通信平台。

PHP Target365 SDK

License

入门指南

要开始,请点击此处:https://strex.no/strex-connect#Prispakker 并注册您的组织。对于 SDK,请发送包含您的 RSA 公钥(PEM 格式)的电子邮件至 sdk@strex.no。您可以使用 openssl 如下生成您的 RSA 公钥/私钥对:

openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:1024 -out private.pem

使用 openssl 将其转换为 pk8 格式,这是 PHP 所使用的。

openssl pkcs8 -topk8 -inform pem -in private.pem -outform pem -nocrypt -out private.key

文件 private.key 应该看起来像这样

-----BEGIN PRIVATE KEY-----
MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBAML6duyE7hL2XPEH
qiYtyghoj6pO21zGPwSaBKTCg6i3AeJ4Ob6pCnvYQA+rRfw/+aBfT+Rv3LTSmX2i
9bAsLQB0Q3y8zku2NmqE/yoqhb9GAhL3toMasBuJ3ifvUOXTajtGEKy++YkAkRBK
7Wi/bK/IQNZd9nsOtKxz5DXNELbHAgMBAAECgYAj6k8Nsk7IX2kvXOIStkyIz/nm
vS/bHwlsp5JDZzEpWsyWEt9QJ4Mu3N6wBDSYCpDI4cWtpo1ZIZH0epgXI4wGPv2j
a6ilWZywUdhFZw1AUc3qLRoapqIPliimLhxPWmV2OfvbA4LiNvWGsF/qTaqVQ/0V
ebj+JYjJdFQcTjqlwQJBAOpKQ/EyuzDlO7YVPmw0rAfVRfVqTIvzpZ3hGThztcnQ
igI3ftbGSOPUcter3/cX5ENrIGMP6hLsWqSKWECBwK0CQQDVC6mVkrit/VXby2Zp
8epgprGhrUHojNO7ojQQN1Mupr4AHUWr2Y3xJH1uXaOjafBc6uLK7Cri3eLru+iy
Ph/DAkBLG/fgEVV1fWfBHdpfMhucf0DoRmW30CpeDNXbBS1YP6SexU/CZtrjPy55
+b3ZJy2kd2lwmJ9/5YnBiiB0vaQZAkEAuTgPcrOBjfqu94zpd/hTTT3/NtGbeGNe
/UTywJpo3iknDJBmbxaQOfMAfcA5MSw8RXwMOmGCk4RW8Z2Hm9c44wJBAJvIcnMV
6b2G6pizPPjoPhV+eNruWTyFt5ralEmxDpqV3p4TP89KVvaBlkzlT28p1P9vp5bD
J6BLhdOAUfC3CMY=
-----END PRIVATE KEY-----

请注意,当在 PHP 中使用私钥时,您必须删除所有换行符,以便整个私钥在一行中。

使用以下 openssl 命令提取公钥

openssl rsa -in private.key -pubout -out public.key

然后您可以将 public.key 文件发送给我们。文件应该看起来像这样

-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDC+nbshO4S9lzxB6omLcoIaI+q
Tttcxj8EmgSkwoOotwHieDm+qQp72EAPq0X8P/mgX0/kb9y00pl9ovWwLC0AdEN8
vM5LtjZqhP8qKoW/RgIS97aDGrAbid4n71Dl02o7RhCsvvmJAJEQSu1ov2yvyEDW
XfZ7DrSsc+Q1zRC2xwIDAQAB
-----END PUBLIC KEY-----

有关使用 SDK 的更多详细信息,我们强烈建议您查看我们的 PHP 用户指南

Composer

composer require target365/sdk

Latest Stable Version

测试环境

我们的测试环境充当沙盒,尽可能真实地模拟真实 API。这可以在进入生产环境之前熟悉服务。请注意,模拟并不完美,不应被视为 100% 准确。

URL: https://test.target365.io/

生产环境

我们的生产环境是按租户隔离环境与共享公共环境的混合体。如果您对隔离的按租户环境感兴趣,请联系 sdk@strex.no

URL: https://shared.target365.io/

作者和维护者

Target365 (sdk@strex.no)

问题 / 缺陷 / 询问

如果您有任何问题或问题,请随时对此存储库提出问题。

私钥

Target365 PHP SDK 只允许 RSA 私钥。私钥应传递给 \Target365\ApiSdk\ApiClient 构造函数。密钥可以包含 -----BEGIN RSA PRIVATE KEY----- 部分。您必须在使用 PHP SDK 时从私钥中删除所有换行符。

贡献

欢迎新贡献者加入此项目。如果您有兴趣贡献,请发送电子邮件至 sdk@strex.no

自动化测试

自动化测试使用 PHPUnit 框架。以下是一些运行自动化测试的建议步骤。

  • 克隆存储库。
  • 切换到存储库目录。
  • (可选) 使用 vagrant 文件作为 tests/Vagrantfile
  • 运行 composer install
    • 运行 composer 会提示您输入一些必需的详细信息,这些信息将被存储在名为 tests/secrets.yml 的文件中。
    • 当输入 private_key 时,将密钥作为一行字符串输入,并排除 -----BEGIN RSA PRIVATE KEY----- 部分。
  • 运行 PHPUnit。 ./vendor/bin/phpunit

许可证

此库采用MIT许可证发布。