【亲测免费】 开源项目 yansongda/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 项用于指定日志文件的路径，方便记录支付过程中的日志信息。