微信公众平台开发[4] —— ThinkPHP 框架下微信支付

版权声明：本文为博主原创文章，未经博主允许不得转载。 https://cloud.tencent.com/developer/article/1333668

【声明】：

• 原文主要摘自 白俊遥博客 ，部分内容针对个人事例已作修改，主要用于自己的参考，欢迎指正。
• 注意：微信公众号支付，强烈建议使用外网可访问的链接测试，否则即便代码正确也无法调出支付界面，可使用草料二维码生成可扫描图片，也可直接在微信中输入网址。
• 使用框架：ThinkPHP 3.2.3

一.微信公众平台信息配置

1).进入微信公众平台

• 由左侧的“微信支付”进入配置界面，添加或修改正确的支付授权目录
• 注意该目录的要求，多建议精确到上一级目录，并加斜线 /

2).授权域名

• 【注意】: 域名的确定都是工信部备案过的
• 初次开发的很容易漏掉 “www” ,而截图中不加 “www” 是因为我们备案的原因，记得只去掉 “http://”

二.ThinkPHP框架，相应代码配置

• 公众号支付->场景参考

1).weixinpay.php文件处理

• 导入 weixinpay.php 文件到 “/ThinkPHP/Library/Vendor/Weixinpay/” 目录下

2).配置

• 在项目的配置文件中，添加类此如下的代码，其中的值需要自己根据实际公众号的信息进行配置 【注意】： 很多人会搞错 MCHID 而造成不必要的时间浪费，具体开发参照官方文档。
• 文件目录：/Application/Common/Conf/config.php

'WEIXINPAY_CONFIG'  => array(
        'APPID'              => 'wxdxxxxxxx89', // 公众号APPID 微信支付APPID
        'MCHID'              => '1xxxxxxx2', // 微信支付MCHID 商户收款账号
        'KEY'                => 'MCxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxlW', // 微信支付KEY
        'APPSECRET'          => 'exxxxxxxxxxxxxxxxxxxxxxxxx7', // 公众帐号secert (公众号支付专用)
        'NOTIFY_URL'         => 'http://www.xxx.com/m/cartpay/notify_wx', // 接收支付状态的连接
        'TOKEN'             => 'zmxxx',//公众号设置的token值
    ),

3).支付函数的编辑

• 即进行点击支付后的界面，其自动调用微信的默认支付框架

• 【注意】： 进行支付逻辑的处理，一定要记住，要求使用 GET 方式请求此页面 即使用 get 方式将总金额、订单号提交过来进行处理，$data 可以接收

4).getParameters修改

• 上述文件，需要修改其中的 getParameters() 方法，其中标记的位置，是根据实际的业务情况而从数据库获取的,具体代码后面会有提供。

5).上述函数，需要html的配合

• html 文件：/M/View/Cart/pay.html

6).回调函数的编辑

【提示】:

1. 该路径必须要与配置文件中的回调路径一致
2. 个人测试发现，此处 session 和 cookie 的设置都失效，仅做参考
3. 建议逻辑处理类不要做多余的初始化、构造方法的判断，容易造成回调失灵

• 此回调函数，是根据微信是否真正完成支付后的数据更新，一般此处进行订单状态的修改，比如，我在此处异步执行的是将订单号的支付状态参数 由 0 置为 1.

【注意】：

1. 先前发现，因为微信服务的设计，会多次回调 `notify()` 以判断是否真正的支付成功，而简单的update操作是无法检测的。
2. 为了同自己的平台相关联，同理需要进行状态的判断，否则不可避免的会多次执行 `notify_wx()` 中的逻辑处理\*\*

7).增加 curl_get_contents()

• 如果是整合到自己的项目中则需要在自己的公共函数中增加 curl_get_contents()

8).补充：

提醒：

• 所提供的源代码，剥离出了微信支付的核心，注意 html 页面中对 jQuery.js 的正确引用，pay.html 基本是从微信公众号官网直接下载的 demo 页，同时使用代码前请配置微信支付url,且外网测试。
• 此功能开发中所遇到的各种坑！【强烈建议参考、批评】

三.微信扫码支付

1).场景分析

场景参考

• 一般的网站开发中,如果是手机端，多数使用上面提到的公众号支付方式，而扫码支付多数出现在PC端，当然也有部分手机网站有生成二维码的需求
• 但是由于微信浏览器的识别限制，一种情况是直接在微信端浏览的购物网站，通过长按二维码就可以识别；另一种情况是在另外的手机端浏览器，比如百度、头条。
• 如此一来除非用另一部手机进行扫码支付，或者将二维码截图保存后，再到微信中找到图片进行长按识别。显然后者用法过于繁琐，所以处分针对于微信浏览器开发，否则不建议使用扫码支付功能，而在PC端开发则适合使用该功能

2).功能开发

• 通用上文中介绍的功能开发步骤1)、2)、3)、6)、7)

3).补充函数

• 在 common/function.php 中补充函数 weixinpay() 和 qrcode()

4).设计显示微信扫码的页面

• 我定的页面为 M/Order/mobilepayment.html,即通过访问Order/wechatpaymenter
• 同时调用微信生成二维码，在该页面的 <img> 标签中显示出来，具体代码见后面的附录

5).补充 wechatpaymenter()方法。

6).注意：

• 模式二生成的二维码也是有时间限制的，同时，不能有权限拦截，并且，二维码的生成是根据订单号唯一确定的，如果生成一次，那么很可能第二次就不显示，建议可用 time()代替测试。
• 扫码支付模式参考

7).运行结果截图

• 在信息配置正确的情况下，功能结果如图所示

四.附录

1. 源代码参考 >>>

2. 提醒：

1. 注意微信配置的正确性，如果有误，微信支付会有报错，二维码则会无法生成.
2. 多参考官方文档加深理解也是不错的选择.
3. 微信官方支付Demo的使用，可参考文章 微信公众平台开发[3] —— 微信公众号支付功能