README

Resurs EComPHP Gateway是用于Resurs Bank商店流程的网关，功能足以快速开始。它通过Simplified Flow API进行支付预订、配置服务和After Shop Service API进行最终确认、信用和取消等操作。此完整版本的网关与Hosted Payment Flow和Resurs Checkout（支持REST和SOAP）进行通信。EComPHP的PHP参考文档位于https://test.resurs.com/autodocs/apigen/ecomphp-1.3-develop/，如果您想查看我们自动生成的文档。

由于EComPHP持续开发，您应该查看我们的bitbucket仓库以保持此信息更新。它位于https://bitbucket.org/resursbankplugins/resurs-ecomphp

为什么版本号跳跃这么大？

不时地，我们会为内部热修复创建非官方版本，这绕过了常规任务创建。我们真的应该考虑将这些更新添加到任务中（通过审查提交），但有时这也非常关于拼写检查和docblock调整。它们很少与任务相关联。空白处用"- x.x.x"填充，其中破折号代表"到此版本，已进行了这些更改"。

常规需求、依赖和信息

EComPHP 1.3是为PHP 5.6编写的，但不再保证它能在旧系统中工作。请确保升级。
OpenSSL - 或类似。SSL驱动程序与Resurs Bank通信是必需的。
curl：php-curl带有SSL支持（确保满足上述SSL要求！）。
php-xml和流（用于SOAP部分）。
EComPHP使用NetCURL进行“混合调用”（SOAP与REST）。packagist组件位于此处。
如果您计划仅使用Resurs Checkout（仅结算，没有aftershop，回调或列出支付方式等需求）- 则不需要SoapClient。

已撤销的版本

EComPHP 1.2已被完全撤销。
EComPHP 1.1和1.0不再官方维护（2020年7月）。

测试：Bamboo、github actions和bitbucket pipelines

EComPHP在几个不同的套件中进行测试。由于缺乏“测试时间”，Bitbucket Cloud中未完全执行测试，因此测试还从其他地方的提交执行。以下是一些实例。

验证PHP版本

如果您不确定PHP团队还支持哪些PHP版本，请查看此页面。截至2020年2月，只有7.3和7.4有完整支持。7.2仍然有安全补丁支持，但处于弃用状态。所有旧版本都完全不受支持，您也应该考虑升级。

7.3 - 8.0 - Supported, autotests active.
5.6 - 7.2 - SUpported, no autotests, [EOL by PHP](https://php.ac.cn/supported-versions.php).

安装

对于Ubuntu，如果您系统中缺少这些，可以像以下那样快速使用apt-get获取它们：

apt-get install php-curl php-xml php-soap

可能还有很小的可能性您也需要openssl或类似工具，因为我们的服务仅运行在https上（通常openssl会自动提供，但有时并不会 - 如果您有访问服务器的权限，可以使用apt-get install openssl来安装）。

使用composer

composer require resursbank/ecomphp:^1.3

自行部署的包

如果您计划部署包含在此包中的插件，您可以使用composer并带有参数--prefer-dist。您还应该确保与该包一起下载的存储库被正确清理：必须删除.git目录，或者在使用之前需要进行composer install。这样的部署可能看起来像这样

#!/bin/bash
composer clearcache
rm -rf vendor composer.lock
composer install --prefer-dist
find vendor/ -type d -name .git -exec rm -rf {} \; >/dev/null 2>&1
find vendor/ -name .gitignore -exec rm {} \; >/dev/null 2>&1

入门指南

这是一个如何开始的简短示例，但您可以通过查看我们的文档以获取详细信息并开始实际操作。

<?php
    require_once("vendor/autoload.php");
    $resurs = new \Resursbank\RBEcomPHP\ResursBank($myMerchantUserName, $myMerchantPassword);
    $methods = $resurs->getPaymentMethods();
    print_r($methods);
?>

这个库能做什么和不能做什么

如果您习惯于使用简化流程并希望使用Hosted/Checkout，您可以继续使用较老的SimplifiedFlow变量，因为这个库会转换不同流程之间缺失的部分。
EComPHP-library库负责许多开发人员通常在开发中会忽略的事情。特别是处理有效载荷。
支持SOAP和REST，但前提是存在相应的驱动程序。

resursbank / ecomphp

维护者

详细信息