## 一、介紹 * 環境：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('生成訂單錯誤！'); } ~~~ ## 四、渲染頁面 這里創建了訂單，需要生成二維碼圖片，可以參考一下這個[二維碼圖片](https://github.com/SimpleSoftwareIO/simple-qrcode)組件。 #### 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->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’)，你應該更新你的訂單為支付失敗，但是要告訴微信處理完成。 ## 后記 1.在微信開發中，大量用到了laravel自帶的Log查錯的方法，當var\_dump(),echo(),dd()等方法不能查看錯誤信息是，使用日志查錯就可以解決了。怎樣使用laravel的log服務，這個以后會講。 2.本項目開發可以說是組件化開發，有開發速度快，代碼質量高，維護成本低等優點，本例的微信開發是一個縮影。 3.再見。