ThinkPHP內置了表單令牌驗證功能,可以有效防止表單的遠程提交等安全防護。
表單令牌驗證相關的配置參數有:
'TOKEN_ON'=>true, // 是否開啟令牌驗證 'TOKEN_NAME'=>'__hash__', // 令牌驗證的表單隱藏字段名稱 'TOKEN_TYPE'=>'md5', //令牌哈希驗證規則 默認為MD5
如果開啟表單令牌驗證功能,系統會自動在帶有表單的模板文件裡面自動生成以TOKEN_NAME為名稱的隱藏域,其值則是TOKEN_TYPE方式生成的哈希字符串,用於實現表單的自動令牌驗證。
自動生成的隱藏域位於表單Form結束標志之前,如果希望自己控制隱藏域的位置,可以手動在表單頁面添加__TOKEN__ 標識,系統會在輸出模板的時候自動替換。如果在開啟表單令牌驗證的情況下,個別表單不需要使用令牌驗證功能,可以在表單頁面添加__NOTOKEN__,則系統會忽略當前表單的令牌驗證。
如果頁面中存在多個表單,建議添加__TOKEN__標識,並確保只有一個表單需要令牌驗證。
模型類在創建數據對象的同時會自動進行表單令牌驗證操作,如果你沒有使用create方法創建數據對象的話,則需要手動調用模型的autoCheckToken方法進行表單令牌驗證。如果返回false,則表示表單令牌驗證錯誤。例如:
$User = M("User"); // 實例化User對象
// 手動進行令牌驗證
if (!$User->autoCheckToken($_POST)){
// 令牌驗證錯誤
}
在ThinkPHP框架的View.class.php裡定義了一個公共的模板替換函數
protected function templateContentReplace($content) {
// 系統默認的特殊變量替換
$replace = array(
'../Public' => APP_PUBLIC_PATH,// 項目公共目錄
'__PUBLIC__' => WEB_PUBLIC_PATH,// 站點公共目錄
'__TMPL__' => APP_TMPL_PATH, // 項目模板目錄
'__ROOT__' => __ROOT__, // 當前網站地址
'__APP__' => __APP__, // 當前項目地址
'__UPLOAD__' => __ROOT__.'/Uploads',
'__ACTION__' => __ACTION__, // 當前操作地址
'__SELF__' => __SELF__, // 當前頁面地址
'__URL__' => __URL__,
'__INFO__' => __INFO__,
);
if(defined('GROUP_NAME'))
{
$replace['__GROUP__'] = __GROUP__;// 當前項目地址
}
if(C('TOKEN_ON')) {
if(strpos($content,'{__TOKEN__}')) {
// 指定表單令牌隱藏域位置
$replace['{__TOKEN__}'] = $this->buildFormToken();
}elseif(strpos($content,'{__NOTOKEN__}')){
// 標記為不需要令牌驗證
$replace['{__NOTOKEN__}'] = '';
}elseif(preg_match('/<\/form(\s*)>/is',$content,$match)) {
// 智能生成表單令牌隱藏域
$replace[$match[0]] = $this->buildFormToken().$match[0];
}
}
// 允許用戶自定義模板的字符串替換
if(is_array(C('TMPL_PARSE_STRING')) )
$replace = array_merge($replace,C('TMPL_PARSE_STRING'));
$content = str_replace(array_keys($replace),array_values($replace),$content);
return $content;
}
上面的if(C('TOKEN_ON'))是對令牌驗證的開啟狀態進行判斷,若開啟則調用buildFormToken()方法,$_SESSION[$tokenName] = $tokenValue; 其實就是給$_SESSION['__hash__']賦值。如果不想進行令牌驗證,只要在頁面的</form>之前加入{__NOTOKEN__}就行了,它會被函數替換成空。
在ThinkPHP的Model.class.php類裡定義了令牌的驗證函數
// 表單令牌驗證
if(C('TOKEN_ON') && !$this->autoCheckToken($data)) {
$this->error = L('_TOKEN_ERROR_');
return false;
}
// 自動表單令牌驗證
public function autoCheckToken($data) {
$name = C('TOKEN_NAME');
if(isset($_SESSION[$name])) {
// 當前需要令牌驗證
if(empty($data[$name]) || $_SESSION[$name] != $data[$name]) {
// 非法提交
return false;
}
// 驗證完成銷毀session
unset($_SESSION[$name]);
}
return true;
}