## 一、介紹
* 環境: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.再見。
- 簡介
- 前端
- html
- css
- css選擇器
- fiex布局
- 盒裝模型
- javascript
- 原型鏈
- 作用域
- 事件綁定
- dom
- bom
- jquery
- 選擇器
- jquery事件綁定
- layui
- bootstrap
- vue
- 路由(Vue Router)
- Vue CLI
- axios
- vant
- 打包部署
- 自定義組件
- 一些前端效果
- 點擊復制功能
- 后端
- php框架
- thinkphp
- 隱藏index.php
- thinkphp實現多表查詢
- thinkphp使用ajax單圖上傳
- thinkphp使用ajax圖集上傳
- thinkphp使用ajax查詢是否重名
- thinkphp使用ajax表單上傳
- where多個條件
- 郵件發送功能
- thinkphp短信寶發送短信
- tp5事務
- validate驗證二維數組
- yii2
- yii配置郵件
- yii的CRUD操作
- layui中兩種展示表單的方式
- laravel
- laravel實例
- laravel登錄
- laravel前端注冊
- laravel列表
- laravel刪除
- laravel編輯
- laravel新增
- Laravel 目錄結構
- Laravel 路由
- Laravel 控制器
- Laravel 模型讀操作
- Laravel 模型增、刪、改操作
- Laravel 中間件
- Laravel 視圖
- Laravel ,YII,thinkphp 框架的區別
- 會話控制
- session
- session存入redis
- session創建
- session刪除
- cookie
- 面向對象
- 三大特性
- 魔術方法
- 修飾符
- obj變量
- php
- php版本差異
- php7與php5的區別
- PHP 內存溢出問題
- 數據類型
- PHP 垃圾回收機制(GC)
- 文件目錄操作
- php函數
- 字符串相關函數
- 數組相關函數
- 超全局數組與超全局變量
- php魔術方法
- 引用變量
- php類庫
- 1.根據隨機數生成6位密鑰
- 2.獲取客戶端IP地址
- 3.多維數組變成一維數組
- 4.判斷是否是微信瀏覽器
- 5.判斷是否是移動端
- 6.隱藏手機號碼156***8956
- 7.隱藏郵箱 9533*****@qq.com
- 8.數組排序
- 9.添加操作日志
- 10.無線分類按子分類排序
- 11.從數組中刪除空白的元素
- 12.字符串相關類庫
- curl模擬post/get請求
- 替換中間四位數
- PHP地理位置計算
- 生成唯一訂單號
- 阿拉伯數字轉化為大寫
- 時間戳轉為中文時間
- php獲取本年、本月、本周時間戳和日期格式的實例代碼(分析)
- 去除數據庫的數據空格
- 壓縮Zip文件和文件打包下載
- PHP常用六大設計模式
- 單例模式
- 工廠模式
- 注冊樹模式
- 策略模式
- 適配器模式
- 觀察者模式
- 數據庫
- 留言板功能
- 所了解的數據庫
- sql server
- Memecached
- MongoDB
- mysql
- 存儲引擎(MyISAM與InnoDB)
- 庫表CRUD操作
- 索引
- 事務
- mysql常用命令
- 悲觀鎖和樂觀鎖
- 數據庫優化
- 大流量大并發優化
- Redis
- redis相關考點
- 開啟redis
- redis緩存cache
- redis存儲session
- redis限制提交次數
- 緩存雪崩,擊穿,穿透(copy)
- redis數據結構及使用場景
- 消息隊列
- Redis、Memecached 區別?
- phpstudy升級mysql版本
- 分表
- 讀寫分離
- linux
- 開發環境搭建
- mysql配置
- centos7(lnmp)環境搭建
- ubuntu(lnmp)環境搭建
- Nginx
- nginx四個基本功能
- nginx重啟出錯
- Nginx 的反向代理
- 用戶用戶組
- 虛擬機安裝
- linux常用命令
- chmod命令
- ubuntu下apt-get 命令
- 釋放內存
- 云鎖安裝及使用
- 大部隊搭建
- Centos開啟端口命令
- Centos禁止root登錄
- Centos7修改22端口
- Rsync備份
- 開啟端口
- 微信開發
- 輔助開發
- 網站SEO
- TCP/IP協議
- HTTP 請求全過程
- http狀態碼
- http和https的區別
- http請求三部分
- tcp三次握手
- 三次握手的作用
- tcp四次揮手
- CMS
- 織夢CMS
- 帝國cms
- wordpress
- 禪知cms
- 八大接口
- 微信支付
- 支付寶支付
- 郵件
- 微博登錄
- QQ登錄
- 快遞
- 天氣
- 常見算法
- 快速排序
- 冒泡排序
- 選擇排序
- 插入排序
- 二分查找
- 希爾排序
- V2Ray搭建
- AJAX
- GIT
- RBAC用戶權限管理數據庫設計
- 開發中遇到的一些問題
- 資料購買
- 建立ssr服務器
- 簡單建
- 申請并使用ssl證書
- 正則表達式手冊
- phpstorm
- 注冊碼
- 備用注冊碼
- 網站設計概要
- 網站相關功能代碼
- 權限(RBAC/AUTH)
- 無限級分類
- 記住登錄狀態
- email找回密碼
- 企業網站開發概要
- 網站后臺
- 文章管理
- 欄目管理 CRUD 上級欄目
- 欄目管理
- 友情鏈接
- 操作日志
- 登錄注冊
- 權限管理
- 網站配置
- 網站前臺
- 首頁
- 新聞動態
- 聯系
- 案例
- 關于
- 單店鋪商城開發概要
- 面試準備
- 有意思的面試題
- 拉鉤面試要求
- 慕課面試視頻知識總結
- 面試題匯總
- 題目1
- 一些工作的要求
- 前端炒的
- 面試項目介紹
- MySQL面試100 問
- 術語庫
- redis相關
- php操作redis
- redis消息隊列(異步)
- redis消息隊列(同步)