roberts91/sdk-for-php

此包已 废弃 并不再维护。未建议替代包。

Target365 SDK

v1.7.6 2022-07-04 10:07 UTC

README

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

Target365 SDK for PHP

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 许可证发布。