[教程] 基于 Laravel5.1 LTS 版的微信开发

一、介绍

本教程是lamp开发环境下基于larvel5.1LTS版进行的开发实例。
由于现在国内有很多优秀且具备开源精神的php开发者,因此出于节约时间成本和维护成本的考虑,微信开发采用组件化开发,我们没必要重复造轮子。本教程采用 overtrue 团队的 easywechat 组件进行微信的支付功能开发和实现。

二、composer安装

默认大家已经在自己的开发环境上已经安装了composer,并会一些简单的操作,安装命令:

composer require "overtrue/laravel-wechat:~3.0"

如果你用了 laravel-debugbar,请禁用或者关掉,否则这模块别想正常使用!!! (但是composer提示是否可以关闭x-debug,会影响安装之类的提示,可以不去管它)

三、在laravel中进行配置

1.注册 ServiceProvider (找到 config/app.php 配置文件中,key为 providers 的数组,在数组中添加服务提供者):

Overtrue\LaravelWechat\ServiceProvider::class,

2.(可选)添加 外观 在app/config/app.php 的 aliases 数组里,添加 别名 :

    'wechat' =>Overtrue\LaravelWechat\ServiceProvider::class,

3.创建配置文件(在项目根目录中运行 artisan 命令,发布配置文件到你的项目中):

         php artisan vendor:publish

此时在/config目录下会生成配置文件wechat.php,在里面输入你的微信商家信息,这里请注意保护隐私。

四、 微信支付飞起

1.配置微信商家信息,laravel根目录下的.ENV文件支持以下配置:

WECHAT_APPID
WECHAT_SECRET
WECHAT_TOKEN
WECHAT_AES_KEY

WECHAT_LOG_LEVEL
WECHAT_LOG_FILE

WECHAT_OAUTH_SCOPES
WECHAT_OAUTH_CALLBACK

WECHAT_PAYMENT_MERCHANT_ID
WECHAT_PAYMENT_KEY
WECHAT_PAYMENT_CERT_PATH
WECHAT_PAYMENT_KEY_PATH
WECHAT_PAYMENT_DEVICE_INFO
WECHAT_PAYMENT_SUB_APP_ID
WECHAT_PAYMENT_SUB_MERCHANT_ID
WECHAT_ENABLE_MOCK

你可以在/config/wechat.php中进行相关参数配置,也可以写在.ENV文件中,然后,wechat.php具体读取方法:

'notify_url' => env('NOTIFY_URL', 'http://www.XXXXX.com/notify_url'),  // 回调地址

env()默认读取.env文件中常量的值,如果.env中没有定义该常量,则返回env()的第二个参数的值。

2.wechat.php文件中需要注意的地方

(1).'log'数组内是日志配置。
(2).'payment'数组是主要配置的数组,主要配置商户的信息和证书。

3.(重点)创建订单

(1).引入命名空间

use EasyWeChat\Foundation\Application;
use EasyWeChat\Payment\Order;

(2).填写订单信息

$attributes = [
    'trade_type'       => 'JSAPI', // JSAPI,NATIVE,APP...
    'body'             => 'iPad mini 16G 白色',
    'detail'           => 'iPad mini 16G 白色',
    'out_trade_no'     => '1217752501201407033233368018',
    'total_fee'        => 5388,
    'notify_url'       => 'http://xxx.com/order-notify', // 支付结果通知网址,如果不设置则会使用配置里的默认地址,我就没有在这里配,因为在.env内已经配置了。
    // ...
];
// 创建订单
 $order = new Order($attributes);
 $result = $payment->prepare($order);
 if ($result->return_code == 'SUCCESS' && $result->result_code == 'SUCCESS')
 {
   //生产那个订单后的逻辑
     \Log::info('生成订单号..'.$data->order_guid);
     //这一块是以ajax形式返回到页面上。   
     //用户的体验就是点击【确认支付】,验证码以弹层页面出来了(没错,还需要一个好用的弹层js)。
     $ajax_data=[
         'html'         =>   json_encode(\QrCode::size(250)->generate($result['code_url'])),
         'out_trade_no' =>  $data->order_guid,
         'price'        =>  $data->price
     ];
     return $ajax_data;
 }else{
     return back()->withErrors('生成订单错误!');
 }

四、渲染页面

这里创建了订单,需要生成二维码图片,可以参考一下这个二维码图片组件。

Composer 设置

首先,添加 QrCode 包添加到你的 composer.json 文件的 require 里:

composer require "simplesoftwareio/simple-qrcode"

添加 Service Provider

注册 SimpleSoftwareIO\QrCode\QrCodeServiceProvider::classconfig/app.phpproviders 数组里.

添加 Aliases

最后,注册 'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::classconfig/app.phpaliases 数组里.

pay.blade.php内容

<script type="text/javascript" src="{{ asset('vendor/jquery.js') }}"></script>
<script type="text/javascript" src="{{ asset('layer/layer.js') }}"></script>
<input  class="wechat_btn" type="button" value="确认支付"/>
 {!-- 这个页面需要有一些js代码,才能使支付功能更加美观可用无bug,比如ajax轮询,点击支付后的btn失效,放弃支付时关闭弹层等等 --}

js内容

$('.wechat_btn').click(function() {
    $('.my_order_guid').val('');
    $('#code').val('');
    //ajax生成二维码
    data={
        '_token':$(".token").val(),//令牌
        'money':$(".money").val(),//商品价格
    }
    sendAjax(data, "/order", function (data) {
        //发送二维码过来(此处使用优美的layer弹层库)
        layer.open({
            type: 1,
            title:'微信支付',
            skin: 'layui-layer-rim', //加上边框
            area: ['270px', '340px'], //宽高
            content: "<p style='color:red;text-align: center;'>支付金额:"+data['price']
            +"元</p> <input type='hidden' class='my_order_guid' value='"+data['out_trade_no']
            +"'/><div id='code' style='text-align: center;'>"+JSON.parse(data['html'])+
            "</div><p style='text-align: center;'>请使用微信扫码支付</p><script> $('.layui-layer-close').click(function() { layer.msg('您已放弃本次支付');setTimeout('window.location.reload()',3000); });</script>"
               //这里我把弹层库有关的一点点js写到content里面去了。
        });

         getInfo();
        //这里写一个轮询,可以异步查询订单是否支付完成的信息,从而进行逻辑处理(比如轮询支付状态,成功了跳转页面),仅仅提点一下我的想法,轮询的代码不用找,没有贴。

    });

});

五、回调函数

先放上主要代码再说:

public function notifyUrl(Request $request)
    {
        $app = new Application(config('wechat'));
        $response = $app->payment->handleNotify(function($notify, $successful){
            if ($successful) {
                $order_arr=json_decode($notify,true);
                $order_guid=$order_arr['out_trade_no'];//订单号
                //回调成功的逻辑
             }
        });
    }

注意

(1).wechat发送回调是通过post方式,在路由处定义了之后,还需要在laravel项目中排除token验证,我建议在中间件中VerifyCsrfToken.php进行排除路由。

protected $except = [
//
'/pay_success_notify',
'/To_rule_out_route'
];

(2). 重点!重点!重点! 回调这里的处理可以说是重中之重,这里出岔子,可能会造成
用户支付成功后,微信的 回调没有进来 ,后台回调的逻辑就没有执行,导致用户钱花了,东西没买上(即你的服务器上没有执行给付费用户修改支付状态等数据库操作)。另一种后果,如果没有正确返回微信参数,微信会多次发送回调信息来提醒你支付成功了,导致你的服务器 接受回调函数多遍 。而此时你也马马虎虎,没有在支付成功的逻辑上对用户的支付状态进行判断,导致逻辑用户充一次钱,在数据库却重复执行了好几次相关数据库操作。前者坑了付费用户,后者坑了你的公司,这里如果不注意的话,后果只会很严重,涉及到钱的地方要倍加小心。
(2).在回调路由指向的方法内,如果你的支付成功的逻辑成功运行了,需要return true;如果没有成功进行数据库操作,需要返回false;或不返回,微信会再一次发送回调信息(post方式)。

六、一些easywechat官方的建议:

这里需要注意的有几个点:

1.handleNotify 只接收一个 callable 参数,通常用一个匿名函数即可。

2.该匿名函数接收两个参数,这两个参数分别为:
$notify 为封装了通知信息的 EasyWeChat\Support\Collection 对象,前面已经讲过这里就不赘述了,你可以以对象或者数组形式来读取通知内容,比如:$notify->total_fee 或者 $notify['total_fee']。
$successful 这个参数其实就是判断 用户是否付款成功了(result_code == ‘SUCCESS’)

3.该函数返回值就是告诉微信 “我是否处理完成”,如果你返回一个 false 或者一个具体的错误消息,那么微信会在稍后再次继续通知你,直到你明确的告诉它:“我已经处理完成了”,在函数里 return true; 代表处理完成。

4.handleNotify 返回值 $response 是一个 Response 对象,如果你要直接输出,使用 $response->send(), 在一些框架里不是输出而是返回:return $response。

5.注意:请把 “支付成功与否” 与 “是否处理完成” 分开,它俩没有必然关系。
比如:微信通知你用户支付完成,但是支付失败了(result_code 为 ‘FAIL’),你应该更新你的订单为支付失败,但是要告诉微信处理完成。

七、附录(微信官方API的关键参数解析)

通知参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 return_code String(16) SUCCESS

SUCCESS/FAIL

此字段是通信标识,非交易标识,交易是否成功需要查看result_code来判断

返回信息 return_msg String(128) 签名失败

返回信息,如非空,为错误原因

签名失败

参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回

字段名 变量名 必填 类型 示例值 描述
公众账号ID appid String(32) wx8888888888888888 微信分配的公众账号ID(企业号corpid即为此appId)
商户号 mch_id String(32) 1900000109 微信支付分配的商户号
设备号 device_info String(32) 013467007045764 微信支付分配的终端设备号,
随机字符串 nonce_str String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串,不长于32位
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名,详见签名算法
业务结果 result_code String(16) SUCCESS SUCCESS/FAIL
错误代码 err_code String(32) SYSTEMERROR 错误返回的信息描述
错误代码描述 err_code_des String(128) 系统错误 错误返回的信息描述
用户标识 openid String(128) wxd930ea5d5a258f4f 用户在商户appid下的唯一标识
是否关注公众账号 is_subscribe String(1) Y 用户是否关注公众账号,Y-关注,N-未关注,仅在公众账号类型支付有效
交易类型 trade_type String(16) JSAPI JSAPI、NATIVE、APP
付款银行 bank_type String(16) CMC 银行类型,采用字符串类型的银行标识,银行类型见银行列表
订单金额 total_fee Int 100 订单总金额,单位为分
应结订单金额 settlement_total_fee Int 100 应结订单金额=订单金额-非充值代金券金额,应结订单金额<=订单金额。
货币种类 fee_type String(8) CNY 货币类型,符合ISO4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型
现金支付金额 cash_fee Int 100 现金支付金额订单现金支付金额,详见支付金额
现金支付货币类型 cash_fee_type String(16) CNY 货币类型,符合ISO4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型
代金券金额 coupon_fee Int 10 代金券金额<=订单金额,订单金额-代金券金额=现金支付金额,详见支付金额
代金券使用数量 coupon_count Int 1 代金券使用数量
代金券类型 coupon_type_$n Int CASH

CASH--充值代金券

NO_CASH---非充值代金券

订单使用代金券时有返回(取值:CASH、NO_CASH)。$n为下标,从0开始编号,举例:coupon_type_0

代金券ID coupon_id_$n String(20) 10000 代金券ID,$n为下标,从0开始编号
单个代金券支付金额 coupon_fee_$n Int 100 单个代金券支付金额,$n为下标,从0开始编号
微信支付订单号 transaction_id String(32) 1217752501201407033233368018 微信支付订单号
商户订单号 out_trade_no String(32) 1212321211201407033568112322 商户系统的订单号,与请求一致。
商家数据包 attach String(128) 123456 商家数据包,原样返回
支付完成时间 time_end String(14) 20141030133525 支付完成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则

后记

1.在微信开发中,大量用到了laravel自带的Log查错的方法,当var_dump(),echo(),dd()等方法不能查看错误信息是,使用日志查错就可以解决了。怎样使用laravel的log服务,这个以后会讲。
2.本项目开发可以说是组件化开发,有开发速度快,代码质量高,维护成本低等优点,本例的微信开发是一个缩影。
3.再见。

是非之外有一座花园,我们会在那里相遇
本帖已被设为精华帖!
本帖由系统于 5年前 自动加精
Martist
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
讨论数量: 15

@overtrue 安总,意见来了

7年前 评论

@小能手马闯set 不错,赞!

@Crny 你语文还需要补习,哈哈,是“官方给的建议”,不是 “给官方的建议” :laughing:

7年前 评论

@overtrue 我是省略式

7年前 评论
Martist

@overtrue 班门弄斧了,谢谢激励

7年前 评论

谢谢分享。支付流程中,前端能有些示例么。还有JSSDK相关的细节

7年前 评论
Martist

@乌龙球 有时间再开一篇。

7年前 评论
Martist

@乌龙球 补全了

7年前 评论

文中的 $data 变量是如何来的?

6年前 评论
幽弥狂

@Hanccc 我也没找到。。
@小能手马闯set 同问

6年前 评论

一直出现签名错误,百度了一下说可能是中文编码的问题,我想确认一下EasyWechat在最终向微信发起prepare()的时候会转码吗?

6年前 评论

请问收到success的时候可以利用openid发信息给客户吗?

6年前 评论

JSAPI支付必须传openid

6年前 评论
ThinkQ

$data怎么来的呀?

5年前 评论

创建订单里的 $payment 是怎么来的?我这报错未定义呀。。。

3年前 评论
Martist

@ThinkCsly @chenhaoge @wxuns 四年前写的文章了,,兄弟们看些新的博文吧

3年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!