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; }