README

Transbank PHP SDK

Transbank官方SDK

要求

• PHP 5.5+

依赖关系

如果您使用Composer安装，以下依赖项应自动安装，但如果您直接使用SDK，也需要

• ext-curl
• ext-json
• ext-mbstring
• ext-soap

安装

使用Composer安装

要在您的项目中使用SDK，可以使用Composer（如果您还没有安装，可以在此安装），将SDK添加到您的项目依赖中

    "require": {
        "transbank/transbank-sdk": "^1.7"
    }

您也可以从控制台安装

composer require transbank/transbank-sdk

或者，如果您不想使用Composer，可以从此存储库下载代码并直接要求它

require_once('/directorio/del/sdk/init.php');

文档

您可以在https://www.transbankdevelopers.cl找到如何使用此SDK的全部文档。

使用此SDK的相关文档是

• 关于产品和它们之间区别的通用文档： Webpay 和 Onepay。
• 关于环境、商家责任、部署等内容的文档。
• Webpay和Onepay的入门指南。
• 关于Webpay和Onepay的详细参考资料。

关于贡献和开发此SDK的信息

要求

• Docker
• Make
• 为您的首选编辑器安装editorconfig插件。

标准

• 对于提交，我们遵守以下规范：https://chris.beams.io/posts/git-commit/
• 我们使用英文，用于提交消息。
• 可以在提交消息的主题中使用tokens，如WIP，用:分隔token，例如：WIP: This is a useful commit message
• 对于分支名称，我们也使用英文。
• 假设，未混合的特征分支是一个未完成的功能。
• 分支名称使用小写。
• 单词之间用-分隔。
• 分支名称以定义的短前缀之一开始，例如：feat/tokens-configuration

短前缀

提交

• WIP = 进度中的工作。

分支

• feat = 新功能
• chore = 对用户不可见的任务。
• bug = 错误修复。

所有向master的合并都通过Pull Request进行。

测试

要本地执行测试，请在终端中执行以下命令。

make

然后执行测试

make test

部署新版本。

要生成新版本，需要创建一个PR（标题为“准备发布X.Y.Z”，其中包含相应的X、Y和Z值）。必须遵循semver标准来确定是否增加X（如果有不兼容的更改）、Y（用于兼容性改进）或Z（如果只有bug修复）的值。

在该PR中应包括以下更改

1. 修改CHANGELOG.md文件，为X.Y.Z添加一个新条目（在开头），用西班牙语解释SDK用户可见的更改。
2. 修改此README.md，使其示例使用新版本X.Y.Z
3. 修改composer.json文件，将"version"属性指向新版本X.Y.Z

在获得pull request的批准后，将其合并到master分支，并立即在GitHub上生成带有tag X.Y.Z的release。在release描述中，放入你添加到changelog中的内容。

这样Travis CI将自动生成库的新版本并将其发布到Packagist。

安全漏洞

如果您在此项目中发现安全漏洞，请通过电子邮件通知我们transbankdevelopers@continuum.cl。我们将尽快处理此事。