一、介紹
本教程是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/)