thinkphp核心源码注释-Driver.class.php

发布时间:2017-09-12 15:35:02
thinkphp核心源码注释|Driver.class.php




// +----------------------------------------------------------------------

namespace Think\Db;
use Think\Config;
use Think\Debug;
use Think\Log;
use PDO;
// 亲戚,今天开始 重新写代码,

abstract class Driver {
// PDO操作实例
protected $PDOStatement = null; // 当前连接实例 也是结果集
// 当前操作所属的模型名
protected $model
= '_think_';// 所属模型
// 当前SQL指令
protected $queryStr = '';// sql 语句
protected $modelSql = array(); // 这个应该是事务类型的 sql 语句
// 最后插入ID
protected $lastInsID = null; // getlastSql就是 返回当前数据ID
// 返回或者影响记录数
protected $numRows = 0;// 获取影响的行数
// 事务指令数
protected $transTimes = 0;// 指令执行次数
// 错误信息
protected $error
= ''; // 错误信息
// 数据库连接ID 支持多个连接
protected $linkID
= array(); // 多连接
// 当前连接ID
protected $_linkID = null; // 当前 单连接
// 数据库连接参数配置
protected $config
= array( // 神奇的配置文件
'type'
=> '',
// 数据库类型 一般来说用的最多了
'hostname'
=> '127.0.0.1', // 服务器地址
'database'
=> '',
// 数据库名
'username'
=> '',
// 用户名
'password'
=> '',
// 密码
'hostport'
=> '',
// 端口
'dsn'
=> '', //
数据库连接字符串
'params'
=> array(), // 数据库连接参数
'charset'
=> 'utf8',
// 数据库编码默认采用utf8
'prefix'
=> '', // 数据库表前缀
'debug'
=> false, // 数据库调试模式
'deploy'
=> 0, // 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器) 简单的说,就是 分布式
'rw_separate'
=> false,
// 数据库读写是否分离 主从式有效 读写分离,主从有效
'master_num'
=> 1, // 读写分离后 主服务器数量 默认主服务器 1
'slave_no'
=> '', // 指定从服务器序号 默认 随机轮询
'db_like_fields' => '', // 连接区域
);
// 数据库表达式
protected $exp = array('eq'=>'=','neq'=>'<>','gt'=>'>','egt'=>'>=','lt'=>'<','elt'=>'<=','notlike'=>'NOT LIKE','like'=>'LIKE','in'=>'IN','notin'=>'NOT IN','not in'=>'NOT IN','between'=>'BETWEEN','not between'=>'NOT BETWEEN','notbetween'=>'NOT BETWEEN');
// 表达式 内部转义使用
// 查询表达式
protected $selectSql = 'SELECT%DISTINCT% %FIELD% FROM %TABLE%%FORCE%%JOIN%%WHERE%%GROUP%%HAVING%%ORDER%%LIMIT% %UNION%%LOCK%%COMMENT%';
// 查询语句的表达式,据说这个语句比较复杂
// 查询次数
protected $queryTimes = 0; // 查询次数
// 执行次数
protected $executeTimes = 0;// 执行次数
// PDO连接参数
protected $options = array( // 默认 PDO连接的参数
PDO::ATTR_CASE
=> PDO::CASE_LOWER,
PDO::ATTR_ERRMODE
=> PDO::ERRMODE_EXCEPTION,
PDO::ATTR_ORACLE_NULLS
=> PDO::NULL_NATURAL,
PDO::ATTR_STRINGIFY_FETCHES => false,
);
protected $bind
= array(); // 参数绑定 格外配置的参数
/**
* 架构函数 读取数据库配置信息
* @access public
* @param array $config 数据库配置数组
*/
public function __construct($config=''){ // 获取参数配置 从输入参数的角度上可以看出,这个就是参数配置了
if(!empty($config)) {
$this->config = array_merge($this->config,$config);
if(is_array($this->config['params'])){
$this->options = $this->config['params'] + $this->options; // 这个 跟上面的那个其实是差不多的
}
}
}
/**
* 连接数据库方法
* @access public
*/
public function connect($config='',$linkNum=0,$autoConnection=false) { // 数据库连接,支持 单独配置 数据库选择从库,自动连接
if ( !isset($this->linkID[$linkNum]) ) { // 如果有数据库连接 下面的 else 就直接返回,否则,连接上,在返回
if(empty($config)) $config = $this->config; // 先处理当前的配置项目
try{ // 大大的异常处理,就是搞不定,就用这个
if(empty($config['dsn'])) { // 看看 用什么 方式进行连接
$config['dsn'] = $this->parseDsn($config);//
}
if(version_compare(PHP_VERSION,'5.3.6','<=')){
// 禁用模拟预处理语句
$this->options[PDO::ATTR_EMULATE_PREPARES] = false; // 进行解析 防止注入的
}
$this->linkID[$linkNum] = new PDO( $config['dsn'], $config['username'], $config['password'],$this->options);// 进行参数配置的连接
}catch (\PDOException $e) {
if($autoConnection){ // 判读是否自动ianj
trace($e->getMessage(),'','ERR');
return $this->connect($autoConnection,$linkNum); // 进行自动连接的返回
}elseif($config['debug']){
E($e->getMessage());// 直接返回问题
}
}
}
return $this->linkID[$linkNum];
}
/**
* 解析pdo连接的dsn信息
* @access public
* @param array $config 连接信息
* @return string
*/
protected function parseDsn($config){} // 调用 其它的函数的解析类 在子类中执行
/**
* 释放查询结果
* @access public
*/
public function free() { // 清空结果集
$this->PDOStatement = null;
}
/**
* 执行查询 返回数据集
* @access public
* @param string $str sql指令
* @param boolean $fetchSql 不执行只是获取SQL
* @return mixed
*/
public function query($str,$fetchSql=false) {
// 第一步:初始化连接
$this->initConnect(false);// 初始化连接
if ( !$this->_linkID ) return false;// 失败 返回 false
// 第二步:处理 sql 语句
$this->queryStr
= $str;// 如果有 str 字符串,就 复制给 执行语句 句柄
if(!empty($this->bind)){ // 如果没有 参数就不执行
$that = $this;// 赋值当前对象
$this->queryStr = strtr($this->queryStr,array_map(function($val) use($that){ return '\''.$that->escapeString($val).'\''; },$this->bind));// 参数执行, 外加过滤
}
// 第二步:小插曲,可以直接返回语句,半路的功能
if($fetchSql){// 如果没有
return $this->queryStr; // 这个query 可以返回参数 ,牛叉
}
// 第三步: 准备 参数 跟日志
//释放前次的查询结果
if ( !empty($this->PDOStatement) ) $this->free(); // 清空仓库
$this->queryTimes++;// 记录查询次数
N('db_query',1); // 兼容代码 更新记录日志
// 调试开始
// 第四步:开始 查询执行
$this->debug(true);// 这个我看过了,其实就是一个 记录操作日志
$this->PDOStatement = $this->_linkID->prepare($str); // 破解 准备
if(false === $this->PDOStatement){// 如果没找到的话,
$this->error();// 报错
return false;
}
foreach ($this->bind as $key => $val) {// 绑定参数解析
if(is_array($val)){
$this->PDOStatement->bindValue($key, $val[0], $val[1]);
}else{
$this->PDOStatement->bindValue($key, $val);
}
}
$this->bind = array();// 清空绑定参数
try{
$result = $this->PDOStatement->execute(); // 开始执行 获取
// 调试结束
$this->debug(false);// 关闭 调试 记录运行内存 跟时间
if ( false === $result ) {// 没有结果
$this->error();// 返回错误
return false;
} else {
return $this->getResult();// 获取返回结果
}
}catch (\PDOException $e) {
$this->error();// 返回异步错误信息
return false;
}
// 返回结果,
}
/**
* 执行语句
* @access public
* @param string $str sql指令
* @param boolean $fetchSql 不执行只是获取SQL
* @return mixed
* pdo 的执行
*/
public function execute($str,$fetchSql=false) {
$this->initConnect(true);
if ( !$this->_linkID ) return false;
$this->queryStr = $str;
if(!empty($this->bind)){
$that = $this;
$this->queryStr = strtr($this->queryStr,array_map(function($val) use($that){ return '\''.$that->escapeString($val).'\''; },$this->bind));
}
if($fetchSql){
return $this->queryStr;
}
//释放前次的查询结果
if ( !empty($this->PDOStatement) ) $this->free();
$this->executeTimes++;
N('db_write',1); // 兼容代码
// 记录开始执行时间
$this->debug(true);
$this->PDOStatement = $this->_linkID->prepare($str);
if(false === $this->PDOStatement) {
$this->error();
return false;
}
foreach ($this->bind as $key => $val) {
if(is_array($val)){
$this->PDOStatement->bindValue($key, $val[0], $val[1]);
}else{
$this->PDOStatement->bindValue($key, $val);
}
}
$this->bind = array();
try{
$result = $this->PDOStatement->execute();
// 调试结束
$this->debug(false);
if ( false === $result) {
$this->error();
return false;
} else {
$this->numRows = $this->PDOStatement->rowCount();
if(preg_match("/^\s*(INSERT\s+INTO|REPLACE\s+INTO)\s+/i", $str)) {
$this->lastInsID = $this->_linkID->lastInsertId();
}
return $this->numRows;
}
}catch (\PDOException $e) {
$this->error();
return false;
}
}
// 总结 这个 跟 pdo 的query 还有 execute 都可以 类似的时间
/**
* 启动事务
* @access public
* @return void
*/
public function startTrans() {// 启动事务,不是开启事务
$this->initConnect(true);
if ( !$this->_linkID ) return false;
//数据rollback 支持
if ($this->transTimes == 0) {
$this->_linkID->beginTransaction(); // 开启事件
}
$this->transTimes++;
return ;
}
/**
* 用于非自动提交状态下面的查询提交
* @access public
* @return boolean
* 事务提交
*/
public function commit() {
if ($this->transTimes > 0) {
$result = $this->_linkID->commit();
$this->transTimes = 0;
if(!$result){
$this->error();
return false;
}
}
return true;
}
/**
* 事务回滚
* @access public
* @return boolean
* 封装的事务回滚
*/
public function rollback() {
if ($this->transTimes > 0) {
$result = $this->_linkID->rollback();
$this->transTimes = 0;
if(!$result){
$this->error();
return false;
}
}
return true;
}
/**
* 获得所有的查询数据
* @access private
* @return array
* 获取结果集
*/
private function getResult() {
//返回数据集
$result = $this->PDOStatement->fetchAll(PDO::FETCH_ASSOC);
$this->numRows = count( $result );
return $result;
}
/**
* 获得查询次数
* @access public
* @param boolean $execute 是否包含所有查询
* @return integer
* 获得查询次数
*/
public function getQueryTimes($execute=false){
return $execute?$this->queryTimes+$this->executeTimes:$this->queryTimes;
}
/**
* 获得执行次数
* @access public
* @return integer
* 获取执行次数
*/
public function getExecuteTimes(){
return $this->executeTimes;
}
/**
* 关闭数据库
* @access public
* 关闭数据库连接
*/
public function close() {
$this->_linkID = null;
}
/**
* 数据库错误信息
* 并显示当前的SQL语句
* @access public
* @return string
*/
public function error() {
if($this->PDOStatement) {
$error = $this->PDOStatement->errorInfo();
$this->error = $error[1].':'.$error[2];
}else{
$this->error = '';
}
if('' != $this->queryStr){
$this->error .= "\n [ SQL语句 ] : ".$this->queryStr;
}
// 处理错误信息 完成
// 记录错误日志
trace($this->error,'','ERR');// 记录运行信息
if($this->config['debug']) {// 开启数据库调试模式
E($this->error);
}else{
return $this->error;
}
}
/**
* 参数绑定
* @access protected
* @param string $name 绑定参数名
* @param mixed $value 绑定值
* @return void
*/
protected function bindParam($name,$value){
$this->bind[':'.$name] = $value;
}
// 总结 上面的这些东西,基本上还是 sql 语句里面自带的东西了,
// 下面,就是呵呵了
/**
* 设置锁机制
* @access protected
* @return string
* 这个锁,我也是醉了
*/
protected function parseLock($lock=false) {
return $lock? ' FOR UPDATE ' : '';
}
/**
* set分析
* @access protected
* @param array $data
* @return string
*/
protected function parseSet($data) {
foreach ($data as $key=>$val){// 循环处理数据
if(is_array($val) && 'exp' == $val[0]){// 数组形式的处理
$set[] = $this->parseKey($key).'='.$val[1];
}elseif(is_null($val)){// 为空兼容处理
$set[] = $this->parseKey($key).'=NULL';
}elseif(is_scalar($val)) {// 过滤非标量数据
// 如果给出的变量参数var是一个标量,则is_scalar()函数将返回true,否则返回false。
// 标量变量是指那些包含了整型(integer)、浮点型(float)、字符串(string)或布尔型(boolean)的变量,而数组(array)、对象(object)和resource资源类型则不是标量。
if(0===strpos($val,':') && in_array($val,array_keys($this->bind)) ){
$set[] = $this->parseKey($key).'='.$this->escapeString($val);
}else{
$name = count($this->bind);
$set[] = $this->parseKey($key).'=:'.$name;
$this->bindParam($name,$val);
}
}
}
return ' SET '.implode(',',$set); // 特别喜欢这里 嘿嘿, 比自己组合强多了
}
// 总结,这个 SET 应该是为了 更新数据而设置,估计不同的更新方式不一样,出现时的解析方式不一样了
/**
* 字段名分析
* @access protected
* @param string $key
* @return string
* 这个不科学啊
*/
protected function parseKey(&$key) {
return $key;// 太简单了
}
/**
* value分析
* @access protected
* @param mixed $value
* @return string
* 不错,今天我们开始继续更新 ,处理了个 Value 简直就是各种的 if else 啊
*/
protected function parseValue($value) {
if(is_string($value)) {// 如果 是字符串 解析
// 如果没有冒号 并且 在 对应绑定的参数里面 就是 加不加斜杠的问题
$value = strpos($value,':') === 0 && in_array($value,array_keys($this->bind))? $this->escapeString($value) : '\''.$this->escapeString($value).'\'';
}elseif(isset($value[0]) && is_string($value[0]) && strtolower($value[0]) == 'exp'){ // 如果是数组
$value = $this->escapeString($value[1]); // 返回加入反斜杠的
}elseif(is_array($value)) {
// 此处是个位置的状态,如果有知道的同学,可以回复我一下,嘿嘿,感谢了
$value = array_map(array($this, 'parseValue'),$value);// 有点递归调用的感觉
}elseif(is_bool($value)){ // 将真假 转换成为 1 0
$value = $value ? '1' : '0';
}elseif(is_null($value)){// 空 转换成为 null
$value = 'null';
}
return $value;
}
/**
* field分析
* @access protected
* @param mixed $fields
* @return string
* 默认解析字段
*/
protected function parseField($fields) {
if(is_string($fields) && '' !== $fields) { // 字段如果是 字符串,并且 , 分割,就变回了 数组了
$fields = explode(',',$fields);
}// 情况1 完成
// 哥,我错了,我发现你的用心良苦了,搞了了半天,是提前预处理啊
if(is_array($fields)) {
// 完善数组方式传字段名的支持
// 支持 'field1'=>'field2' 这样的字段别名定义
$array = array(); // 整理临时仓库
foreach ($fields as $key=>$field){ //
if(!is_numeric($key)) // 如果是 非数字key 说白了 就是为了 那个啥 as 别名而已了
$array[] = $this->parseKey($key).' AS '.$this->parseKey($field);
else
$array[] = $this->parseKey($field);// 普通解析
}
$fieldsStr = implode(',', $array); // 然后在弄回去,有意思啊
}else{
$fieldsStr = '*';
}// 情况2 完成
//TODO 如果是查询全部字段,并且是join的方式,那么就把要查的表加个别名,以免字段被覆盖
return $fieldsStr; // 不过这种不相信任何人的兼容姿态的确不错,值得鼓励!
}
// 2016 01 26 继续,嘿嘿
/**
* table分析
* @access protected
* @param mixed $table
* @return string
* 解析table 这个 神器的设备
*/
protected function parseTable($tables) {
if(is_array($tables)) {// 支持别名定义 数组样式 跟 非数组样式
$array = array();
foreach ($tables as $table=>$alias){
if(!is_numeric($table)) // 增加了别名的一个判定
$array[] = $this->parseKey($table).' '.$this->parseKey($alias);
else // 普通的 tables
$array[] = $this->parseKey($alias);
}
$tables = $array; // 这个是为了 包含多个表做准备
}elseif(is_string($tables)){
$tables = explode(',',$tables);
array_walk($tables, array(&$this, 'parseKey'));// 又是个遍历,数组式的遍历
}
return implode(',',$tables);// 又是个拼合啊Q
}
// 其实,基本上可以说是秒懂了
// jingshan_user user, dage_score score
// jingshan_user, dage_age
// 处理 完成就是上述风格了。
/**
* where分析
* @access protected
* @param mixed $where
* @return string
* 这个可是个大活啊,嘿嘿
*/
protected function parseWhere($where) {
$whereStr = ''; // 首选准备好 仓库 【临时的】
if(is_string($where)) { // 如果是写好的语句,那么 就直接了
// 直接使用字符串条件
$whereStr = $where; // 其实这个不太常用,我个人不常用,嘿嘿
}else{ // 使用数组表达式 那么表达式的 来了
$operate = isset($where['_logic'])?strtoupper($where['_logic']):''; // 不同 语句之间的逻辑关系
if(in_array($operate,array('AND','OR','XOR'))){ // 符合规则,就按照规则完
// 定义逻辑运算规则 例如 OR XOR AND NOT
$operate = ' '.$operate.' ';
unset($where['_logic']);
}else{ // 否则 默认
// 默认进行 AND 运算
$operate = ' AND ';
}// 先处理 逻辑 清空 为下一步遍历 做准备
foreach ($where as $key=>$val){ // 变量 里面的数据
if(is_numeric($key)){ // 如果是数字的 话,其实,按照通常的角度,也就是 没有进行
$key = '_complex';//
}// 搞了半天,这个是为了匹配预处理机制啊,嘿嘿
//$Model->where("id=%d and username='%s' and xx='%f'",array($id,$username,$xx))->select();
// $Model->where("id=%d and username='%s' and xx='%f'",$id,$username,$xx)->select();
if(0===strpos($key,'_')) {
// 解析特殊条件表达式
$whereStr .= $this->parseThinkWhere($key,$val);
// 也就是说,这个是搞不定的,那么,外包了,哈哈哈
}else{
// 查询字段的安全过滤
// if(!preg_match('/^[A-Z_\|\&\-.a-z0-9\(\)\,]+$/',trim($key))){
//
E(L('_EXPRESS_ERROR_').':'.$key);
// }
// 多条件支持
// 过滤,自己都给他删除了,还弄个毛线呢,嘿嘿
$multi = is_array($val) && isset($val['_multi']);// 支持 单个字段 多条件查询
// 也就是说,如果,值是数组, 那么就是可以多条件查询的,并且含有多条件查询的标识
$key = trim($key); // 清空 两侧空格
if(strpos($key,'|')) { // 支持 name|title|nickname 方式定义查询字段
// 多字段 或条件 相同数值的简写
$array = explode('|',$key); // 解析这种方式
$str = array();
foreach ($array as $m=>$k){ // 一般情况下的 array 没啥呢 就是多个字段的 轮询
$v = $multi?$val[$m]:$val; // 这里传入的k 其实也是字段 的名字,
$str[] = $this->parseWhereItem($this->parseKey($k),$v);
}
$whereStr .= '( '.implode(' OR ',$str).' )';
}elseif(strpos($key,'&')){
// 多字段 与条件 相同数值的简写
$array = explode('&',$key);
$str = array();
foreach ($array as $m=>$k){
$v = $multi?$val[$m]:$val;
$str[] = '('.$this->parseWhereItem($this->parseKey($k),$v).')';
}
$whereStr .= '( '.implode(' AND ',$str).' )';
}else{
// 各种条目外包
$whereStr .= $this->parseWhereItem($this->parseKey($key),$val);
}
}
$whereStr .= $operate;// 拼接
}
$whereStr = substr($whereStr,0,-strlen($operate)); // 删掉最后一个 组合, 为啥不哦那个 implode 呢,我觉得更靠谱,嘿嘿
}
return empty($whereStr)?'':' WHERE '.$whereStr;
}
// where子单元分析
// 其实写这个 要具有较高的mysql 基础,这样才能做一良好 的映射
protected function parseWhereItem($key,$val) { // 基本上应该就是 字段名 + 字段的数值
$whereStr = ''; // 这个是一个单独的分析了 大的数组里面的 子数组,或者数值的一个分析
if(is_array($val)) { // 弄个半天,先解析困难的
if(is_string($val[0])) { // 也就是自己规定的 字段 如果是表达式 的
$exp = strtolower($val[0]);// 转义表达式
if(preg_match('/^(eq|neq|gt|egt|lt|elt)$/',$exp)) { // 比较运算
$whereStr .= $key.' '.$this->exp[$exp].' '.$this->parseValue($val[1]); // 一个简单的数组映射 就过去了,牛叉
}elseif(preg_match('/^(notlike|like)$/',$exp)){// 模糊查找
if(is_array($val[1])) { // 如果表达式里面的值 还是 数组,这个比较疯掉了
$likeLogic = isset($val[2])?strtoupper($val[2]):'OR'; // 并且还有更多的逻辑,
// 这个是针对于 like or notlike 的特殊用法,嘿嘿
if(in_array($likeLogic,array('AND','OR','XOR'))){
$like
= array();
foreach ($val[1] as $item){
$like[] = $key.' '.$this->exp[$exp].' '.$this->parseValue($item);
}
$whereStr .= '('.implode(' '.$likeLogic.' ',$like).')';
}
}else{
$whereStr .= $key.' '.$this->exp[$exp].' '.$this->parseValue($val[1]);// 普通的也就是个数组映射了
}
}elseif('bind' == $exp ){ // 使用表达式
$whereStr .= $key.' = :'.$val[1]; // 特殊表达式
}elseif('exp' == $exp ){ // 使用表达式
$whereStr .= $key.' '.$val[1];// 自己写的表达式
}elseif(preg_match('/^(notin|not in|in)$/',$exp)){ // IN 运算
if(isset($val[2]) && 'exp'==$val[2]) {
$whereStr .= $key.' '.$this->exp[$exp].' '.$val[1];// 也是个神奇的转换
}else{
if(is_string($val[1])) { // 直接 把字符串 转换成为数组
$val[1] = explode(',',$val[1]);
}
$zone
= implode(',',$this->parseValue($val[1])); // 过滤一下
$whereStr .= $key.' '.$this->exp[$exp].' ('.$zone.')'; // 然后在转化回去
}
}elseif(preg_match('/^(notbetween|not between|between)$/',$exp)){ // BETWEEN运算
$data = is_string($val[1])? explode(',',$val[1]):$val[1];
$whereStr .= $key.' '.$this->exp[$exp].' '.$this->parseValue($data[0]).' AND '.$this->parseValue($data[1]);
}else{// 其它的传入都不正确
E(L('_EXPRESS_ERROR_').':'.$val[0]);
}
}else {// 非字符串表达式的 怎么玩呢
$count = count($val);
// 获取逻辑规则
$rule = isset($val[$count-1]) ? (is_array($val[$count-1]) ? strtoupper($val[$count-1][0]) : strtoupper($val[$count-1]) ) : '' ;
if(in_array($rule,array('AND','OR','XOR'))) {
$count = $count -1;
}else{
$rule = 'AND';
}
// 遍历全部数据
for($i=0;$i<$count;$i++) {
$data = is_array($val[$i])?$val[$i][1]:$val[$i];
if('exp'==strtolower($val[$i][0])) {
$whereStr .= $key.' '.$data.' '.$rule.' ';
}else{
$whereStr .= $this->parseWhereItem($key,$val[$i]).' '.$rule.' ';
}
}
$whereStr = '( '.substr($whereStr,0,-4).' )';
}
}else {
//对字符串类型字段采用模糊匹配
// 如果你什么都不写,就写个数值的话,默认就读取你的 参数 进行最大的模糊匹配
$likeFields = $this->config['db_like_fields'];
if($likeFields && preg_match('/^('.$likeFields.')$/i',$key)) {
$whereStr .= $key.' LIKE '.$this->parseValue('%'.$val.'%');
}else {
$whereStr .= $key.' = '.$this->parseValue($val);
}
}
return $whereStr;
}
/**
* 特殊条件分析
* @access protected
* @param string $key
* @param mixed $val
* @return string
*/
protected function parseThinkWhere($key,$val) {
$whereStr = '';
switch($key) {
case '_string':
// 字符串模式查询条件
$whereStr = $val;
break;
case '_complex':
// 复合查询条件
$whereStr = substr($this->parseWhere($val),6);
break;
case '_query':
// 字符串模式查询条件
parse_str($val,$where);
if(isset($where['_logic'])) {
$op = ' '.strtoupper($where['_logic']).' ';
unset($where['_logic']);
}else{
$op = ' AND ';
}
$array = array();
foreach ($where as $field=>$data)
$array[] = $this->parseKey($field).' = '.$this->parseValue($data);
$whereStr = implode($op,$array);
break;
}
return '( '.$whereStr.' )';
}
/**
* limit分析
* @access protected
* @param mixed $lmit
* @return string
* 这个太容易了
*/
protected function parseLimit($limit) {
return !empty($limit)? ' LIMIT '.$limit.' ':'';
}
/**
* join分析
* @access protected
* @param mixed $join
* @return string
* 一个组合而已了 组合 开始
*/
protected function parseJoin($join) {
$joinStr = '';
if(!empty($join)) {// 如果不为空
$joinStr = ' '.implode(' ',$join).' ';
}
return $joinStr;
}
/**
* order分析
* @access protected
* @param mixed $order
* @return string
* SELECT * FROM t1 WHERE key_part1=1 ORDER BY key_part1 DESC, key_part2 DESC;
*/
protected function parseOrder($order) {
if(is_array($order)) {// key 一般作为 fields
$array = array();
foreach ($order as $key=>$val){
if(is_numeric($key)) {
$array[] = $this->parseKey($val);
}else{
$array[] = $this->parseKey($key).' '.$val;
}
}
$order = implode(',',$array); // 基础组合,然后 组件 新的位置
}
return !empty($order)? ' ORDER BY '.$order:'';
}
/**
* group分析
* @access protected
* @param mixed $group
* @return string
* 就是个 封装的 包装而已了
*/
protected function parseGroup($group) {
return !empty($group)? ' GROUP BY '.$group:'';
}
/**
* having分析
* @access protected
* @param string $having
* @return string
* 同上,无语中 ............
*/
protected function parseHaving($having) {
return !empty($having)? ' HAVING '.$having:'';
}
/**
* comment分析
* @access protected
* @param string $comment
* @return string
* 注释都解析,还是可以了
*/
protected function parseComment($comment) {
return !empty($comment)? ' /* '.$comment.' */':'';
}
/**
* distinct分析
* @access protected
* @param mixed $distinct
* @return string
* DISTINCT 去掉重复的数据
* select distinct name from table
*/
protected function parseDistinct($distinct) {
return !empty($distinct)? ' DISTINCT ' :'';
}
/**
* union分析
* @access protected
* @param mixed $union
* @return string
*/
protected function parseUnion($union) {
if(empty($union)) return ''; // 没有的话,你解析个什么呢
if(isset($union['_all'])) { // 如果是 all
$str = 'UNION ALL ';
unset($union['_all']);
}else{
$str = 'UNION ';
}
/**
* union 对两个结果集进行并集操作,重复数据只显示一次
Union All,对两个结果集进行并集操作,重复数据全部显示
*/
// 上述准备完成,准备清空
foreach ($union as $u){
$sql[] = $str.(is_array($u)?$this->buildSelectSql($u):$u);
}// 牛叉啊,居然还是个组合,嘿嘿
return implode(' ',$sql);
}
/**
* 参数绑定分析
* @access protected
* @param array $bind
* @return array
* 还不如直接用这个 函数呢,弄的感觉很是高大上的样子。
*/
protected function parseBind($bind){
$this->bind = array_merge($this->bind,$bind);
}
/**
* index分析,可在操作链中指定需要强制使用的索引
* @access protected
* @param mixed $index
* @return string
*/
protected function parseForce($index) {
if(empty($index)) return '';
if(is_array($index)) $index = join(",", $index); //join — 别名 implode()
return sprintf(" FORCE INDEX ( %s ) ", $index); // 这个是个 强制索引,牛叉
}
/**
* ON DUPLICATE KEY UPDATE 分析
* @access protected
* @param mixed $duplicate
* @return string
* 空白啊,这个彻底的忽悠啊
*/
protected function parseDuplicate($duplicate){
return '';
}
//////////////////////////////////////////////////////////////////
/**
* 获取最近一次查询的sql语句
* @param string $model 模型名
* @access public
* @return string
* 容易的先过一下,哈哈哈 , 多语句存储
*/
public function getLastSql($model='') {
return $model?$this->modelSql[$model]:$this->queryStr;
}
/**
* 获取最近插入的ID
* @access public
* @return string
* 简单封装 返回 跟最开始时候的 get 差不多的样子
*/
public function getLastInsID() {
return $this->lastInsID;
}
/**
* 获取最近的错误信息
* @access public
* @return string
* 同上,无语中.............
*/
public function getError() {
return $this->error;
}
/**
* SQL指令安全过滤
* @access public
* @param string $str SQL字符串
* @return string
* 就这个也能过滤吗,估计靠谱吧
*/
public function escapeString($str) {
return addslashes($str); // addslashes() 函数返回在预定义字符之前添加反斜杠的字符串。
}
/**
* 设置当前操作模型
* @access public
* @param string $model 模型名
* @return void
* 同上了.........
*/
public function setModel($model){
$this->model = $model;
}
/**
* 数据库调试 记录当前SQL
* @access protected
* @param boolean $start 调试开始标记 true 开始 false 结束
* 调试 其实,就是个 记录运行,跟输出
*/
protected function debug($start) {
if($this->config['debug']) {// 开启数据库调试模式
if($start) {
G('queryStartTime'); // 开始记录
}else{
$this->modelSql[$this->model] = $this->queryStr;
//$this->model = '_think_';
// 记录操作结束时间
G('queryEndTime'); // 记录时间
trace($this->queryStr.' [ RunTime:'.G('queryStartTime','queryEndTime').'s ]','','SQL');
// 记录到日志信息 也可以输出到页面
}
}
}
/**
* 初始化数据库连接
* @access protected
* @param boolean $master 主服务器
* @return void
* 数据库的连接 分布式连接 跟单独的连接
*/
protected function initConnect($master=true) {
if(!empty($this->config['deploy']))
// 采用分布式数据库
$this->_linkID = $this->multiConnect($master);
else
// 默认单数据库
if ( !$this->_linkID ) $this->_linkID = $this->connect();
}
/**
* 析构方法
* @access public
* 删除 记录
*/
public function __destruct() {
// 释放查询
if ($this->PDOStatement){
$this->free();
}
// 关闭连接
$this->close();
}
// 今日继续,上午也没录成课程,全部都是答疑了
/**
* 插入记录
* @access public
* @param mixed $data 数据
* @param array $options 参数表达式
* @param boolean $replace 是否replace
* @return false | integer
*/
public function insert($data,$options=array(),$replace=false) {
$values = $fields = array(); // 清空准备仓库
$this->model = $options['model']; // 准备当前模式
$this->parseBind(!empty($options['bind'])?$options['bind']:array());// 参数绑定准备
foreach ($data as $key=>$val){// 对传入的数据进行处理
if(is_array($val) && 'exp' == $val[0]){ // 如果数值为数组,并且 说明是表达式
$fields[] = $this->parseKey($key); // key 处理
$values[] = $val[1];// val 直接用了,危险啊,哥哥,都不处理一下呢
}elseif(is_null($val)){// 单独处理个NULL
$fields[] = $this->parseKey($key);
$values[] = 'NULL';
}elseif(is_scalar($val)) { // 过滤非标量数据
$fields[] = $this->parseKey($key);// 先处理个 key
if(0===strpos($val,':') && in_array($val,array_keys($this->bind))){
$values[] = $this->parseValue($val);
}else{
$name
= count($this->bind);
$values[] = ':'.$name;
$this->bindParam($name,$val);
}
// 特殊处理,表示都是外包的黑盒子,没怎么看懂,这个怎么办呢?
}
}
// 兼容数字传入方式
$replace= (is_numeric($replace) && $replace>0)?true:$replace;
// 其实这个还兼容了,一个不是很常用的 sql ,反正我是这样信的
$sql = (true===$replace?'REPLACE':'INSERT').' INTO '.$this->parseTable($options['table']).' ('.implode(',', $fields).') VALUES ('.implode(',', $values).')'.$this->parseDuplicate($replace);
// 格外处理个评论
$sql .= $this->parseComment(!empty($options['comment'])?$options['comment']:'');
// 返回执行结果
return $this->execute($sql,!empty($options['fetch_sql']) ? true : false);
}
// 新的记录
/**
* 批量插入记录
* @access public
* @param mixed $dataSet 数据集
* @param array $options 参数表达式
* @param boolean $replace 是否replace
* @return false | integer
*/
public function insertAll($dataSet,$options=array(),$replace=false) {
$values = array();// 仓库 临时的 仓库
$this->model = $options['model']; // 选项里面的 连接模型
// protected $model
= '_think_';// 所属模型
if(!is_array($dataSet[0])) return false;// 如果插入的数据里面 什么都没有,那弄什么呢?
$this->parseBind(!empty($options['bind'])?$options['bind']:array());// 绑定了一个我不知道的参数
$fields = array_map(array($this,'parseKey'),array_keys($dataSet[0])); // 类内部 传递参数
foreach ($dataSet as $data){ // 就是个 data to sql 数组 到数据库
$value = array();// 遍历数据 临时 子仓库
foreach ($data as $key=>$val){
if(is_array($val) && 'exp' == $val[0]){// 表达式
$value[] = $val[1];
}elseif(is_null($val)){// null 重新准备
$value[] = 'NULL';
}elseif(is_scalar($val)){ // 非标量 数据
if(0===strpos($val,':') && in_array($val,array_keys($this->bind))){
$value[] = $this->parseValue($val);
}else{
$name
= count($this->bind); // 另外的一种形式的绑定
$value[] = ':'.$name;
$this->bindParam($name,$val);// 解析参数
}
}
}
$values[] = 'SELECT '.implode(',', $value);
}
// 批量插入语句,不知道,是否可以正常使用
$sql = 'INSERT INTO '.$this->parseTable($options['table']).' ('.implode(',', $fields).') '.implode(' UNION ALL ',$values);
$sql .= $this->parseComment(!empty($options['comment'])?$options['comment']:'');// 处理评论
return $this->execute($sql,!empty($options['fetch_sql']) ? true : false);// 执行语句
}
/**
* 通过Select方式插入记录
* @access public
* @param string $fields 要插入的数据表字段名
* @param string $table 要插入的数据表名
* @param array $option 查询数据参数
* @return false | integer
*/
public function selectInsert($fields,$table,$options=array()) {
$this->model = $options['model'];// 模型管理
$this->parseBind(!empty($options['bind'])?$options['bind']:array());// 绑定参数
if(is_string($fields)) $fields = explode(',',$fields); // 处理字段
array_walk($fields, array($this, 'parseKey')); // 敢告诉我 这个 walk 跟 那个 有什么区别吗啊,哈哈
$sql = 'INSERT INTO '.$this->parseTable($table).' ('.implode(',', $fields).') ';// 插入数据
$sql .= $this->buildSelectSql($options);// 开始 创建语句
return $this->execute($sql,!empty($options['fetch_sql']) ? true : false);// 执行 sql 语句
}
/**
* 更新记录
* @access public
* @param mixed $data 数据
* @param array $options 表达式
* @return false | integer
*/
public function update($data,$options) {
$this->model = $options['model'];
$this->parseBind(!empty($options['bind'])?$options['bind']:array());
$table = $this->parseTable($options['table']);
$sql = 'UPDATE ' . $table . $this->parseSet($data); // 一样的调调,我懂了
if(strpos($table,',')){// 多表更新支持JOIN操作 多表 的 jion 操作
$sql .= $this->parseJoin(!empty($options['join'])?$options['join']:''); // 外包
}
$sql .= $this->parseWhere(!empty($options['where'])?$options['where']:''); // 外包
if(!strpos($table,',')){
// 单表更新支持order和lmit
$sql .= $this->parseOrder(!empty($options['order'])?$options['order']:'')
.$this->parseLimit(!empty($options['limit'])?$options['limit']:'');
} //UPDATE channel_config set is_adam_pub=1 LIMIT 5607;
// 靠谱 重大发现啊
//UPDATE `my_to_do_list`.`users` SET `email` = 'guanyu@888.com1' WHERE `users`.`id` =3;
$sql .= $this->parseComment(!empty($options['comment'])?$options['comment']:'');
return $this->execute($sql,!empty($options['fetch_sql']) ? true : false);// 执行sql 语句
}
// 29 开始
/**
* 删除记录
* @access public
* @param array $options 表达式
* @return false | integer
*/
public function delete($options=array()) {
$this->model = $options['model'];
$this->parseBind(!empty($options['bind'])?$options['bind']:array());
$table = $this->parseTable($options['table']);
$sql = 'DELETE FROM '.$table;// 删除 问题
if(strpos($table,',')){// 多表删除支持USING和JOIN操作
if(!empty($options['using'])){// 各种外包啊
$sql .= ' USING '.$this->parseTable($options['using']).' ';
}
$sql .= $this->parseJoin(!empty($options['join'])?$options['join']:'');
}
$sql .= $this->parseWhere(!empty($options['where'])?$options['where']:'');
if(!strpos($table,',')){ // 分条件外包,牛叉
// 单表删除支持order和limit
$sql .= $this->parseOrder(!empty($options['order'])?$options['order']:'')
.$this->parseLimit(!empty($options['limit'])?$options['limit']:'');
}
$sql .= $this->parseComment(!empty($options['comment'])?$options['comment']:'');
return $this->execute($sql,!empty($options['fetch_sql']) ? true : false);
}
// 总结,一个外包公司
/**
* 查找记录
* @access public
* @param array $options 表达式
* @return mixed
* 这个倒是很干净利落
*/
public function select($options=array()) {
$this->model = $options['model'];
$this->parseBind(!empty($options['bind'])?$options['bind']:array());
$sql = $this->buildSelectSql($options);
$result = $this->query($sql,!empty($options['fetch_sql']) ? true : false);
return $result;
}
///////////////////////////////////////////////////////////////////////////
/**
* 生成查询SQL
* @access public
* @param array $options 表达式
* @return string
*/
public function buildSelectSql($options=array()) {
if(isset($options['page'])) { // 如果有 分页的效果
// 根据页数计算limit
list($page,$listRows) = $options['page'];
$page = $page>0 ? $page : 1;// 处理默认数据
$listRows= $listRows>0 ? $listRows : (is_numeric($options['limit'])?$options['limit']:20);
$offset = $listRows*($page-1);// 偏移量
$options['limit'] = $offset.','.$listRows; // 生成限制 sql 语句
}
$sql = $this->parseSql($this->selectSql,$options);// 解析字符串
return $sql;
}
//
/**
* 替换SQL语句中表达式
* @access public
* @param array $options 表达式
* @return string
* 看来这个是总外包
*/
public function parseSql($sql,$options=array()){
$sql = str_replace(
array('%TABLE%','%DISTINCT%','%FIELD%','%JOIN%','%WHERE%','%GROUP%','%HAVING%','%ORDER%','%LIMIT%','%UNION%','%LOCK%','%COMMENT%','%FORCE%'),
array(
$this->parseTable($options['table']),
$this->parseDistinct(isset($options['distinct'])?$options['distinct']:false),
$this->parseField(!empty($options['field'])?$options['field']:'*'),
$this->parseJoin(!empty($options['join'])?$options['join']:''),
$this->parseWhere(!empty($options['where'])?$options['where']:''),
$this->parseGroup(!empty($options['group'])?$options['group']:''),
$this->parseHaving(!empty($options['having'])?$options['having']:''),
$this->parseOrder(!empty($options['order'])?$options['order']:''),
$this->parseLimit(!empty($options['limit'])?$options['limit']:''),
$this->parseUnion(!empty($options['union'])?$options['union']:''),
$this->parseLock(isset($options['lock'])?$options['lock']:false),
$this->parseComment(!empty($options['comment'])?$options['comment']:''),
$this->parseForce(!empty($options['force'])?$options['force']:'')
),$sql);
return $sql;
}
/**
* 连接分布式服务器
* @access protected
* @param boolean $master 主服务器
* @return void
*/
protected function multiConnect($master=false) {
// 分布式数据库配置解析
$_config['username'] = explode(',',$this->config['username']);
$_config['password'] = explode(',',$this->config['password']);
$_config['hostname'] = explode(',',$this->config['hostname']);
$_config['hostport'] = explode(',',$this->config['hostport']);
$_config['database'] = explode(',',$this->config['database']);
$_config['dsn']
= explode(',',$this->config['dsn']);
$_config['charset']
= explode(',',$this->config['charset']);
$m
= floor(mt_rand(0,$this->config['master_num']-1));
// 随机数据库的 读取
// 数据库读写是否分离
if($this->config['rw_separate']){
// 主从式采用读写分离
if($master)
// 主服务器写入
$r = $m;
else{
if(is_numeric($this->config['slave_no'])) {// 指定服务器读
$r = $this->config['slave_no'];
}else{
// 读操作连接从服务器
$r = floor(mt_rand($this->config['master_num'],count($_config['hostname'])-1)); // 每次随机连接的数据库
}
}
}else{
// 读写操作不区分服务器
$r = floor(mt_rand(0,count($_config['hostname'])-1)); // 每次随机连接的数据库
}
if($m != $r ){
$db_master = array(
'username' => isset($_config['username'][$m])?$_config['username'][$m]:$_config['username'][0],
'password' => isset($_config['password'][$m])?$_config['password'][$m]:$_config['password'][0],
'hostname' => isset($_config['hostname'][$m])?$_config['hostname'][$m]:$_config['hostname'][0],
'hostport' => isset($_config['hostport'][$m])?$_config['hostport'][$m]:$_config['hostport'][0],
'database' => isset($_config['database'][$m])?$_config['database'][$m]:$_config['database'][0],
'dsn'
=> isset($_config['dsn'][$m])?$_config['dsn'][$m]:$_config['dsn'][0],
'charset' => isset($_config['charset'][$m])?$_config['charset'][$m]:$_config['charset'][0],
);
}
$db_config = array(
'username' => isset($_config['username'][$r])?$_config['username'][$r]:$_config['username'][0],
'password' => isset($_config['password'][$r])?$_config['password'][$r]:$_config['password'][0],
'hostname' => isset($_config['hostname'][$r])?$_config['hostname'][$r]:$_config['hostname'][0],
'hostport' => isset($_config['hostport'][$r])?$_config['hostport'][$r]:$_config['hostport'][0],
'database' => isset($_config['database'][$r])?$_config['database'][$r]:$_config['database'][0],
'dsn'
=> isset($_config['dsn'][$r])?$_config['dsn'][$r]:$_config['dsn'][0],
'charset' => isset($_config['charset'][$r])?$_config['charset'][$r]:$_config['charset'][0],
);
return $this->connect($db_config,$r,$r == $m ? false : $db_master);
}
// 总结,其实貌似神秘的 没有什么神秘的地方?
// 就是更多了 那个 对应数据的一个转换封装,其它的 什么也没了
// 哦 忘了上面的那个 sql 的 分布式,跟后宫翻牌子是的,哈哈

// 结束了
}

企业建站2800元起,携手武汉肥猫科技,做一个有见地的颜值派!更多优惠请戳:天门SEO http://tianmen.4567w.com