ThinkPHP下表单令牌错误与解决方法分析

本文实例讲述了thinkphp下表单令牌错误与解决方法。分享给大家供大家参考，具体如下：

在项目的开发过程中，添加、编辑数据时偶尔会遇到系统提示的“表单令牌错误”，一开始没怎么在意，直到今天下午qa把此问题提到bug系统了，正好时间也有空余，就追着tp3.13的源码看了下去，几分钟后，便知道原委了。

在项目中开启表单令牌，通常要在配置文件中做如下配置

// 是否开启令牌验证
'token_on' => true,
// 令牌验证的表单隐藏字段名称
'token_name' => '__hash__',
//令牌哈希验证规则 默认为md5
'token_type' => 'md5',
//令牌验证出错后是否重置令牌 默认为true
'token_reset' => true

以编辑数据为例，通常在服务端有个model写上字段过滤规则，action写上数据检测的代码，如

$table = d('table');
if(!$table->create()){
  exit($this->error($table->geterror()));
}

这时在ide上双击create()定位到tp框架中model.class.php中的create方法

/**
* 创建数据对象 但不保存到数据库
* @access public
* @param mixed $data 创建数据
* @param string $type 状态
* @return mixed
*/
public function create($data='',$type='') {
  ……省略……
  // 表单令牌验证
  if(!$this->autochecktoken($data)) {
    $this->error = l('_token_error_');
    return false;
  }
  ……省略……
}

看到代码会理解当autochecktoken方法检测失败时会报错，那么就接着跟踪此方法

// 自动表单令牌验证
// todo ajax无刷新多次提交暂不能满足
public function autochecktoken($data) {
  // 支持使用token(false) 关闭令牌验证
  // 如果在action写了d方法，但没有对应的model文件，那么$this->options为空
  if(isset($this->options['token']) && !$this->options['token']) return true;
  if(c('token_on')){
    $name  = c('token_name');
    if(!isset($data[$name]) || !isset($_session[$name])) { // 令牌数据无效
      return false;
    }
    // 令牌验证
    list($key,$value) = explode('_',$data[$name]);
    if($value && $_session[$name][$key] === $value) { // 防止重复提交
      unset($_session[$name][$key]); // 验证完成销毁session
      return true;
    }
    // 开启token重置
    if(c('token_reset')) unset($_session[$name][$key]);
    return false;
  }
  return true;
}

看了这段代码，会发现第一个判断中有$_session[$name]，那么这个seesion变量时从哪里过来的呢，这还得从生成令牌时说起，定位tokenbuildbehavior.class.php文件

// 创建表单令牌
private function buildtoken() {
  $tokenname = c('token_name');
  $tokentype = c('token_type');
  if(!isset($_session[$tokenname])) {
    $_session[$tokenname] = array();
  }
  // 标识当前页面唯一性
  $tokenkey  = md5($_server['request_uri']);
  if(isset($_session[$tokenname][$tokenkey])) {// 相同页面不重复生成session
    $tokenvalue = $_session[$tokenname][$tokenkey];
  }else{
    $tokenvalue = $tokentype(microtime(true));
    $_session[$tokenname][$tokenkey]  = $tokenvalue;
  }
  $token   = '<input type="hidden" name="'.$tokenname.'" value="'.$tokenkey.'_'.$tokenvalue.'" />';
  return $token;
}

此段代码主要是在tp开启表单验证的情况下，以token_name和当前uri的md5为健生成令牌值，再在用户提交表单时，先验证下是否存在该session，没有则返回false，有则紧接着和表单字段token_name验证下，如果一致先删除此session（作用时避免下次提交出先表单令牌错误），返回ture，否则返回false。

ok，回到主题，tp下表单提交之所以会出现令牌错误，那么就只有两种可能

1. 在令牌开启的状态下，提交的表单中，没有token_name字段或是没有相应session（当前提交表单环境下，没有生成相应session，这个主要是在用户提交后报错用户紧接着又刷新当前页面，同时编辑页面和展示页面是在同一个方法里）

2. 有session变量，但前后值不一样

我们项目之所以出现此错误，可以看看下面配置

return array (
  'token_on' => 'false',
  'token_name' => '__hash__',
  'token_type' => 'md5',
  'token_reset' => 'true',
  'db_fieldtype_check' => 'true'
);

本来应该写成布尔值的false，不知道哪位大侠任性的写成字符串的false了，那么判断时当然会按开启表单令牌的逻辑来，而且项目中，添加、编辑和展示都是同一个方法，一旦验证出错，一般程序处理逻辑会返回原有的界面，那么就和上次是同一个表单了，连续提交同一个表单也就相当于重复提交，那么便会报“表单令牌错误”。

更多关于thinkphp相关内容感兴趣的读者可查看本站专题：《thinkphp入门教程》、《thinkphp模板操作技巧总结》、《thinkphp常用方法总结》、《codeigniter入门教程》、《ci(codeigniter)框架进阶教程》、《zend framework框架入门教程》及《php模板技术总结》。

希望本文所述对大家基于thinkphp框架的php程序设计有所帮助。