[原创] MySQL Master/Slave数据库读写操作类 (2009/11/17 updated)

两年前写了一个 Master/Slave 的PHP操作类，一直没有更新，今天更新了一下。

2006/09/20 简单快速有趣的MySQL数据库操作类：SimpleDB

2007/07/30 构建支持Master/Slave读写分离的数据库操作类

2009/11/17 MySQL Master/Slave数据库读写操作类 (2009/11/17 updated)

// 开发作者: heiyeluren
// 版本历史:
//2006-09-20 基本单数据库操作功能, 25 个接口
//2007-07-30 支持单Master/多Slave数据库操作，29个接口
//2008-09-07 修正了上一版本的部分Bug
//2009-11-17在Master/Slave类的基础上增加了强化单主机操作，
// 增加了部分简洁操作接口和调试接口，优化了部分代码，
// 本版本共42个接口

数据库操作类：DBCommon.class.php

<?php //--------------------------------------------------------------------- // MySQL Master/Slave数据库读写操作类 // // 开发作者: hualiangxie // 版本历史: // 2006-09-20 基本单数据库操作功能, 25 个接口 // 2007-07-30 支持单Master/多Slave数据库操作，29个接口 // 2008-09-07 修正了上一版本的部分Bug // 2009-11-17 在Master/Slave类的基础上增加了强化单主机操作， // 增加了部分简洁操作接口和调试接口，优化了部分代码， // 本版本共42个接口 // 2009-11-26 增加了部分调试和性能监控接口 // 应用项目: Y!NCP, Y!SNS, TM MiniSite // 功能描述：自动支持Master/Slave 读/写 分离操作，支持多Slave主机 // //----------------------------------------------------------------------- /** * 常量定义 */ define("_DB_COMMON_INSERT", 1); define("_DB_COMMON_UPDATE", 2); /** * DB Common class * * 描述：能够分别处理一台Master写操作，多台Slave读操作 */ class DBCommon { /** * 数据库配置信息 */ var $wdbConf = array(); var $rdbConf = array(); /** * Master数据库连接 */ var $wdbConn = null; /** * Slave数据库连接 */ var $rdbConn = array(); /** * 当前操作的数据库链接 */ var $currConn = null; /** * 是否只有一台Master数据库服务器 */ var $singleHost = true; /** * 数据库结果 */ var $dbResult; /** * 数据库查询结果集 */ var $dbRecord; /** * SQL语句 */ var $dbSql; /** * 数据库编码 */ var $dbCharset = "UTF8"; /** * 数据库版本 */ var $dbVersion = "5.0"; /** * 初始化的时候是否要连接到数据库 */ var $isInitConn = false; /** * 是否要设置字符集 */ var $isCharset = false; /** * 数据库结果集提取方式 */ var $fetchMode = MYSQL_ASSOC; /** * 执行中发生错误是否记录日志 */ var $isLog = false; /** * 执行中的SQL是否记录，设定级别 * * 0:不记录 * 1:记录insert * 2:记录insert/update * 3:记录insert/update/delete * 4:记录select/insert/update/delete */ var $logSqlLevel = 0; /** * 记录Log文件路径 */ var $logFile = '/tmp/db_common_error.log'; /** * 是否查询出错的时候终止脚本执行 */ var $isExit = false; /** * MySQL执行是否出错了 */ var $isError = false; /** * MySQL执行错误消息 */ var $errMsg = ''; /** * 是否记录SQL运行时间 */ var $isRuntime = true; /** * SQL执行时间 */ var $runTime = 0; //------------------------ // // 类本身操作方法 // //------------------------ /** * 设置类属性 * * @param str $key 需要设置的属性名 * @param str $value 需要设置的属性值 * @return void */ function set($key, $value){ $this->$key = $value; } /** * 读取类属性 * * @param str $key 需要读取的属性名 * @return void */ function get($key){ return $this->$key; } //------------------------ // // 基础底层操作接口 // //------------------------ /** * 构造函数 * * 传递配置信息，配置信息数组结构： * $masterConf = array( * "host" => Master数据库主机地址 * "user" => 登录用户名 * "pwd" => 登录密码 * "db" => 默认连接的数据库 * ); * $slaveConf = array( * "host" => Slave1数据库主机地址|Slave2数据库主机地址|... * "user" => 登录用户名 * "pwd" => 登录密码 * "db" => 默认连接的数据库 * ); * * @param bool $singleHost 是否只有一台主机 * @return void */ function DBCommon($masterConf, $slaveConf=array(), $singleHost = true){ //构造数据库配置信息 if (is_array($masterConf) && !empty($masterConf)){ $this->wdbConf = $masterConf; } if (!is_array($slaveConf) || empty($slaveConf)){ $this->rdbConf = $masterConf; } else { $this->rdbConf = $slaveConf; } $this->singleHost = $singleHost; //初始化连接（一般不推荐） if ($this->isInitConn){ $this->getDbWriteConn(); if (!$this->singleHost){ $this->getDbReadConn(); } } } /** * 获取Master的写数据连接 */ function getDbWriteConn(){ //判断是否已经连接 if ($this->wdbConn && is_resource($this->wdbConn)) { return $this->wdbConn; } //没有连接则自行处理 $db = $this->connect($this->wdbConf['host'], $this->wdbConf['user'], $this->wdbConf['pwd'], $this->wdbConf['db']); if (!$db || !is_resource($db)) { return false; } $this->wdbConn = $db; return $this->wdbConn; } /** * 获取Slave的读数据连接 */ function getDbReadConn(){ //如果有可用的Slave连接，随机挑选一台Slave if (is_array($this->rdbConn) && !empty($this->rdbConn)) { $key = array_rand($this->rdbConn); if (isset($this->rdbConn[$key]) && is_resource($this->rdbConn[$key])) { return $this->rdbConn[$key]; } } //连接到所有Slave数据库，如果没有可用的Slave机则调用Master $arrHost = explode("|", $this->rdbConf['host']); if (!is_array($arrHost) || empty($arrHost)){ return $this->getDbWriteConn(); } $this->rdbConn = array(); foreach($arrHost as $tmpHost){ $db = $this->connect($tmpHost, $this->rdbConf['user'], $this->rdbConf['pwd'], $this->rdbConf['db']); if ($db && is_resource($db)){ $this->rdbConn[] = $db; } } //如果没有一台可用的Slave则调用Master if (!is_array($this->rdbConn) || empty($this->rdbConn)){ $this->errorLog("Not availability slave db connection, call master db connection"); return $this->getDbWriteConn(); } //随机在已连接的Slave机中选择一台 $key = array_rand($this->rdbConn); if (isset($this->rdbConn[$key]) && is_resource($this->rdbConn[$key])){ return $this->rdbConn[$key]; } //如果选择的slave机器是无效的，并且可用的slave机器大于一台则循环遍历所有能用的slave机器 if (count($this->rdbConn) > 1){ foreach($this->rdbConn as $conn){ if (is_resource($conn)){ return $conn; } } } //如果没有可用的Slave连接，则继续使用Master连接 return $this->getDbWriteConn(); } /** * 连接到MySQL数据库公共方法 */ function connect($dbHost, $dbUser, $dbPasswd, $dbDatabase){ //连接数据库主机 $db = mysql_connect($dbHost, $dbUser, $dbPasswd); if (!$db) { $this->errorLog("Mysql connect ". $dbHost ." failed"); return false; } //选定数据库 if (!mysql_select_db($dbDatabase, $db)) { $this->errorLog("select db $dbDatabase failed", $db); return false; } //设置字符集 if ($this->isCharset){ if ( $this->dbVersion == '' ){ $res = mysql_query("SELECT VERSION()"); $this->dbVersion = mysql_result($res, 0); } if ($this->dbCharset!='' && preg_match("/^(5.|4.1)/", $this->dbVersion)){ if (mysql_query("SET NAMES '".$this->dbCharset."'", $db) === false){ $this->errorLog("Set db_host '$dbHost' charset=". $this->dbCharset ." failed.", $db); return false; } } } return $db; } /** * 关闭数据库连接 */ function disconnect($dbConn=null, $closeAll=false){ //关闭指定数据库连接 if ($dbConn && is_resource($dbConn)){ mysql_close($dbConn); $dbConn = null; } //关闭所有数据库连接 if ($closeAll){ if ($this->rdbConn && is_resource($this->rdbConn)){ mysql_close($this->rdbConn); $this->rdbConn = null; } if (is_array($this->rdbConn) && !empty($this->rdbConn)){ foreach($this->rdbConn as $conn){ if ($conn && is_resource($conn)){ mysql_close($conn); } } $this->rdbConn = array(); } } return true; } /** * 选择数据库 */ function selectDb($dbName, $dbConn=null){ //重新选择一个连接的数据库 if ($dbConn && is_resource($dbConn)){ if (!mysql_select_db($dbName, $dbConn)){ $this->errorLog("Select database:$dbName failed.", $dbConn); return false; } return true; } //重新选择所有连接的数据库 if ($this->wdbConn && is_resource($this->wdbConn)){ if (!mysql_select_db($dbName, $this->wdbConn)){ $this->errorLog("Select database:$dbName failed.", $this->wdbConn); return false; } } if (is_array($this->rdbConn && !empty($this->rdbConn))){ foreach($this->rdbConn as $conn){ if ($conn && is_resource($conn)){ if (!mysql_select_db($dbName, $conn)){ $this->errorLog("Select database:$dbName failed.", $conn); return false; } } } } return true; } /** * 执行SQL语句（底层操作） */ function _query($sql, $isMaster=false){ if (trim($sql) == ""){ $this->errorLog("Sql query is empty."); return false; } //是否只有一台数据库机器 if ($this->singleHost){ $isMaster = true; } //获取执行SQL的数据库连接 if (!$isMaster){ $optType = trim(strtolower(substr(ltrim($sql), 0, 6))); } if ($isMaster || $optType!="select"){ $dbConn = $this->getDbWriteConn(); } else { $dbConn = $this->getDbReadConn(); } if (!$dbConn || !is_resource($dbConn)){ $this->isError = true; $this->errMsg = 'Not availability db connection.'; $this->currConn = null; $this->errorLog("Not availability db connection. Query SQL:". $sql); if ($this->isExit) { exit; } return false; } //记录执行的SQL if ($this->logSqlLevel){ $isLog = false; $logLevel = $this->logSqlLevel; if ($logLevel==1 && in_array($optType, array('insert'))){ $isLog = true; } if ($logLevel==2 && in_array($optType, array('insert', 'update'))){ $isLog = true; } if ($logLevel==3 && in_array($optType, array('insert', 'update', 'delete'))){ $isLog = true; } if ($logLevel==4 && in_array($optType, array('insert', 'update', 'delete', 'select'))){ $isLog = true; } if ($isLog){ $this->errorLog($sql); } } //执行查询 $this->currConn = $dbConn; $this->dbSql = $sql; $this->dbResult = null; if ($this->isRuntime){ $startTime = $this->getTime(); $this->dbResult = @mysql_query($sql, $dbConn); $this->runTime = $this->getTime() - $startTime; } else { $this->dbResult = @mysql_query($sql, $dbConn); } if ($this->dbResult === false){ $this->isError = true; $this->errMsg = 'MySQL errno:'. mysql_errno($dbConn) .', error:'. mysql_error($dbConn); $this->errorLog("Query sql failed. SQL:".$sql, $dbConn); if ($this->isExit) { exit; } return false; } $this->isError = false; $this->errMsg = ''; return true; } /** * 错误日志 */ function errorLog($msg='', $conn=null){ if (!$this->isLog){ return; } if ($msg=='' && !$conn) { return false; } $log = "MySQL Error: $msg"; if ($conn && is_resource($conn)) { $log .= " mysql_msg:". mysql_error($conn); } $log .= " [". date("Y-m-d H:i:s") ."]"; if ($this->logFile != ''){ error_log($log ."/n", 3, $this->logFile); } else { error_log($log); } return true; } //-------------------------- // // 数据获取接口 // //-------------------------- /** * 获取SQL执行的全部结果集(二维数组) * * @param string $sql 需要执行查询的SQL语句 * @return 成功返回查询结果的二维数组,失败返回false, 数据空返回NULL */ function getAll($sql, $isMaster=false){ if (!$this->_query($sql, $isMaster)){ return false; } $this->dbRecord = array(); while ($row = @mysql_fetch_array($this->dbResult, $this->fetchMode)) { $this->dbRecord[] = $row; } @mysql_free_result($this->dbResult); if (!is_array($this->dbRecord) || empty($this->dbRecord)){ return NULL; } return $this->dbRecord; } /** * 获取单行记录(一维数组) * * @param string $sql 需要执行查询的SQL语句 * @return 成功返回结果记录的一维数组,失败返回false, 数据空返回NULL */ function getRow($sql, $isMaster=false){ if (!$this->_query($sql, $isMaster)){ return false; } $this->dbRecord = array(); $this->dbRecord = @mysql_fetch_array($this->dbResult, $this->fetchMode); @mysql_free_result($this->dbResult); if (!is_array($this->dbRecord) || empty($this->dbRecord)){ return NULL; } return $this->dbRecord; } /** * 获取一列数据(一维数组) * * @param string $sql 需要获取的字符串 * @param string $field 需要获取的列,如果不指定,默认是第一列 * @return 成功返回提取的结果记录的一维数组,失败返回false, 数据空返回NULL */ function getCol($sql, $field='', $isMaster=false){ if (!$this->_query($sql, $isMaster)){ return false; } $this->dbRecord = array(); while($row = @mysql_fetch_array($this->dbResult, $this->fetchMode)){ if (trim($field) == ''){ $this->dbRecord[] = current($row); } else { $this->dbRecord[] = $row[$field]; } } @mysql_free_result($this->dbResult); if (!is_array($this->dbRecord) || empty($this->dbRecord)){ return NULL; } return $this->dbRecord; } /** * 获取一个数据(当条数组) * * @param string $sql 需要执行查询的SQL * @return 成功返回获取的一个数据,失败返回false, 数据空返回NULL */ function getOne($sql, $field='', $isMaster=false){ if (!$this->_query($sql, $isMaster)){ return false; } $this->dbRecord = array(); $row = @mysql_fetch_array($this->dbResult, $this->fetchMode); @mysql_free_result($this->dbResult); if (!is_array($row) || empty($row)){ return NULL; } if (trim($field) != ''){ $this->dbRecord = $row[$field]; }else{ $this->dbRecord = current($row); } return $this->dbRecord; } /** * 获取指定各种条件的记录 * * @param string $table 表名(访问的数据表) * @param string $field 字段(要获取的字段) * @param string $where 条件(获取记录的条件语句,不包括WHERE,默认为空) * @param string $order 排序(按照什么字段排序,不包括ORDER BY,默认为空) * @param string $limit 限制记录(需要提取多少记录,不包括LIMIT,默认为空) * @param bool $single 是否只是取单条记录(是调用getRow还是getAll,默认是false,即调用getAll) * @return 成功返回记录结果集的数组,失败返回false */ function getRecord($table, $field='*', $where='', $order='', $limit='', $single=false, $isMaster=false){ $sql = "SELECT $field FROM $table"; $sql .= trim($where)!='' ? " WHERE $where " : $where; $sql .= trim($order)!='' ? " ORDER BY $order " : $order; $sql .= trim($limit)!='' ? " LIMIT $limit " : $limit; if ($single){ return $this->getRow($sql, $isMaster); } return $this->getAll($sql, $isMaster); } /** * 获取指点各种条件的记录(跟getRecored类似) * * @param string $table 表名(访问的数据表) * @param string $field 字段(要获取的字段) * @param string $where 条件(获取记录的条件语句,不包括WHERE,默认为空) * @param array $order_arr 排序数组(格式类似于: array('id'=>true), 那么就是按照ID为顺序排序, array('id'=>false), 就是按照ID逆序排序) * @param array $limit_arr 提取数据的限制数组() * @return unknown */ function getRecordByWhere($table, $field='*', $where='', $arrOrder=array(), $arrLimit=array(), $isMaster=false){ $sql = " SELECT $field FROM $table "; $sql .= trim($where)!='' ? " WHERE $where " : $where; if (is_array($arrOrder) && !empty($arrOrder)){ $arrKey = key($arrOrder); $sql .= " ORDER BY $arrKey " . ($arrOrder[$arrKey] ? "ASC" : "DESC"); } if (is_array($arrLimit) && !empty($arrLimit)){ $startPos = intval(array_shift($arrLimit)); $offset = intval(array_shift($arrLimit)); $sql .= " LIMIT $startPos,$offset "; } return $this->getAll($sql, $isMaster); } /** * 获取指定条数的记录 * * @param string $table 表名 * @param int $startPos 开始记录 * @param int $offset 偏移量 * @param string $field 字段名 * @param string $where 条件(获取记录的条件语句,不包括WHERE,默认为空) * @param string $order 排序(按照什么字段排序,不包括ORDER BY,默认为空) * @return 成功返回包含记录的二维数组,失败返回false */ function getRecordByLimit($table, $startPos, $offset, $field='*', $where='', $oder='', $isMaster=false){ $sql = " SELECT $field FROM $table "; $sql .= trim($where)!='' ? " WHERE $where " : $where; $sql .= trim($order)!='' ? " ORDER BY $order " : $order; $sql .= " LIMIT $startPos,$offset "; return $this->getAll($sql, $isMaster); } /** * 获取排序记录 * * @param string $table 表名 * @param string $orderField 需要排序的字段(比如id) * @param string $orderMethod 排序的方式(1为顺序, 2为逆序, 默认是1) * @param string $field 需要提取的字段(默认是*,就是所有字段) * @param string $where 条件(获取记录的条件语句,不包括WHERE,默认为空) * @param string $limit 限制记录(需要提取多少记录,不包括LIMIT,默认为空) * @return 成功返回记录的二维数组,失败返回false */ function getRecordByOrder($table, $orderField, $orderMethod=1, $field='*', $where='', $limit='', $isMaster=false){ //$order_method的值为1则为顺序, $order_method值为2则2则是逆序排列 $sql = " SELECT $field FROM $table "; $sql .= trim($where)!='' ? " WHERE $where " : $where; $sql .= " ORDER BY $orderField " . ( $orderMethod==1 ? "ASC" : "DESC"); $sql .= trim($limit)!='' ? " LIMIT $limit " : $limit; return $this->getAll($sql, $isMaster); } /** * 分页查询(限制查询的记录条数) * * @param string $sql 需要查询的SQL语句 * @param int $startPos 开始记录的条数 * @param int $offset 每次的偏移量,需要获取多少条 * @return 成功返回获取结果记录的二维数组,失败返回false */ function limit_query($sql, $startPos, $offset, $isMaster=false){ $start_pos = intval($startPos); $offset = intval($offset); $sql = $sql . " LIMIT $startPos,$offset "; return $this->getAll($sql, $isMaster); } //-------------------------- // // 无数据返回操作接口 // //-------------------------- /** * 执行执行非Select查询操作 * * @param string $sql 查询SQL语句 * @return bool 成功执行返回true, 失败返回false */ function execute($sql, $isMaster=false){ if (!$this->_query($sql, $isMaster)){ return false; } return true; /*$count = @mysql_affected_rows($this->dbLink); if ($count <= 0){ return false; } return true;*/ } /** * 自动执行操作(针对Insert/Update操作) * * @param string $table 表名 * @param array $field_array 字段数组(数组中的键相当于字段名,数组值相当于值, 类似 array( 'id' => 100, 'user' => 'heiyeluren') * @param int $mode 执行操作的模式 (是插入还是更新操作, 1是插入操作Insert, 2是更新操作Update) * @param string $where 如果是更新操作,可以添加WHERE的条件 * @return bool 执行成功返回true, 失败返回false */ function autoExecute($table, $arrField, $mode, $where='', $isMaster=false){ if ($table=='' || !is_array($arrField) || empty($arrField)){ return false; } //$mode为1是插入操作(Insert), $mode为2是更新操作 if ($mode == 1){ $sql = " INSERT INTO `$table` SET "; } elseif ($mode == 2) { $sql = " UPDATE `$table` SET "; } else { $this->errorLog("Operate type '$mode' is error, in call DB::autoExecute process table $table."); return false; } foreach ($arrField as $key => $value){ $sql .= "`$key`='$value',"; } $sql = rtrim($sql, ','); if ($mode==2 && $where!=''){ $sql .= "WHERE $where"; } return $this->execute($sql, $isMaster); } /** * 锁表表 * * @param string $tblName 需要锁定表的名称 * @return mixed 成功返回执行结果，失败返回错误对象 */ function lockTable($tblName){ return $this->_query("LOCK TABLES $tblName", true); } /** * 对锁定表进行解锁 * * @param string $tblName 需要锁定表的名称 * @return mixed 成功返回执行结果，失败返回错误对象 */ function unlockTable($tblName){ return $this->_query("UNLOCK TABLES $tblName", true); } /** * 设置自动提交模块的方式（针对InnoDB存储引擎） * 一般如果是不需要使用事务模式，建议自动提交为1，这样能够提高InnoDB存储引擎的执行效率，如果是事务模式，那么就使用自动提交为0 * * @param bool $autoCommit 如果是true则是自动提交，每次输入SQL之后都自动执行，缺省为false * @return mixed 成功返回true，失败返回错误对象 */ function setAutoCommit($autoCommit = false){ $autoCommit = ( $autoCommit ? 1 : 0 ); return $this->_query("SET AUTOCOMMIT = $autoCommit", true); } /** * 开始一个事务过程（针对InnoDB引擎，兼容使用 BEGIN 和 START TRANSACTION） * * @return mixed 成功返回true，失败返回错误对象 */ function startTransaction(){ if (!$this->_query("BEGIN")){ return $this->_query("START TRANSACTION", true); } } /** * 提交一个事务（针对InnoDB存储引擎） * * @return mixed 成功返回true，失败返回错误对象 */ function commit(){ if (!$this->_query("COMMIT", true)){ return false; } return $this->setAutoCommit( true ); } /** * 发生错误，会滚一个事务（针对InnoDB存储引擎） * * @return mixed 成功返回true，失败返回错误对象 */ function rollback(){ if (!$this->_query("ROLLBACK", true)){ return false; } return $this->setAutoCommit( true ); } //-------------------------- // // 其他数据操作接口 // //-------------------------- /** * 获取上次插入操作的的ID * * @return int 如果没有连接或者查询失败,返回0, 成功返回ID */ function getLastId(){ $dbConn = $this->getDbWriteConn(); if (($lastId = mysql_insert_id($dbConn)) > 0){ return $lastId; } return $this->getOne("SELECT LAST_INSERT_ID()", '', true); } /** * 获取记录集里面的记录条数 (用于Select操作) * * @return int 如果上一次无结果集或者记录结果集为空,返回0, 否则返回结果集数量 */ function getNumRows($res=null){ if (!$res || !is_resource($res)){ $res = $this->dbResult; } return mysql_num_rows($res); } /** * 获取受到影响的记录数量 (用于Update/Delete/Insert操作) * * @return int 如果没有连接或者影响记录为空, 否则返回影响的行数量 */ function getAffectedRows(){ $dbConn = $this->getDbWriteConn(); if ( ($affetedRows = mysql_affected_rows($dbConn)) <= 0){ return $affetedRows; } return $this->getOne("SELECT ROW_COUNT()", "", true); } //-------------------------- // // 相应配合操作接口 // //-------------------------- /** * 获取最后一次查询的SQL语句 * * @return string 返回最后一次查询的SQL语句 */ function getLastSql(){ return $this->dbSql; } /** * 返回SQL最后操作的数据库记录结果集 * * @return mixed 最后结果集，可能是数组或者普通单个元素值 */ function getDBRecord(){ return $this->dbRecord; } /** * 获取当前操作的数据库连接资源 * * @return resouce 返回当前正在执行操作的数据库链接资源 */ function getCurrConnection(){ return $this->currConn; } /** * SQL 执行是否出错 * * @return bool */ function isError(){ return $this->isError; } /** * SQL 执行错误消息 * * @return string */ function getError(){ return $this->errMsg; } /** * 获取执行时间 * * @return float */ function getRunTime(){ if ($this->isRuntime){ return sprintf("%.6f sec",$this->runTime); } return 'NULL'; } /** * 获取当前时间函数 * * @param void * @return float $time */ function getTime(){ list($usec, $sec) = explode(" ", microtime()); return ((float)$usec + (float)$sec); } //-------------------------- // // 开发调试监控接口 // //-------------------------- /** * 调试信息内部输出接口 * * @param string $title 需要输出的标题 * @param array $index 需要输出的内容数组（二维数组） * @return void */ function _debug_print_table($title, $index, $content_pre = false){ echo "<b>".$title."</b>/n"; //二维数组 if (isset($index[0])){ echo "<table border=1 width=1000><tr bgcolor=#D0D0D0>"; foreach($index[0] as $k => $v){ echo "<td>$k</td>"; } echo "</tr>"; foreach($index as $v){ echo "<tr>"; foreach($v as $_v){ $_v = $_v == NULL ? '&nbsp;' : $_v; echo !$content_pre ? "<td>$_v</td>" : "<td><pre>$_v</pre></td>"; } echo "</tr>"; } echo "</tr></table><br /><br />"; } //一维数组 else { echo "<table border=1 width=1000><tr bgcolor=#D0D0D0>"; foreach($index as $k => $v){ echo "<td>$k</td>"; } echo "</tr><tr>"; foreach($index as $k => $v){ $v = $v == NULL ? '&nbsp;' : $v; echo !$content_pre ? "<td>$v</td>" : "<td><pre>$v</pre></td>"; } echo "</tr></table><br /><br />"; } } /** * 输出数据表结构信息 * * @param void * @return void */ function debug_table_info($table_name = ''){ $curr_sql = $this->getLastSql(); //SQL性能信息 echo "<br /><br /><hr size=1>"; $explain = $this->getAll("explain ".$curr_sql); if (!empty($explain)){ $this->_debug_print_table('SQL Explain:', $explain); } //总体SQL详细操作性能信息 $version = $this->getOne("select version()"); if (preg_match("/^(5.)/", $version) && substr($version,0,6) >= '5.0.37'){ if ($this->execute("set profiling = 1")){ $this->execute($curr_sql); $index = $this->getAll("show profile cpu,block io,memory,swaps for query 1"); $this->execute("set profiling = 0"); $this->_debug_print_table("SQL Performance Profiling:", $index); $index = $this->getAll("show profiles"); $this->_debug_print_table("", $index); } } //获取刚才操作的表名 $table_name = isset($explain[0]) ? $explain[0]['table'] : $explain['table']; if ($table_name == ''){ return; } //索引列表 $index = $this->getAll("show index from $table_name"); $this->_debug_print_table("Table '$table_name' Index:", $index); //表结构 $index = $this->getAll("desc $table_name"); $this->_debug_print_table("Table '$table_name' Fileds:", $index); //创建表语句 $explain = $this->getRow("show create table $table_name"); if (!empty($explain)){ $this->_debug_print_table("Table '$table_name' Create:", $explain, true); } } /** * 输出数据库服务器运行信息 * * @param void * @return void */ function debug_server_info(){ echo "<br /><br /><hr size=1><br />"; //进程信息 $index = $this->getAll("show full processlist"); $this->_debug_print_table("Database Process List", $index); //变量信息 $index = $this->getAll("show global variables"); $this->_debug_print_table("Database Variables List", $index); //状态信息 $index = $this->getAll("show global status"); $this->_debug_print_table("Database Status Info", $index); //服务器打开表信息 $index = $this->getAll("show open tables"); $this->_debug_print_table("Database Open tables List", $index); } /** * 输出所有类属性和值 * * @return void */ function debug_class_var(){ $class = get_class($this); //其他类属性 echo "<br /><b>$class Attribute:</b> <pre>/n"; echo "<hr size=1><br /><br />"; $vars = get_object_vars($this); print_r($vars); echo "</pre>/n<br /><br />"; } /** * 输出所有类方法名 * * @return void */ function debug_class_method() { $class = get_class($this); $arr = get_class_methods($class); echo "<h3>$class method list</h3><br />/n"; foreach ($arr as $method) { echo "/t $method() <br />/n"; } } /** * 输出所有类属性和SQL * * @param bool $format 使用哪种打印方式， false为 print_r, true为var_dump * @return void */ function debug_sql_info(){ //基本信息 $mysql_err = $this->getError() == '' ? 'NULL' : $this->getError(); echo "<h3>DBCommon Debug info</h3> <hr size=1><br />/n"; echo "<b>Execute SQL&nbsp;: </b> ". $this->getLastSql() ." <br />/n"; echo "<b>MySQL Error&nbsp;: </b> ". $mysql_err ." <br />/n"; echo "<b>SQL Runtime&nbsp;: </b> ". $this->getRunTime() ." <br />/n"; } /** * 调试函数 * * @param bool $format 使用哪种打印方式， false为 print_r, true为var_dump * @return void */ function debug($level = 1){ switch($level){ case 0: $this->debug_class_var(); $this->debug_class_method(); break; case 1: $this->debug_sql_info(); break; case 2: $this->debug_sql_info(); $this->debug_table_info(); break; case 3: $this->debug_sql_info(); $this->debug_table_info(); $this->debug_server_info(); break; default: $this->debug_sql_info(); } } /** * 调试函数: 打印类属性 * * @param void * @return void */ function v(){ $this->debug_class_var(); } /** * 调试函数: 打印类方法 * * @param void * @return void */ function m(){ $this->debug_class_method(); } //-------------------------------- // // 兼容 TMService 的简洁接口 // //-------------------------------- /** * 查询结果：二维数组返回 * * @param string $sql 需要执行的SQL * @return 成功返回获取的二维数组,失败返回false, 数据空返回NULL */ function query($sql){ $optType = trim(strtolower(substr(ltrim($sql), 0, 6))); if (in_array($optType, array('update', 'insert', 'delete'))){ return $this->execute($sql); } return $this->getAll($sql); } /** * 插入数据 * * @param array $field_array 字段数组(数组中的键相当于字段名,数组值相当于值, 类似 array( 'id' => 100, 'user' => 'heiyeluren') * @param string $table 表名 * @return bool 执行成功返回true, 失败返回false */ function insert($arrField, $table){ return $this->autoExecute($table, $arrField, 1); } /** * 更新数据 * * @param array $field_array 字段数组(数组中的键相当于字段名,数组值相当于值, 类似 array( 'id' => 100, 'user' => 'heiyeluren') * @param string $table 表名 * @param string $where 如果是更新操作,可以添加WHERE的条件 * @return bool 执行成功返回true, 失败返回false */ function update($arrField, $where, $table){ if (trim($where) == ''){ return false; } return $this->autoExecute($table, $arrField, 2, $where); } /** * 获取某个表的Count * * @param array $arrField 需要处理的where条件的key，value * @param string $table 需要获取的表名 * @return 成功返回获取的一个整数值,失败返回false, 数据空返回NULL */ function getCount($arrField, $notFields, $table){ $sql = "SELECT COUNT(1) as cnt FROM ".$table." WHERE "; foreach ($arrField as $key => $value) { $sql .= " `$key`='$value' AND "; } if (!empty($notFields)) { foreach ($arrField as $key => $value) { $sql .= " `$key`!='$value' AND "; } } $sql .= " 1 "; $row = $this->getOne($sql); if ($row===NULL || $row===false){ return $row; } if (is_array($row)){ return (int)current($row); } return (int)$row; } } ?>

调用上面数据库操作对象：

/** * 工厂模式对象获取 * */ class common { /** * 数据库单例对象 */ public static $db = NULL; /** * 获取数据库对象 * * * 数据库使用示例和介绍： $db = common::getDB(); //简洁接口 $db->query($sql); //查询，二维数组 (兼容TM) $db->insert($arr, $table); //插入数据 (兼容TM) $db->update($arr, $where, $table); //更新数据 (兼容TM) $db->getCount($arr, $notfield, $table); //获取数量 (兼容TM) //基本数据操作接口 $db->getAll($sql); //读取所有数据，二维数组 $db->getRow($sql); //读取一行记录，一维数组 $db->getCol($sql); //读取一列记录，一维数组 $db->getOne($sql); //获取单个单元值 $db->execute($sql); //纯执行SQL，返回true或false $db->getNumRows(); //获取上一次select操作记录结果集总数 $db->getAffectedRows(); //获取上个操作影响的行数 //方便开发调试接口 $db->debug(); //打印调试信息 $db->isError(); //SQL是否执行错误，true为有错误，false为没有错误 $db->getError(); //SQL执行错误消息 $db->getLastSql(); //获取最后一条执行的SQL $db->getCurrConnection(); //获取当前数据库连接，方便直接自主操作MySQL */ public static function getDB(){ if (is_object(self::$db)){ return self::$db; } $cryption = new TMCryption(); $config = array( "host" => 'localhost', "user" => 'root', "pwd" => '', "db" => 'test', ); self::$db = new DBCommon($config, array(), true); self::$db->set('isCharset', false); self::$db->query("SET NAMES utf8"); return self::$db; } }