PHPackages                             wood/sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. wood/sdk

ActiveLibrary[Payment Processing](/categories/payments)

wood/sdk
========

简木PHP-SDK - 个人开发的聚合支付与云服务SDK，为简木聚合支付系统及其他项目提供支付宝、微信支付、阿里云等第三方服务的统一接口封装。支持支付宝 V3/V2 接口（含公私钥和证书签名模式）、微信支付 V3 接口（含签名、解密、公钥加密、图片上传）、阿里云 OpenAPI（ACS3-HMAC-SHA256 签名）

v1.0.3(2w ago)14↓100%MITPHPPHP 8.3.\*

Since Apr 22Pushed 2w agoCompare

[ Source](https://github.com/SimpleWood217/wood-sdk)[ Packagist](https://packagist.org/packages/wood/sdk)[ RSS](/packages/wood-sdk/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

🚀 简木PHP-SDK
===========

[](#-简木php-sdk)

✨ 个人开发的聚合支付PHP SDK，封装支付宝、微信支付、阿里云等第三方服务的统一接口。

> 📦 用于简木聚合支付系统及其他项目的依赖包

🌟 功能特性
------

[](#-功能特性)

- 💳 **支付宝 V3 接口** - 支持公私钥和证书两种签名方式，支持图片上传
- 🔄 **支付宝 V2 接口** - 传统接口版本，支持页面跳转和后端调用模式
- 💰 **微信支付 V3 接口** - 支持签名、解密、公钥加密、图片上传等功能
- ☁️ **阿里云 OpenAPI** - 支持 ACS3-HMAC-SHA256 签名算法，适用于短信等服务

📋 环境要求
------

[](#-环境要求)

- 🐘 PHP >= 8.3
- 🔐 ext-openssl
- 🛡️ ext-sodium
- 🔢 ext-bcmath
- 📦 GuzzleHttp 7.5.x

📥 安装
----

[](#-安装)

```
composer require wood/sdk
```

🚀 快速开始
------

[](#-快速开始)

### 💳 支付宝 V3 接口

[](#-支付宝-v3-接口)

```
use Wood\Sdk\AlipayServiceClient;

// 📌 使用公私钥模式
$client = AlipayServiceClient::newInstance([
    'appid' => 'your_app_id',
    'private_key' => 'your_private_key',
    'alipay_public_key' => 'alipay_public_key',
    'sign_type' => 'rsa', // 默认值，可省略
]);

// 📌 或使用证书模式
$client = AlipayServiceClient::newInstance([
    'appid' => 'your_app_id',
    'private_key' => 'your_private_key',
    'alipay_app_cert' => 'path/to/appCertPublicKey.crt',
    'alipay_public_cert' => 'path/to/alipayCertPublicKey_RSA2.crt',
    'sign_type' => 'cert',
]);

// 🚀 发起请求
$client->setPath('/v3/alipay/trade/pay');
$client->setRequest([
    'out_trade_no' => '20230101001',
    'total_amount' => '0.01',
    'subject' => '测试订单',
]);
$result = $client->execute();

// 🧪 沙箱环境
$client->setSandbox(true);
```

### 🔄 支付宝 V2 接口

[](#-支付宝-v2-接口)

```
use Wood\Sdk\AlipayServiceClientV2;

$client = AlipayServiceClientV2::newInstance([
    'appid' => 'your_app_id',
    'private_key' => 'your_private_key',
    'alipay_public_key' => 'alipay_public_key',
    'sign_type' => 'rsa',
]);

// 📝 设置接口和业务参数
$client->setAction('alipay.trade.page.pay');
$client->setBizContent([
    'out_trade_no' => '20230101001',
    'total_amount' => '0.01',
    'subject' => '测试订单',
]);
$client->setNotifyUrl('https://yourdomain.com/notify');
$client->setReturnUrl('https://yourdomain.com/return');

// 🔗 页面跳转模式（生成自动提交的表单）
$form = $client->execute();

// 🖥️ 后端调用模式
$client->setIsPageExecute(false);
$result = $client->execute();
```

### 💰 微信支付 V3 接口

[](#-微信支付-v3-接口)

```
use Wood\Sdk\WxpayServiceClient;

$client = WxpayServiceClient::newInstance([
    'merch_no' => 'your_merchant_id',
    'api_v3' => 'your_api_v3_key',
    'cert_number' => 'your_cert_serial_number',
    'private_key_path' => 'path/to/apiclient_key.pem',
    'wxpay_public_key_id' => 'your_wxpay_public_key_id',
    'wxpay_public_key_path' => 'path/to/wxpay_pub_key.pem',
]);

// 🚀 发起支付请求
$client->setPath('/v3/pay/transactions/jsapi');
$client->setRequestBody([
    'mchid' => 'your_merchant_id',
    'out_trade_no' => '20230101001',
    'amount' => ['total' => 1, 'currency' => 'CNY'],
    'payer' => ['openid' => 'user_openid'],
]);
$result = $client->execute();

// 🔓 解密回调数据
$decryptData = $client->decryptByV3($ciphertext, $associatedData, $nonce);

// 🖼️ 上传图片
$client->setPath('/v3/merchant/media/upload');
$imageResult = $client->uploadImage($imageContent, 'image.jpg');
```

### ☁️ 阿里云 OpenAPI

[](#️-阿里云-openapi)

```
use Wood\Sdk\AliyunOpenAPI;

$client = new AliyunOpenAPI();
$client->setAccessKeyId('your_access_key_id');
$client->setAccessKeySecret('your_access_key_secret');
$client->setAction('SendSms');
$client->setVersion('2017-05-25');
$client->setRequestData([
    'PhoneNumbers' => '13800138000',
    'SignName' => '你的签名',
    'TemplateCode' => 'SMS_123456789',
    'TemplateParam' => '{"code":"1234"}',
]);
$result = $client->execute();
```

⚙️ 配置说明
-------

[](#️-配置说明)

### 🔐 签名类型

[](#-签名类型)

签名类型支付宝 V3支付宝 V2微信支付 V3阿里云 OpenAPI🔑 RSA公私钥✅✅✅❌📜 证书模式✅✅✅❌🛡️ HMAC-SHA256❌❌❌✅### 🛡️ 严格模式

[](#️-严格模式)

支付宝客户端默认开启严格模式，会校验支付宝返回的响应签名：

```
// ❌ 关闭严格模式
$client = new AlipayServiceClient(false);
```

⚠️ 注意事项
-------

[](#️-注意事项)

1. 📁 所有路径参数相对于项目根目录
2. 🔒 私钥和证书文件请妥善保管，不要提交到版本控制系统
3. 💳 微信支付V3接口需要商户证书序列号和API V3密钥
4. ☁️ 阿里云OpenAPI使用ACS3-HMAC-SHA256签名算法

👤 作者
----

[](#-作者)

🧑‍💻 WooD - 📧

📄 许可证
-----

[](#-许可证)

📜 本项目基于 MIT 许可证，详见 [LICENSE](LICENSE) 文件。

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance97

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~16 days

Total

3

Last Release

16d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c746521d4838384ba21931f726a5b1b9e4d106a4ac89b8617f52d2751a109001?d=identicon)[simplewood](/maintainers/simplewood)

---

Tags

sdkpaymentaliyunalipaywechat-payjmpay

### Embed Badge

![Health badge](/badges/wood-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/wood-sdk/health.svg)](https://phpackages.com/packages/wood-sdk)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k532.1M2.5k](/packages/aws-aws-sdk-php)[craftcms/cms

Craft CMS

3.6k3.6M2.9k](/packages/craftcms-cms)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k11](/packages/tempest-framework)[robokassa/sdk-php

SDK для работы с Robokassa в PHP

1111.7k](/packages/robokassa-sdk-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)