Download the PHP package zoujingli/wechat-developer without Composer

WeChatDeveloper for PHP

🚀 项目简介

WeChatDeveloper 是一个功能全面、安全可靠的 PHP 微信和支付宝开发 SDK，基于 wechat-php-sdk 重构优化而成。项目经过全面的安全加固和代码质量提升，为开发者提供稳定、安全、易用的微信生态和支付解决方案。

✨ 核心特性

🔒 安全可靠

• 输入验证：全面防护 XSS 攻击，所有用户输入都经过严格过滤和验证
• 文件安全：文件操作前进行存在性和权限检查，防止恶意利用
• 加密安全：使用 SHA-256 替代 MD5，提供更强的安全防护
• 序列化安全：添加反序列化数据验证，防止代码执行攻击

🎯 功能全面

• 微信生态：支持公众号、小程序、企业微信全生态开发
• 支付功能：支持微信支付 V2/V3、支付宝支付全场景
• 多端支持：覆盖 App、H5、PC、小程序等所有平台
• 接口完整：涵盖用户管理、消息推送、素材管理、支付等所有核心功能

⚡ 性能优化

• 自动刷新：AccessToken 失效自动刷新机制
• 缓存支持：支持自定义缓存驱动，可扩展 Redis 等
• 错误重试：智能错误重试机制，提高接口调用成功率
• 类型安全：修复所有类型声明问题，提升代码质量
• 自动缓存清理：自动清理 CURL 临时缓存文件，适配常驻内存框架
• 通用接口支持：提供 callApi() 万能接口，支持多种 HTTP 方法，适用于所有场景

🛠 易于使用

• 统一入口：通过\We::静态方法统一创建各种功能实例
• 向后兼容：完全保持原有 API 和参数，无需修改现有代码
• 通用接口：提供标准化的 callApi() 方法，支持 GET/POST/PUT/DELETE 等多种 HTTP 方法
• 文档完善：提供详细的使用文档和示例代码
• 社区支持：活跃的社区和持续的技术支持

📋 系统要求

• PHP 版本：最低要求 PHP 5.4，建议 PHP 7.0+ 以获取最佳性能
• 扩展要求：curl、json、xml、openssl、mbstring、bcmath
• 权限要求：缓存目录需要写权限
• 推荐环境：PHP 7.4+ / PHP 8.0+ 生产环境

📦 快速开始

安装方式

方式一：Composer 安装（推荐）

方式二：直接下载

基础使用

🎯 功能模块

📱 微信生态支持

微信公众号

• 用户管理：用户信息获取、标签管理、分组管理
• 消息推送：模板消息、客服消息、群发消息
• 素材管理：图片、语音、视频、图文素材上传和管理
• 菜单管理：自定义菜单创建、查询、删除
• 网页授权：OAuth2.0 网页授权，获取用户信息
• 二维码：临时二维码、永久二维码生成
• JSSDK：微信前端 JS-SDK 支持
• 卡券功能：微信卡券接口支持
• 门店管理：门店 WIFI 管理、摇一摇周边

微信小程序

• 数据加密：小程序数据加密解密处理
• 用户管理：用户信息获取、登录状态管理
• 消息推送：订阅消息、模板消息、动态消息
• 二维码：小程序码生成、URL Scheme
• 内容安全：图片内容检测、文本内容检测
• 物流助手：发货信息管理、物流状态查询
• 直播功能：小程序直播接口支持
• 搜索优化：小程序页面搜索优化
• 插件管理：小程序插件申请、管理
• OCR 服务：身份证、银行卡、驾驶证识别
• 生物认证：指纹、面部识别支持

企业微信

• 部门管理：部门信息获取、创建、更新
• 用户管理：企业用户信息管理
• 消息推送：企业消息推送功能

💰 支付功能支持

微信支付

• V2 接口：统一下单、查询、关闭、退款
• V3 接口：新一代支付接口，支持更多功能
• 支付方式：JSAPI、APP、H5、Native、小程序支付
• 订单管理：订单创建、查询、关闭、退款
• 账单管理：对账单下载、交易明细查询
• 企业付款：打款到零钱、打款到银行卡
• 分账功能：微信分账接口支持
• 代金券：代金券创建、发放、核销
• 红包功能：微信红包发送和管理

支付宝支付

• 支付方式：App 支付、Web 支付、Wap 支付、扫码支付、刷卡支付
• 订单管理：订单创建、查询、关闭、退款
• 转账功能：单笔转账、批量转账
• 账单管理：对账单下载、交易查询
• 证书支持：RSA、RSA2 签名，证书模式支持

💡 使用案例

📱 微信公众号功能

用户管理

二维码生成

菜单管理

💰 微信支付功能

微信支付 V2 接口

微信支付 V3 接口

微信红包

💳 支付宝支付功能

网站支付

App 支付

转账功能

📱 微信小程序功能

用户登录和数据解密

小程序码生成

🔧 高级功能

通用接口（万能接口）

所有接口类都提供了 callApi() 通用方法，支持多种 HTTP 方法（GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS），可以直接传入完整 URL 和参数进行请求，适用于官方新增接口或自定义接口调用。

方法签名：

支持的 HTTP 方法：

• GET - 获取资源（默认：微信公众号、支付宝）
• POST - 创建/提交数据（默认：微信支付）
• PUT - 更新资源
• DELETE - 删除资源
• PATCH - 部分更新
• HEAD - 获取响应头
• OPTIONS - 获取支持的方法

微信公众号通用接口

参数说明：

• $url (string) - 完整URL或相对路径（支持 ACCESS_TOKEN 占位符，自动替换）
• $data (array|string) - 请求参数（GET参数或POST数据，支持数组或字符串）
• $method (string) - 请求方法 GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS，默认 GET

默认行为：

• ✅ 自动处理 ACCESS_TOKEN（URL中包含 ACCESS_TOKEN 时自动替换）
• ✅ POST 请求自动转为 JSON（数组数据）
• ✅ 返回解析后的数组

微信支付V2通用接口

参数说明：

• $url (string) - 完整URL
• $data (array|string) - 请求参数（支持数组或字符串）
• $method (string) - 请求方法 GET|POST|PUT|DELETE|PATCH，默认 POST
• $isCert (bool) - 是否需要证书，默认 false
• $signType (string) - 签名类型 MD5|HMAC-SHA256，默认 HMAC-SHA256

默认行为：

• ✅ 自动签名（POST/PUT/PATCH/DELETE 请求）
• ✅ 返回解析后的数组（XML格式）

微信支付V3通用接口

参数说明：

• $url (string) - 完整URL或相对路径（如 /v3/pay/transactions/jsapi）
• $data (array|string) - 请求数据（数组会自动转为JSON）
• $method (string) - 请求方法 GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS，默认 POST
• $verify (bool) - 验证响应签名，默认 false

默认行为：

• ✅ 数组数据自动转为 JSON
• ✅ 返回解析后的数组

支付宝通用接口

参数说明：

• $apiMethod (string) - API方法名（如：alipay.trade.query），必填，第一参数
• $data (array|string) - 请求参数（支持数组或字符串）
• $method (string) - 请求方法 GET|POST|PUT|DELETE|PATCH，默认 GET
• $verify (bool) - 验证响应签名，默认 false

默认行为：

• ✅ 自动使用 gateway 作为请求URL
• ✅ 自动签名（默认开启）
• ✅ 返回解析后的数组

自定义缓存

SDK 支持自定义缓存驱动，可以适配 Redis、Memcached 等缓存系统，特别适用于常驻内存框架（Workerman、Swoole 等）。

错误处理

🧩 小程序快速示例

订阅消息发送

内容安全校验

⚙️ 配置说明

基础配置

微信公众号配置

微信支付配置

支付宝配置

❓ 常见问题

Q: 如何获取微信支付证书？

A: 登录微信商户平台，在"账户中心" -> "API 安全" -> "API 证书"中下载证书文件，或使用 API 证书下载工具。

Q: 支付宝沙箱环境如何配置？

A: 设置 debug => true 并使用沙箱环境的 appid 和密钥即可。

Q: AccessToken 过期怎么办？

A: SDK 已内置自动刷新机制，无需手动处理。如需自定义，可设置 GetAccessTokenCallback 回调函数。

Q: 如何自定义缓存存储？

A: 配置 \WeChat\Contracts\Tools::$cache_callable 数组，实现自定义的缓存逻辑。

Q: 支持哪些 PHP 版本？

A: 最低支持 PHP 5.4，建议使用 PHP 7.0+ 以获得最佳性能。

Q: 如何处理支付回调？

A: 使用 \WeChat\Receive 类处理微信支付回调，使用 \AliPay\Web 的 notify() 方法处理支付宝回调。

Q: 小程序数据解密失败？

A: 确保 session_key 有效且未过期，检查 iv 和 encryptedData 参数是否正确。

Q: 如何调试接口调用？

A: 开启错误日志，查看具体的错误信息。SDK 会抛出详细的异常信息帮助定位问题。

Q: 如何在常驻内存框架中使用？

A: SDK 会自动清理 CURL 缓存文件，无需额外配置。在常驻内存环境中，建议通过自定义缓存驱动（\WeChat\Contracts\Tools::$cache_callable）使用 Redis 等外部缓存，避免文件缓存带来的问题。

📁 文件说明

📚 文档资源

官方文档

• 微信公众平台：https://mp.weixin.qq.com/wiki
• 微信支付文档：https://pay.weixin.qq.com/wiki/doc/api/index.html
• 支付宝开放平台：https://opendocs.alipay.com/

项目资源

• ThinkAdmin：https://github.com/zoujingli/ThinkAdmin
• 在线文档：https://www.kancloud.cn/zoujingli/wechat-developer
• 技术交流群：QQ 群 513350915

代码仓库

• GitHub：https://github.com/zoujingli/WeChatDeveloper（主仓库）
• Gitee：https://gitee.com/zoujingli/WeChatDeveloper（国内镜像）
• GitCode：https://gitcode.com/ThinkAdmin/WeChatDeveloper（国内镜像）

🛡️ 安全说明

本项目经过全面的安全加固，包括：

• 输入验证和 XSS 防护
• 文件操作安全检查
• 加密算法安全升级
• 序列化数据验证
• 类型安全修复

建议在生产环境中：

• 定期更新到最新版本
• 配置 HTTPS 传输
• 设置适当的文件权限
• 监控异常访问日志

📄 版权说明

WeChatDeveloper 遵循 MIT 开源协议发布，并免费提供使用。

本项目包含的第三方源码和二进制文件的版权信息将另行标注，请在对应文件查看。

版权所有 Copyright © 2014-2025 by ThinkAdmin (https://thinkadmin.top) All rights reserved。

💝 赞助支持

如果这个项目对您有帮助，欢迎赞助支持！