PHPackages sunnyli/wechat-developer - 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. sunnyli/wechat-developer ActiveLibrary[Payment Processing](/categories/payments) sunnyli/wechat-developer ======================== WeChat platform and Payment development tools 11PHP Since Jul 3Pushed 3y ago1 watchersCompare [ Source](https://github.com/lxy12/wxpay)[ Packagist](https://packagist.org/packages/sunnyli/wechat-developer)[ RSS](/packages/sunnyli-wechat-developer/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (1)Used By (0) WeChatDeveloper for PHP ======================= [](#wechatdeveloper-for-php) [![Latest Stable Version](https://camo.githubusercontent.com/4661eb7915351b1e78ab2a6d03e560481ff3df9a0431c7d5c6a908cec7591632/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7765636861742d646576656c6f7065722f762f737461626c65)](https://packagist.org/packages/zoujingli/wechat-developer)[![Total Downloads](https://camo.githubusercontent.com/211f8ffc36542ce44524be0b8874d75bdaeb0fe08f6980c3da237318f8ef6d07/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7765636861742d646576656c6f7065722f646f776e6c6f616473)](https://packagist.org/packages/zoujingli/wechat-developer)[![Monthly Downloads](https://camo.githubusercontent.com/3c9c225bac8ea10cccbeabd3f0865c542f4be0c0aedc53585b78046c7306c746/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7765636861742d646576656c6f7065722f642f6d6f6e74686c79)](https://packagist.org/packages/zoujingli/wechat-developer)[![Daily Downloads](https://camo.githubusercontent.com/1efad56c13164d47428615107a1f642def1b6163c2b515e43d36c446557c2607/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7765636861742d646576656c6f7065722f642f6461696c79)](https://packagist.org/packages/zoujingli/wechat-developer)[![PHP Version Require](https://camo.githubusercontent.com/a47986fb7bdbaa6f6709209fa167b4cd05365572137aeadb55dd2874d583e774/687474703a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7765636861742d646576656c6f7065722f726571756972652f706870)](https://packagist.org/packages/wechat-developer)[![License](https://camo.githubusercontent.com/d8e1fdae598c6af61909d2ee7783d4f63baf2792610a191cb40cd484461fc1f6/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7765636861742d646576656c6f7065722f6c6963656e7365)](https://packagist.org/packages/zoujingli/wechat-developer) - WeChatDeveloper 是基于 [wechat-php-sdk](https://github.com/zoujingli/wechat-php-sdk) 重构，优化并完善； - 运行最底要求 PHP 版本 5.4 , 建议在 PHP7 上运行以获取最佳性能； - 目前 WeChatDeveloper 针对 access\_token 失效增加了自动刷新机制； - 微信的部分接口需要缓存数据在本地，因此配置目录并需要对目录有写权限； - 我们鼓励大家使用 composer 来管理您的第三方库，方便后期更新操作； - WeChatDeveloper 已历经数个线上项目考验，欢迎 fork 或 star 此项目。 - 微信商户已经支持 v2 和 v3 接口，未加入的接口可以使用通用方式调用。 功能描述 ---- [](#功能描述) - 微信小程序，服务端接口支持 - 微信认证服务号，服务端接口支持 - 微信支付（账单、卡券、红包、退款、转账、App支付、JSAPI支付、Web支付、扫码支付等） - 支付宝支付（账单、转账、App支付、刷卡支付、扫码支付、Web支付、Wap支付等） 技术帮助 ---- [](#技术帮助) PHP开发技术交流（QQ群 513350915） [![PHP微信开发群 (SDK)](https://camo.githubusercontent.com/d8a86bc02a44a78d23d0746f300d73b0f9bb7e9a1f9eb6af61b2f159525f317d/687474703a2f2f7075622e69647171696d672e636f6d2f7770612f696d616765732f67726f75702e706e67)](http://shang.qq.com/wpa/qunwpa?idkey=ae25cf789dafbef62e50a980ffc31242f150bc61a61164458216dd98c411832a) WeChatDeveloper 是基于官方接口封装，在做微信开发前，必需先阅读微信官方文档。 - 微信官方文档： - 商户支付文档： 针对 WeChatDeveloper 也有一准备了帮助资料可供参考。 - ThinkAdmin： - WeChatDeveloper： 代码仓库 ---- [](#代码仓库) WeChatDeveloper 为开源项目，允许把它用于任何地方，不受任何约束，欢迎 fork 项目。 - Gitee 托管地址： - GitHub 托管地址： 文件说明（后续会根据官方文档增加文件） ------------------- [](#文件说明后续会根据官方文档增加文件) 文件名类名描述类型加载 ①App.phpAliPay\\App支付宝App支付支付宝支付\\We::AliPayApp()Bill.phpAliPay\\Bill支付宝账单下载支付宝支付\\We::AliPayBill()Pos.phpAliPay\\Pos支付宝刷卡支付支付宝支付\\We::AliPayPos()Scan.phpAliPay\\Scan支付宝扫码支付支付宝支付\\We::AliPayScan()Transfer.phpAliPay\\Transfer支付宝转账支付宝支付\\We::AliPayTransfer()Wap.phpAliPay\\Wap支付宝Wap支付支付宝支付\\We::AliPayWap()Web.phpAliPay\\Web支付宝Web支付支付宝支付\\We::AliPayWeb()Card.phpWeChat\\Card微信卡券接口支持认证服务号\\We::WeChatCard()Custom.phpWeChat\\Custom微信客服消息接口支持认证服务号\\We::WeChatCustom()Media.phpWeChat\\Media微信媒体素材接口支持认证服务号\\We::WeChatMedia()Oauth.phpWeChat\\Oauth微信网页授权消息类接口认证服务号\\We::WeChatOauth()Pay.phpWeChat\\Pay微信支付类接口认证服务号\\We::WeChatPay()Product.phpWeChat\\Product微信商店类接口认证服务号\\We::WeChatProduct()Qrcode.phpWeChat\\Qrcode微信二维码接口支持认证服务号\\We::WeChatQrcode()Receive.phpWeChat\\Receive微信推送事件消息处理支持认证服务号\\We::WeChatReceive()Scan.phpWeChat\\Scan微信扫一扫接口支持认证服务号\\We::WeChatScan()Script.phpWeChat\\Script微信前端JSSDK支持认证服务号\\We::WeChatScript()Shake.phpWeChat\\Shake微信蓝牙设备揺一揺接口认证服务号\\We::WeChatShake()Tags.phpWeChat\\Tags微信粉丝标签接口支持认证服务号\\We::WeChatTags()Template.phpWeChat\\Template微信模板消息接口支持认证服务号\\We::WeChatTemplate()User.phpWeChat\\User微信粉丝管理接口支持认证服务号\\We::WeChatCard()Wifi.phpWeChat\\Wifi微信门店WIFI管理支持认证服务号\\We::WeChatWifi()Draft.phpWeChat\\Draft微信草稿箱认证服务号\\We::WeChatDraft()Freepublish.phpWeChat\\Freepublish微信发布能力认证服务号\\We::WeChatFreepublish()Bill.phpWePay\\Bill微信商户账单及评论微信支付\\We::WePayBill()Coupon.phpWePay\\Coupon微信商户代金券微信支付\\We::WePayCoupon()Order.phpWePay\\Order微信商户订单微信支付\\We::WePayOrder()Redpack.phpWePay\\Redpack微信红包支持微信支付\\We::WePayRedpack()Refund.phpWePay\\Refund微信商户退款微信支付\\We::WePayRefund()Transfers.phpWePay\\Transfers微信商户打款到零钱微信支付\\We::WePayTransfers()TransfersBank.phpWePay\\TransfersBank微信商户打款到银行卡微信支付\\We::WePayTransfersBank()Crypt.phpWeMini\\Crypt微信小程序数据加密处理微信小程序\\We::WeMiniCrypt()Plugs.phpWeMini\\Plugs微信小程序插件管理微信小程序\\We::WeMiniPlugs()Poi.phpWeMini\\Poi微信小程序地址管理微信小程序\\We::WeMiniPoi()Qrcode.phpWeMini\\Qrcode微信小程序二维码管理微信小程序\\We::WeMiniCrypt()Template.phpWeMini\\Template微信小程序模板消息支持微信小程序\\We::WeMiniTemplate()Total.phpWeMini\\Total微信小程序数据接口微信小程序\\We::WeMiniTotal()安装使用 ---- [](#安装使用) 1.1 通过 Composer 来管理安装 ``` # 首次安装 线上版本（稳定） composer require zoujingli/wechat-developer # 首次安装 开发版本（开发） composer require zoujingli/wechat-developer dev-master # 更新 WeChatDeveloper composer update zoujingli/wechat-developer ``` 1.2 如果不使用 Composer， 可以下载 WeChatDeveloper 并解压到项目中 ``` # 在项目中加载初始化文件 include "您的目录/WeChatDeveloper/include.php"; ``` 2.1 接口实例所需参数 ``` $config = [ 'token' => 'test', 'appid' => 'wx60a43dd8161666d4', 'appsecret' => '71308e96a204296c57d7cd4b21b883e8', 'encodingaeskey' => 'BJIUzE0gqlWy0GxfPp4J1oPTBmOrNDIGPNav1YFH5Z5', // 配置商户支付参数（可选，在使用支付功能时需要） 'mch_id' => "1235704602", 'mch_key' => 'IKI4kpHjU94ji3oqre5zYaQMwLHuZPmj', // 配置商户支付双向证书目录（可选，在使用退款|打款|红包时需要） 'ssl_key' => '', 'ssl_cer' => '', // 缓存目录配置（可选，需拥有读写权限） 'cache_path' => '', ]; ``` 3.1 实例指定接口 ``` try { // 实例对应的接口对象 $user = new \WeChat\User($config); // 调用接口对象方法 $list = $user->getUserList(); // 处理返回的结果 echo ''; var_export($list); } catch (Exception $e) { // 出错啦，处理下吧 echo $e->getMessage() . PHP_EOL; } ``` 微信支付 ---- [](#微信支付) ``` // 创建接口实例 $wechat = new \WeChat\Pay($config); // 组装参数，可以参考官方商户文档 $options = [ 'body' => '测试商品', 'out_trade_no' => time(), 'total_fee' => '1', 'openid' => 'o38gpszoJoC9oJYz3UHHf6bEp0Lo', 'trade_type' => 'JSAPI', 'notify_url' => 'http://a.com/text.html', 'spbill_create_ip' => '127.0.0.1', ]; try { // 生成预支付码 $result = $wechat->createOrder($options); // 创建JSAPI参数签名 $options = $wechat->createParamsForJsApi($result['prepay_id']); // @todo 把 $options 传到前端用js发起支付就可以了 } catch (Exception $e) { // 出错啦，处理下吧 echo $e->getMessage() . PHP_EOL; } ``` - 更多功能请阅读测试代码或SDK封装源码 支付宝支付 ----- [](#支付宝支付) - 支付参数配置（可用沙箱模式） ``` $config = [ // 沙箱模式 'debug' => true, // 签名类型 ( RSA|RSA2 ) 'sign_type' => 'RSA2', // 应用ID 'appid' => '2021000122667306', // 应用私钥内容 ( 需1行填写，特别注意：这里的应用私钥通常由支付宝密钥管理工具生成 ) 'private_key' => 'MIIEowIBAAKCAQEAn...', // 公钥模式，支付宝公钥内容 ( 需1行填写，特别注意：这里不是应用公钥而是支付宝公钥，通常是上传应用公钥换取支付宝公钥，在网页可以复制 ) 'public_key' => '', // 证书模式，应用公钥证书路径 ( 新版资金类接口转 app_cert_sn，如文件 appCertPublicKey.crt ) 'app_cert_path' => __DIR__ . '/alipay/appPublicCert.crt', // 'app_cert' => '证书内容', // 证书模式，支付宝根证书路径 ( 新版资金类接口转 alipay_root_cert_sn，如文件 alipayRootCert.crt ) 'alipay_root_path' => __DIR__ . '/alipay/alipayRootCert.crt', // 'root_cert' => '证书内容', // 证书模式，支付宝公钥证书路径 ( 未填写 public_key 时启用此参数，如文件 alipayPublicCert.crt ) 'alipay_cert_path' => __DIR__ . '/alipay/alipayPublicCert.crt', // 'public_key' => '证书内容' // 支付成功通知地址 'notify_url' => '', // 网页支付回跳地址 'return_url' => '', ]; ``` - 支付宝发起PC网站支付 ``` // 参考公共参数 https://docs.open.alipay.com/203/107090/ $config['notify_url'] = 'http://pay.thinkadmin.top/test/alipay-notify.php'; $config['return_url'] = 'http://pay.thinkadmin.top/test/alipay-success.php'; try { // 实例支付对象 $pay = We::AliPayWeb($config); // $pay = new \AliPay\Web($config); // 参考链接：https://docs.open.alipay.com/api_1/alipay.trade.page.pay $result = $pay->apply([ 'out_trade_no' => time(), // 商户订单号 'total_amount' => '1', // 支付金额 'subject' => '支付订单描述', // 支付订单描述 ]); echo $result; // 直接输出HTML（提交表单跳转) } catch (Exception $e) { // 异常处理 echo $e->getMessage(); } ``` - 支付宝发起手机网站支付 ``` // 参考公共参数 https://docs.open.alipay.com/203/107090/ $config['notify_url'] = 'http://pay.thinkadmin.top/test/alipay-notify.php'; $config['return_url'] = 'http://pay.thinkadmin.top/test/alipay-success.php'; try { // 实例支付对象 $pay = We::AliPayWap($config); // $pay = new \AliPay\Wap($config); // 参考链接：https://docs.open.alipay.com/api_1/alipay.trade.wap.pay $result = $pay->apply([ 'out_trade_no' => time(), // 商户订单号 'total_amount' => '1', // 支付金额 'subject' => '支付订单描述', // 支付订单描述 ]); echo $result; // 直接输出HTML（提交表单跳转) } catch (Exception $e) { // 异常处理 echo $e->getMessage(); } ``` - 更多功能请阅读测试代码或SDK封装源码 版权说明 ---- [](#版权说明) **WeChatDeveloper** 遵循 **MIT** 开源协议发布，并免费提供使用。 本项目包含的第三方源码和二进制文件的版权信息将另行标注，请在对应文件查看。 版权所有 Copyright © 2014-2023 by ThinkAdmin () All rights reserved。 赞助打赏，请作者喝杯茶 ~ ------------- [](#赞助打赏请作者喝杯茶-) [![赞助](https://camo.githubusercontent.com/0903408743474715a53981798ca8fe04d750c26c13631b40a2c24f81acc8826e/68747470733a2f2f646f632e7468696e6b61646d696e2e746f702f7374617469632f696d672f7061792e706e67)](https://camo.githubusercontent.com/0903408743474715a53981798ca8fe04d750c26c13631b40a2c24f81acc8826e/68747470733a2f2f646f632e7468696e6b61646d696e2e746f702f7374617469632f696d672f7061792e706e67) ### Health Score 14 — LowBetter than 1% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity3 Limited adoption so far Community7 Small or concentrated contributor base Maturity22 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure 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. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/34025703?v=4)[lxy12](/maintainers/lxy12)[@lxy12](https://github.com/lxy12) --- Top Contributors [![lxy12](https://avatars.githubusercontent.com/u/34025703?v=4)](https://github.com/lxy12 "lxy12 (3 commits)") ### Embed Badge ![Health badge](/badges/sunnyli-wechat-developer/health.svg) ``` [![Health](https://phpackages.com/badges/sunnyli-wechat-developer/health.svg)](https://phpackages.com/packages/sunnyli-wechat-developer) ``` ### Alternatives [msilabs/bkash bKash Payment Gateway API for Laravel Framework. 181.2k](/packages/msilabs-bkash) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)