[原创]简单快速有趣的MySQL数据库操作类：SimpleDB

自己写着玩的，代码没有测试，不过觉得思路不错，如果能够加上部分异常处理的功能，应该比较帅了，支持PHP4/PHP5，恩，虽然没有ADOdb或者PEAR::DB强，不错一般应用应该不错，恩。

喜欢的就自己拿去用吧，自己随便改，呵呵，也欢迎提意见。（注释遵循PHPDoc的标准，便于生成手册）

注意：代码未经测试，出现问题可要自己负责哇，呵呵。

<?
// ==========================================
//文件:SimpleDB.class.php
//程序:MySQL数据库操作类
//作者:heiyeluren<http://blog.csdn.net/heiyeshuwu
//时间:2006-09-20
//==========================================

class SimpleDB
{
/* *
*连接标识
*@varresource
*/
var $dbLink ;
/* *
*数据库查询语句
*@varstring
*/
var $dbSql ;
/* *
*查询结果
*@varresource
*/
var $dbResult ;
/* *
*查询记录集
*@vararray
*/
var $dbRecord ;
/* *
*数据库字符集
*@varstring
*/
var $dbCharset = ' GBK ' ;
/* *
*数据库结果集提取方式
*@varint
*/
var $fetchMode = MYSQL_ASSOC;
/* *
*日志保存路径
*@varstring
*/
var $logPath = ' /tmp/mysql_log ' ;

/* *
*是否记录SQL查询失败的SQL日志,缺省是false
*@varbool
*/
var $isLog = false ;
/* *
*是否在SQL查询出错的时候显示错误并且终止脚本执行,缺省是true
*
*@varbool
*/
var $isError = true ;


// --------------------------
//内部接口
//--------------------------
/* *
*构造函数
*
*@paramstring$db_host连接主机
*@paramstring$db_user连接用户
*@paramstring$db_passwd数据库密码
*@paramstring$db_name数据库
*@parambool$is_pconnect是否长连接,默认是否
*@returnSimpleDB
*/
function SimpleDB( $db_host , $db_user , $db_passwd , $db_name , $is_pconnect = false ){
$this -> connect( $db_host , $db_user , $db_passwd , $db_name , $is_pconnect );
}

/* *
*连接数据库
*
*@paramstring$db_host数据库主机地址,例如:localhost,或者localhost:3306
*@paramstring$db_user连接数据库的用户
*@paramstring$db_passwd用户密码
*@paramstring$db_name数据库名字
*@paramboo$is_pconnect是否使用长连接
*@returnresource返回连接资源标识符
*/
function connect( $db_host , $db_user , $db_passwd , $db_name , $is_pconnect ){
if ( $is_pconnect ){
return $this -> dbLink = @ mysql_pconnect ( $db_host , $db_user , $db_passwd );
}
$this -> dbLink = @ mysql_connect ( $db_host , $db_user , $db_passwd );
@ mysql_select_db ( $db_name , $this -> dbLink);
$mysql_version = $this -> getOne( " SELECTVERSION() " );
if ( $this -> dbCharset != '' && preg_match ( " /^(5.|4.1)/ " , $mysql_version )){
$this -> query( " SETNAMES'$this->dbCharset' " , $this -> dbLink);
}
return $this -> dbLink;
}

/* *
*关闭数据库连接
*
*@returnbool是否成功关闭连接
*/
function disconnect(){
$ret = @ mysql_close ( $this -> dbLink);
$this -> dbLink = null ;
return $ret ;
}

/* *
*设置查询结果返回数据类型
*
*@paramint$modeType设置查询结果返回设置,1为关联索引和数字所有都有,2为使用关联索引,3为使用数字索引
*/
function setFetchMode( $modeType ){
switch ( $modeType ){
case 1 : // 数字索引和关联索引都有
$this -> fetchMode = MYSQL_BOTH;
break ;
case 2 : // 使用关联索引
$this -> fetchMode = MYSQL_ASSOC;
break ;
case 3 : // 使用数字索引
$this -> fetchMode = MYSQL_NUM;
break ;
default : // 缺省使用关联索引
$this -> fetchMode = MYSQL_ASSOC;
}
}

/* *
*设置数据库客户端提取结果集的字符编码
*
*@paramstring$charset编码的字符串,比如UTF8,GBK之类的,缺省是GBK
*/
function setCharset( $charset ){
if ( $charset != '' ){
$this -> dbCharset = $charset ;
}
}

/* *
*设置日志存储路径
*
*@paramstring$log_path日志路径,该必须是可写的
*/
function setLogPath( $log_path ){
if ( $log_path != '' ){
$this -> logPath = $log_path ;
}
}

/* *
*写SQL执行日志
*
*@paramstring$sql查询的SQL语句
*@paramstring$file当前执行查询的文件
*/
function writeLog( $sql , $file ){
if ( ! file_exists ( $this -> logPath)){
@ mkdir ( $this -> logPath);
}
$log_file = $this -> logPath . " /mysql_ " . date ( " Y-m-d " ) . " .log " ;
$log_msg = " [ " . date ( " Y-m-dH:i:s " ) . " ]- " . $file . " : " . $sql . " " ;
error_log ( $log_msg , 3 , $log_file );
}

/* *
*显示上依次SQL执行错误的错误信息
*/
function showError(){
$errMessage = " MySQLqueryerror " . mysql_errno ( $this -> dbLink) . " : " . mysql_error ( $this -> dbLink);
die ( $errMessage );
}

/* *
*返回MySQL的版本信息
*
*@returnstringMysql的版本
*/
function getVersion(){
return $this -> getOne( " SELECTVERSION() " );
}

/* *
*查询操作的底层接口
*
*@paramstring$sql要执行查询的SQL语句
*@returnbool执行成功返回true,失败返回false
*/
function query( $sql ){
$this -> dbSql = $sql ;
$this -> dbResult = null ;
$this -> dbResult = @ mysql_query ( $sql , $this -> dbLink);
if ( $this -> dbResult === false ){
if ( $this -> isLog){
$this -> writeLog( $sql , __FILE__ );
}
if ( $this -> isError){
$this -> showError();
}
return false ;
}
return true ;
}


// --------------------------
//数据获取接口
//--------------------------
/* *
*获取SQL执行的全部结果集(二维数组)
*
*@paramstring$sql需要执行查询的SQL语句
*@return成功返回查询结果的二维数组,失败返回false
*/
function getAll( $sql ){
if ( ! $this -> query( $sql )){
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 false ;
}
return $this -> dbRecord;
}

/* *
*获取单行记录(一维数组)
*
*@paramstring$sql需要执行查询的SQL语句
*@return成功返回结果记录的一维数组,失败返回false
*/
function getRow( $sql ){
if ( ! $this -> query( $sql )){
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 false ;
}
return $this -> dbRecord;
}

/* *
*获取一列数据(一维数组)
*
*@paramstring$sql需要获取的字符串
*@paramstring$field需要获取的列,如果不指定,默认是第一列
*@return成功返回提取的结果记录的一维数组,失败返回false
*/
function getCol( $sql , $field = '' ){
if ( ! $this -> query( $sql )){
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 false ;
}
return $this -> dbRecord;
}

/* *
*获取一个数据(当条数组)
*
*@paramstring$sql需要执行查询的SQL
*@return成功返回获取的一个数据,失败返回false
*/
function getOne( $sql , $field = '' ){
if ( ! $this -> query( $sql )){
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 false ;
}
if ( trim ( $field ) != '' ){
$this -> dbRecord = $row [ $field ];
} else {
$this -> dbRecord = current ( $row );
}
return $this -> dbRecord;
}

/* *
*获取指定各种条件的记录
*
*@paramstring$table表名(访问的数据表)
*@paramstring$field字段(要获取的字段)
*@paramstring$where条件(获取记录的条件语句,不包括WHERE,默认为空)
*@paramstring$order排序(按照什么字段排序,不包括ORDERBY,默认为空)
*@paramstring$limit限制记录(需要提取多少记录,不包括LIMIT,默认为空)
*@parambool$single是否只是取单条记录(是调用getRow还是getAll,默认是false,即调用getAll)
*@return成功返回记录结果集的数组,失败返回false
*/
function getRecord( $table , $field = ' * ' , $where = '' , $order = '' , $limit = '' , $single = false ){
$sql = " SELECT$fieldFROM$table " ;
$sql .= trim ( $where ) != '' ? " WHERE$where " : $where ;
$sql .= trim ( $order ) != '' ? " ORDERBY$order " : $order ;
$sql .= trim ( $limit ) != '' ? " LIMIT$limit " : $limit ;
if ( $single ){
return $this -> getRow( $sql );
}
return $this -> getAll( $sql );
}

/* *
*获取指点各种条件的记录(跟getRecored类似)
*
*@paramstring$table表名(访问的数据表)
*@paramstring$field字段(要获取的字段)
*@paramstring$where条件(获取记录的条件语句,不包括WHERE,默认为空)
*@paramarray$order_arr排序数组(格式类似于:array('id'=>true),那么就是按照ID为顺序排序,array('id'=>false),就是按照ID逆序排序)
*@paramarray$limit_arr提取数据的限制数组()
*@returnunknown
*/
function getSpecifyRecord( $table , $field = ' * ' , $where = '' , $order_arr = array () , $limit_arr = array ()){
$sql = " SELECT$fieldFROM$table " ;
$sql .= trim ( $where ) != '' ? " WHERE$where " : $where ;
if ( is_array ( $order_arr ) && ! empty ( $order_arr )){
$arr_key = key ( $order_arr );
$sql .= " ORDERBY$arr_key " . ( $order_arr [ $arr_key ] ? " ASC " : " DESC " );
}
if ( is_array ( $limit_arr ) && ! empty ( $limit_arr )){
$start_post = intval ( array_shift ( $limit_arr ));
$offset = intval ( array_shift ( $limit_arr ));
$sql .= " LIMIT$start_post,$offset " ;
}
return $this -> getAll( $sql );
}

/* *
*获取指定条数的记录
*
*@paramstring$table表名
*@paramint$start_pos开始记录
*@paramint$offset偏移量
*@paramstring$field字段名
*@paramstring$where条件(获取记录的条件语句,不包括WHERE,默认为空)
*@paramstring$order排序(按照什么字段排序,不包括ORDERBY,默认为空)
*@return成功返回包含记录的二维数组,失败返回false
*/
function getLimitRecord( $table , $start_pos , $offset , $field = ' * ' , $where = '' , $oder = '' ){
$sql = " SELECT$fieldFROM$table " ;
$sql .= trim ( $where ) != '' ? " WHERE$where " : $where ;
$sql .= trim ( $order ) != '' ? " ORDERBY$order " : $order ;
$sql .= " LIMIT$start_pos,$offset " ;
return $this -> getAll( $sql );
}

/* *
*获取排序记录
*
*@paramstring$table表名
*@paramstring$order_field需要排序的字段(比如id)
*@paramstring$order_method排序的方式(1为顺序,2为逆序,默认是1)
*@paramstring$field需要提取的字段(默认是*,就是所有字段)
*@paramstring$where条件(获取记录的条件语句,不包括WHERE,默认为空)
*@paramstring$limit限制记录(需要提取多少记录,不包括LIMIT,默认为空)
*@return成功返回记录的二维数组,失败返回false
*/
function getOrderRecord( $table , $order_field , $order_method = 1 , $field = ' * ' , $where = '' , $limit = '' ){
// $order_method的值为1则为顺序,$order_method值为2则2则是逆序排列
$sql = " SELECT$fieldFROM$table " ;
$sql .= trim ( $where ) != '' ? " WHERE$where " : $where ;
$sql .= " ORDERBY$order_field " . ( $order_method == 1 ? " ASC " : " DESC " );
$sql .= trim ( $limit ) != '' ? " LIMIT$limit</sp

分享到：

How Does it End()? | Ruby之symbol研究

• 2006-09-21 13:37
• 浏览 179
• 评论(0)
• 相关推荐

评论

发表评论

您还没有登录,请您登录后再发表评论