Laravel 支付解决方案之如何使用微信支付进行支付

Laravel中使用微信支付

前两节我们陆续讲了在Laravel中如何使用支付宝和银联支付进行支付,这一节我们来探讨另一种时下热门的支付方式——微信支付。说来也是,微信那么多用户,微信推出来的支付工具用的人自然不少,尤其是微信红包对微信支付的推广更是起到至关重要的作用。正因如此许多网站和App都添加了对微信支付的支持。

Laravel作为全世界最流行的PHP框架,在国内也是拥有许多拥趸,也就自然不乏对微信支付的支持,当然和支付宝、银联支付一样也是通过第三方的扩展包来实现,不过这一次,不是基于OmniPay,因为OmniPay中貌似并没有对微信支付提供网关接口,但是没关系,轮子总是有人造的(目前已提供对微信支付支持:Omnipay-WeChat),目前GitHub上在Laravel中封装微信SDK的项目不在少数,其中最流行的当属overture开发的laravel-wechathuanghua581开发的laravel-wechat-sdk。当然overture还开发了独立于框架的Wechat,laravel-wechat正是基于该项目进行开发。

本节我们就使用laravel-wechat包对微信支付做一简单使用示例。

1、安装依赖包

在项目根目录下运行如下命令安装依赖:

composer require overtrue/laravel-wechat 2.1.*

安装完成后在config/app.php中注册服务提供者:

Overtrue\LaravelWechat\ServiceProvider::class

如果你想在代码中通过WeChat门面,可以将其添加到config/app.phpaliases数组中:

'Wechat' => Overtrue\LaravelWechat\Facade::class

2、配置微信公众号设置

完成上述操作后,运行如下命令发布配置文件到config目录:

php artisan vendor:publish

运行成功后编辑config/wechat.php文件:

<?php
return [
    'use_alias' => env('WECHAT_USE_ALIAS', false),
    'app_id' => env('WECHAT_APPID', 'Your AppId'), // 必填
    'secret' => env('WECHAT_SECRET', 'Your Secret'), // 必填
    'token' => env('WECHAT_TOKEN', 'Your Token'), // 必填
    'encoding_key' => env('WECHAT_ENCODING_KEY', 'Your Encoding AES Key') // 只有加密模式需要
];

将你的微信公众号的相关信息填写到对应配置,需要注意的是如果要使用微信支付功能,需要经过认证的公众号,且目前微信公众平台测试账号不支持支付接口。

使用微信支付前,需要先到微信公众平台配置好授权目录、测试账号等信息。 微信支付开发文档可参考:https://pay.weixin.qq.com/wiki/doc/api/index.html

3、使用示例

注:Laravel 5 默认启用了 CSRF 中间件,因为微信的消息是 POST 过来,所以会触发 CSRF 检查导致无法正确响应消息,所以可以在CSRF验证中排除指定URL。具体可参考:Laravel中如何从CSRF中排除指定URL

PHP

<?php

use Overtrue\Wechat\Payment;
use Overtrue\Wechat\Payment\Order;
use Overtrue\Wechat\Payment\Business;
use Overtrue\Wechat\Payment\UnifiedOrder;

/**
 * 第 1 步:定义商户
 */
$business = new Business(
    APP_ID,
    APP_KEY,
    MCH_ID,
    MCH_KEY
);

/**
 * 第 2 步:定义订单
 */
$order = new Order();
$order->body = 'test body';
$order->out_trade_no = md5(uniqid().microtime());
$order->total_fee = '1'; // 单位为 “分”, 字符串类型
$order->openid = OPEN_ID;
$order->notify_url = 'http://xxx.com/wechat/payment/notify';

/**
 * 第 3 步:统一下单
 */
$unifiedOrder = new UnifiedOrder($business, $order);

/**
 * 第 4 步:生成支付配置文件
 */
$payment = new Payment($unifiedOrder);

Javascript

var WXPayment = function() {
    if( typeof WeixinJSBridge === 'undefined' ) {
        alert('请在微信在打开页面!');
        return false;
    }
    WeixinJSBridge.invoke(
        'getBrandWCPayRequest', <?php echo $payment->getConfig(); ?>, function(res) {
            switch(res.err_msg) {
                case 'get_brand_wcpay_request:cancel':
                    alert('用户取消支付!');
                    break;
                case 'get_brand_wcpay_request:fail':
                    alert('支付失败!('+res.err_desc+')');
                    break;
                case 'get_brand_wcpay_request:ok':
                    alert('支付成功!');
                    break;
                default:
                    alert(JSON.stringify(res));
                    break;
            }
        }
    );
}

HTML

<button type="button" onclick="WXPayment()">
    支付 ¥<?php echo ($order->total_fee / 100); ?> 元
</button>

支付通知

<?php

use Overtrue\Wechat\Payment\Notify;

$notify = new Notify(
    APP_ID,
    APP_KEY,
    MCH_ID,
    MCH_KEY
);

$transaction = $notify->verify();

if (!$transaction) {
    $notify->reply('FAIL', 'verify transaction error');
}

// var_dump($transaction);

echo $notify->reply();

4、在Lumen中使用

此外,laravel-wechat还支持Lumen。使用Composer安装完laravel-wechat后需要在bootstrap/app.php中82行左右添加这一行代码:

$app->register(Overtrue\LaravelWechat\ServiceProvider::class);

同时在ENV中配置以下选项:

WECHAT_USE_ALIAS=false
WECHAT_APPID=xxx
WECHAT_SECRET=xxx
WECHAT_TOKEN=xxx
WECHAT_ENCODING_KEY=xxx

如果你习惯使用 config/wechat.php 来配置的话,请记得在 bootstrap/app.php 中19行以后添加:

$app->configure('wechat');

当然,除此之外,laravel-wechat还提供了更多微信SDK支持,具体请参考:https://github.com/overtrue/wechat/wiki

学院君

学院君 has written 550 articles

资深PHP工程师,Laravel学院院长