這篇文章主要為大家詳細介紹了PHP支付系統設計與典型案例,可以用作小型支付系統,也可以用做第三方應用接入開放平台時的支付流水系統,具有一定的參考價值,有興趣的小夥伴們可以參考一下
由於公司業務需要,花兩週時間實現了一個小型的支付系統,麻雀雖小五臟俱全,各種必須的模組如帳戶加鎖,事務性保證,流水對帳等都是有完整實現的,整個開發過程中有很多經驗積累,再加上在網上搜索了一下,大部分都是些研究性的論文,對實際使用價值不大,所以這次特意拿出來跟大家分享一下。
這個系統可以當作小型支付系統,也可以用做第三方應用接入開放平台時的支付流水系統。
原來的需求比較負責,我簡化一點說:
對每個應用,對外需要提供獲取餘額,支付設備,充值等介面
後台有程序,每月一號進行清算
帳戶可以被凍結
需要記錄每一次操作的流水,每天的流水都要和發起方進行對帳
針對上面的需求,我們設定如下資料庫:
CREATE TABLE `app_margin`.`tb_status` ( `appid` int(10) UNSIGNED NOT NULL, `freeze` int(10) NOT NULL DEFAULT 0, `create_time` datetime NOT NULL, `change_time` datetime NOT NULL, PRIMARY KEY (`appid`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE `app_margin`.`tb_account_earn` ( `appid` int(10) UNSIGNED NOT NULL, `create_time` datetime NOT NULL, `balance` bigint(20) NOT NULL, `change_time` datetime NOT NULL, `seqid` int(10) NOT NULL DEFAULT 500000000, PRIMARY KEY (`appid`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE `app_margin`.`tb_bill` ( `id` int AUTO_INCREMENT NOT NULL, `bill_id` int(10) NOT NULL, `amt` bigint(20) NOT NULL, `bill_info` text, `bill_user` char(128), `bill_time` datetime NOT NULL, `bill_type` int(10) NOT NULL, `bill_channel` int(10) NOT NULL, `bill_ret` int(10) NOT NULL, `appid` int(10) UNSIGNED NOT NULL, `old_balance` bigint(20) NOT NULL, `price_info` text, `src_ip` char(128), PRIMARY KEY (`id`), UNIQUE KEY `unique_bill` (`bill_id`,`bill_channel`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE `app_margin`.`tb_assign` ( `id` int AUTO_INCREMENT NOT NULL, `assign_time` datetime NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE `app_margin`.`tb_price` ( `name` char(128) NOT NULL, `price` int(10) NOT NULL, `info` text NOT NULL, PRIMARY KEY (`name`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE `app_margin`.`tb_applock` ( `appid` int(10) UNSIGNED NOT NULL, `lock_mode` int(10) NOT NULL DEFAULT 0, `change_time` datetime NOT NULL, PRIMARY KEY (`appid`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; INSERT `app_margin`.`tb_assign` (`id`,`assign_time`) VALUES (100000000,now());
詳細解釋如下:
tb_status 應用的狀態表。負責帳戶是否被凍結,帳戶的類型是什麼(真實的需求是應用可能有兩種帳戶,這裡為簡單所以沒有列出)
appid 應用id
freeze 是否凍結
create_time 創建時間
change_time 最後一次修改時間
tb_account_earn 應用的帳戶餘額表
appid 應用id
balance 餘額(單位為分,不要用小數存儲,因為小數本身不精確;另外php要在64位機下才能支援bigint)
create_time 建立時間
change_time 最後一次修改時間
seqid 操作序號(防並發,每次update都會1)
tb_assign 分配流水id的表,tb_bill的bill_id必須是有tb_assign分配的
id 自增id
create_time 建立時間
tb_bill 管線表。負責記錄每一條操作流水,這裡的bill_id不是主鍵,因為同一個bill_id可能會有支付和回滾兩個流水
id 自增序號
bill_id 流水號
amt 操作的金額(這個是要區別正負的,主要是為了select all的時候可以直接計算出某段時間的金額變化)
bill_info 操作的詳細信息,比如3台webserver,2台db
bill_user 操作用戶
bill_time 流水時間
bill_type 流水類型,區分是加錢還是減錢
bill_channel 流水來源,如充值,支付,回滾,結算還是其他
bill_ret 流水的返回碼,包括未處理、成功、失敗,這裡的邏輯會在後面講解
appid 應用id
old_balance 操作發生前的帳戶餘額
price_info 記錄操作發生時,記錄被支付物品的單價
src_ip 用戶端ip
tb_price 單價表,記錄了機器的單價
name 機器唯一標識
price 價格
info 描述
tb_applock 鎖定表,這是為了避免並發對某一個應用進行寫操作設計的,具體的程式碼會在後面展示
appid 應用程式id
lock_mode 鎖定狀態。為0則為鎖定,為1則為鎖定
change_time 最後一次修改時間
OK,庫表設計出來之後,我們就來看一下最典型的幾個操作.
一.支付操作
我這裡只列出了我目前實現的方式,可能不是最好的,但應該是最經濟又滿足需求的。
先說調用方這裡,邏輯如下:
然後對應的支付系統內部邏輯如下(只列出支付操作,回滾邏輯差不多,流水檢查是要檢查對應的支付流水是否存在):
常用的錯誤回傳碼可能如下就足夠了:
$g_site_error = array( -1 => '服务器繁忙', -2 => '数据库读取错误', -3 => '数据库写入错误', 0 => '成功', 1 => '没有数据', 2 => '没有权限', 3 => '余额不足', 4 => '账户被冻结', 5 => '账户被锁定', 6 => '参数错误', );
对于大于0的错误都算是逻辑错误,执行支付操作,调用方是不用记录流水的。因为账户并没有发生任何改变。
对于小于0的错误是系统内部错误,因为不知道是否发生了数据更改,所以调用方和支付系统都要记录流水。
对于等于0的返回,代表成功,两边也肯定要记录流水。
而在支付系统内部,之所以采用先写入流水,再进行账户更新的方式也是有原因的,简单来说就是尽量避免丢失流水。
最后总结一下,这种先扣钱,再发货,出问题再回滚的方式是一种模式;还有一种是先预扣,后发货,没有出问题则调用支付确认来扣款,出了问题就调用支付回滚来取消,如果预扣之后很长时间不做任何确认,那么金额会自动回滚。
二. 账户锁定的实现
这里利用了数据库的加锁机制,具体逻辑就不说了,代码如下:
class AppLock { function __construct($appid) { $this->m_appid = $appid; //初始化数据 $this->get(); } function __destruct() { $this->free(); } public function alloc() { if ($this->m_bGot == true) { return true; } $this->repairData(); $appid = $this->m_appid; $ret = $this->update($appid,APPLOCK_MODE_FREE,APPLOCK_MODE_ALLOC); if ($ret === false) { app_error_log("applock alloc fail"); return false; } if ($ret <= 0) { app_error_log("applock alloc fail,affected_rows:$ret"); return false; } $this->m_bGot = true; return true; } public function free() { if ($this->m_bGot != true) { return true; } $appid = $this->m_appid; $ret = $this->update($appid,APPLOCK_MODE_ALLOC,APPLOCK_MODE_FREE); if ($ret === false) { app_error_log("applock free fail"); return false; } if ($ret <= 0) { app_error_log("applock free fail,affected_rows:$ret"); return false; } $this->m_bGot = false; return true; } function repairData() { $db = APP_DB(); $appid = $this->m_appid; $now = time(); $need_time = $now - APPLOCK_REPAIR_SECS; $str_need_time = date("Y-m-d H:i:s", $need_time); $db->where("appid",$appid); $db->where("lock_mode",APPLOCK_MODE_ALLOC); $db->where("change_time <=",$str_need_time); $db->set("lock_mode",APPLOCK_MODE_FREE); $db->set("change_time","NOW()",false); $ret = $db->update(TB_APPLOCK); if ($ret === false) { app_error_log("repair applock error,appid:$appid"); return false; } return true; } private function get() { $db = APP_DB(); $appid = $this->m_appid; $db->where('appid', $appid); $query = $db->get(TB_APPLOCK); if ($query === false) { app_error_log("AppLock get fail.appid:$appid"); return false; } if (count($query->result_array()) <= 0) { $applock_data = array( 'appid'=>$appid, 'lock_mode'=>APPLOCK_MODE_FREE, ); $db->set('change_time','NOW()',false); $ret = $db->insert(TB_APPLOCK, $applock_data); if ($ret === false) { app_error_log("applock insert fail:$appid"); return false; } //重新获取数据 $db->where('appid', $appid); $query = $db->get(TB_APPLOCK); if ($query === false) { app_error_log("AppLock get fail.appid:$appid"); return false; } if (count($query->result_array()) <= 0) { app_error_log("AppLock not data,appid:$appid"); return false; } } $applock_data = $query->row_array(); return $applock_data; } private function update($appid,$old_lock_mode,$new_lock_mode) { $db = APP_DB(); $db->where('appid',$appid); $db->where('lock_mode',$old_lock_mode); $db->set('lock_mode',$new_lock_mode); $db->set('change_time','NOW()',false); $ret = $db->update(TB_APPLOCK); if ($ret === false) { app_error_log("update applock error,appid:$appid,old_lock_mode:$old_lock_mode,new_lock_mode:$new_lock_mode"); return false; } return $db->affected_rows(); } //是否获取到了锁 public $m_bGot = false; public $m_appid; }
为了防止死锁的问题,获取锁的逻辑中加入了超时时间的判断,大家看代码应该就能看懂
三. 对帐逻辑
如果按照上面的系统来设计,那么对帐的时候,只要对一下两边成功(即bill_ret=0)的流水即可,如果完全一致那么账户应该是没有问题的,如果不一致,那就要去查问题了。
关于保证账户正确性这里,也有同事跟我说,之前在公司做的时候,是采取只要有任何写操作之前,都先取一下流水表中所有的流水记录,将amt的值累加起来,看得到的结果是否和余额相同。如果不相同应该就是出问题了。
select sum(amt) from tb_bill where appid=1;
所以这也是为什么我在流水表中,amt字段是要区分正负的原因。
总结:以上就是本篇文的全部内容,希望能对大家的学习有所帮助。
相关推荐:
以上是PHP支付系統設計與典型案例(建議)的詳細內容。更多資訊請關注PHP中文網其他相關文章!