Laravel 微信開發組件-WeChat 微信支付


一、介紹

本教程是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::class 至 config/app.php 的 providers 數組里.

添加 Aliases

最后,注冊 'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::class 至 config/app.php 的 aliases 數組里.

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->totalfee 或者 $notify['totalfee']。 
$successful 這個參數其實就是判斷 用戶是否付款成功了(result_code == ‘SUCCESS’)

3.該函數返回值就是告訴微信 “我是否處理完成”,如果你返回一個 false 或者一個具體的錯誤消息,那么微信會在稍后再次繼續通知你,直到你明確的告訴它:“我已經處理完成了”,在函數里 return true; 代表處理完成。

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

5.注意:請把 “支付成功與否” 與 “是否處理完成” 分開,它倆沒有必然關系。 
比如:微信通知你用戶支付完成,但是支付失敗了(result_code 為 ‘FAIL’),你應該更新你的訂單為支付失敗,但是要告訴微信處理完成。

后記

1.在微信開發中,大量用到了laravel自帶的Log查錯的方法,當var_dump(),echo(),dd()等方法不能查看錯誤信息是,使用日志查錯就可以解決了。怎樣使用laravel的log服務,這個以后會講。 
2.本項目開發可以說是組件化開發,有開發速度快,代碼質量高,維護成本低等優點,本例的微信開發是一個縮影。

[原文地址](http://www.blog8090.com/)


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM