开源项目 yansongda/pay 使用教程
pay可能是我用过的最优雅的 Alipay/WeChat/Unipay 的支付 SDK 扩展包了项目地址:https://gitcode.com/gh_mirrors/pa/pay
1. 项目的目录结构及介绍
pay/
├── composer.json
├── composer.lock
├── LICENSE
├── README.md
├── src/
│ ├── Adapter/
│ │ ├── Alipay.php
│ │ ├── Wechat.php
│ │ └── ...
│ ├── Exception/
│ │ ├── Exception.php
│ │ ├── InvalidArgumentException.php
│ │ └── ...
│ ├── Pay.php
│ └── ...
├── tests/
│ ├── Adapter/
│ │ ├── AlipayTest.php
│ │ ├── WechatTest.php
│ │ └── ...
│ ├── TestCase.php
│ └── ...
└── vendor/
- composer.json: 项目的依赖管理文件,定义了项目所需的依赖包。
- composer.lock: 锁定文件,确保项目在不同环境中使用相同的依赖版本。
- LICENSE: 项目的开源许可证文件。
- README.md: 项目的说明文档,通常包含项目的基本介绍、安装方法和使用示例。
- src/: 项目的源代码目录,包含主要的业务逻辑和功能实现。
- Adapter/: 适配器目录,包含不同支付平台的适配器实现,如支付宝(Alipay)和微信支付(Wechat)。
- Exception/: 异常处理目录,包含项目中可能抛出的各种异常类。
- Pay.php: 项目的核心文件,定义了支付相关的核心逻辑和接口。
- tests/: 项目的测试代码目录,包含单元测试和功能测试。
- Adapter/: 适配器测试目录,包含对不同支付平台适配器的测试。
- TestCase.php: 测试用例基类,提供测试框架的基础支持。
- vendor/: 项目的依赖包目录,包含通过 Composer 安装的所有第三方库。
2. 项目的启动文件介绍
项目的启动文件主要是 src/Pay.php
,该文件定义了支付相关的核心逻辑和接口。通过该文件,可以初始化支付对象,并调用相应的支付方法。
// 示例代码
require 'vendor/autoload.php';
use Yansongda\Pay\Pay;
$config = [
'alipay' => [
// 支付宝配置
],
'wechat' => [
// 微信支付配置
],
];
$pay = new Pay($config);
$result = $pay->alipay()->web($order);
3. 项目的配置文件介绍
项目的配置文件通常在初始化支付对象时传入,配置文件的内容根据不同的支付平台有所不同。以下是一个示例配置文件:
$config = [
'alipay' => [
'app_id' => 'your_app_id',
'notify_url' => 'your_notify_url',
'return_url' => 'your_return_url',
'ali_public_key' => 'your_ali_public_key',
'private_key' => 'your_private_key',
'log' => [
'file' => './logs/alipay.log',
],
],
'wechat' => [
'app_id' => 'your_app_id',
'mch_id' => 'your_mch_id',
'notify_url' => 'your_notify_url',
'key' => 'your_key',
'cert_client' => './cert/apiclient_cert.pem',
'cert_key' => './cert/apiclient_key.pem',
'log' => [
'file' => './logs/wechat.log',
],
],
];
- alipay: 支付宝配置项,包含
app_id
、notify_url
、return_url
、ali_public_key
、private_key
等。 - wechat: 微信支付配置项,包含
app_id
、mch_id
、notify_url
、key
、cert_client
、cert_key
等。
配置文件中的 log
项用于指定日志文件的路径,方便记录支付过程中的日志信息。
pay可能是我用过的最优雅的 Alipay/WeChat/Unipay 的支付 SDK 扩展包了项目地址:https://gitcode.com/gh_mirrors/pa/pay