izapbrasil / pagseguro-php
PagSeguro 集成库
2.7.5
2018-06-14 13:18 UTC
Requires
- php: >=5.4.27
- ext-curl: *
- lib-curl: *
- lib-libxml: *
- lib-openssl: *
README
Este é um fork da biblioteca original do PagSeguro (pagseguro/php 2.7.1).
O objetivo é apenas a correção de erros críticos até a migração para a nova versão.
该库已过时。请使用可在 https://github.com/pagseguro/php3 找到的新版本。
描述
PHP 版本的 PagSeguro 库是一套域类集合,它简化了 PHP 开发者使用 PagSeguro 提供的 API 功能。安装并配置该库后,您可以轻松集成以下功能:
要求
安装
- 下载仓库为 zip 文件或进行克隆;
- 在您的计算机上解压缩文件;
- 在 source 目录下存在两个目录:examples 和 PagSeguroLibrary。目录 examples 包含使用 API 的调用示例,而目录 PagSeguroLibrary 包含实际的库。如果您只想导入库,请上传 PagSeguroLibrary 目录并将 PagSeguroLibrary.php 类包含到您的项目中。这个类将负责在其系统中导入库的所有功能。
通过 Composer 安装
- 或者,可以使用 Composer 来加载库 (pagseguro/php)。
{ "require": { "pagseguro/php": "@stable" } }
配置
为了实际使用该库,需要在 'config' 目录下的 'PagSeguroConfig.php' 文件中进行一些配置。下面的选项描述如下:
- environment:接受 production 和 sandbox 值。要使用 sandbox,需要在 https://sandbox.pagseguro.uol.com.br 创建一个账户。
- email:在 PagSeguro 上注册的电子邮件。
- token production:在 PagSeguro 上生成的 token。
- token sandbox:在 Sandbox 上生成的 token。
- appId production:在 PagSeguro 上生成的应用程序。
- appId sandbox:在 Sandbox 上生成的应用程序。
- appKey production:在 PagSeguro 上应用程序的 token。
- appKey sandbox:在 Sandbox 上应用程序的 token。
- charset:您的系统编码(ISO-8859-1 或 UTF-8)。
- log:激活/禁用日志生成。
- fileLocation:希望创建日志文件的本地。例如:/logs/ps.log。
更多信息请参阅官方文档。
疑问?
如有疑问或需要支持,请访问我们的论坛。
变更日志
2.7.5
- 添加了对TLS 1.2的支持
2.7.4
- 改进了类到字符串的转换
2.7.3
- 修复了地址字段的长度限制
- 修复了项目描述的长度限制
2.7.2
- 修复了静态方法调用
2.7.1
- 可以定义无息分期付款。
- 一般调整。
2.7.0
- 通过通知代码进行签名服务(预批准)的集成。
2.6.0
- 用于Laravel 5集成的环境变量 #0a2c2ba
- 配置文件包装器 #c1b0985
- 签名API的实现 #7cd8147
- 取消服务请求的集成。
- 一般调整。
- 注意:一些描述的功能尚未对所有卖家商业化。如有疑问,请访问我们的论坛。
2.5.0
- 可以在请求结账代码时定义折扣 - 请参阅createPaymentRequest.php示例
2.4.0
- 通过参考代码进行交易/授权查询的集成。
- 应用程序模式的集成。
- 退款请求的集成。
- 一般调整。
- 注意:上述功能尚未对所有卖家商业化。如有疑问,请访问我们的论坛。
2.3.0
- 添加了用于透明结账的类和方法。
- 通过通知代码和交易代码的查询现在使用新的API版本。
2.2.4
- 在PagSeguroConfig类中添加了setEnvironment方法
- 改进了文档/代码注释
- 各种调整
2.2.3
- 代码调整
2.2.2
- 添加环境变量 沙盒
2.2.1
- 调整了对PagSeguro请求返回的XML的处理
2.2.0
- 注册交易时,可以仅获取结账代码以用于轻量级结账窗口(请参阅createPaymentRequestLightbox.php示例)。注意:此功能尚未对所有卖家商业化。
2.1.9
- 代码的美学改进,如缩进/格式化。
2.1.8
- 支付方式代码更新。
- 提高了最小运行要求识别。
- 改进了与地址相关的数据处理。
2.1.7
- 添加了用于处理元数据和通用参数的类。
2.1.6
- 添加了用于处理发送者文档的类,例如CPF。
2.1.5
- 添加了发送通知请求的处理功能。
- 新增:为helper处理数据添加新功能。
- 修正:修正了结账请求中发送者名称的双空格处理。
2.1.4
- 新增:添加了处理交易中允许货币的类。
2.1.3
- 修正:如果日志生成处于活动状态且用户没有日志生成文件或读写权限,请求会被中止。
2.0.0 - 2.1.2
- 代表支付、通知和交易的域名类。
- 通过API创建结账。
- 用于处理PagSeguro发送的支付通知的控制器。
- 交易查询模块。
许可
版权2013 PagSeguro Internet LTDA。
根据Apache许可证2.0版(“许可证”)许可;除非适用法律要求或书面同意,否则不得使用此文件,除非符合许可证。您可以在以下位置获取许可证副本:
https://apache.ac.cn/licenses/LICENSE-2.0
除非根据适用法律或书面同意,否则在许可证下分发的软件按“原样”分发,不提供任何明示或暗示的保证或条件。有关许可证的具体语言、权限和限制,请参阅许可证。
注释
- PagSeguro 只接受使用巴西雷亚尔(BRL)进行支付。
- 请确保提供的电子邮件和令牌与具有卖家或企业档案的账户相关联。
- 请确保已正确设置字符集,以符合系统的编码(ISO-8859-1 或 UTF-8)。这可以防止交易产生可能的错误或中断,或者特殊字符以不同方式显示。
- 为了正常生成日志,请确保日志目录和文件具有读写权限。
- 要使用透明结账,需要向 PagSeguro 团队申请激活。更多详细信息,请参阅 如何通过 PagSeguro 接收支付。
疑问?
如有疑问,请访问我们的 论坛。
贡献
发现了错误或有一些功能想法,想要贡献吗?
- 进行 fork
- 添加您的功能或错误修复(git checkout -b my-new-feature)
- 提交您的更改(git commit -am '添加了一些功能')
- 将分支推送到远程(git push origin my-new-feature)
- 发送拉取请求
- 注意:为您的新的功能添加示例。如果您的拉取请求与特定版本相关,请不要向 master 分支发送拉取请求,而是向对应版本的分支发送。