摘要:本文为PHP数据库操作类ADODB 详解<二>
1.GetAll方法
我们可以使用GetAll方法代替Execute()方法,该方法返回的结果为一个二维关联数据,这样可以使用foreach或for循环语句处理,非常方便。另外,GetAll取得的数组与Smarty模板的foreach配合得非常好。
我们一起看下面的脚本例子:
<?php
include_once("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "root", "library") or die("Unable to connect");
// 构造并执行一个查询
$query = "SELECT * FROM library";
$result = $db->GetAll($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 清除无用的对象
$db->Close();
// 可以使用print_r打印该数组的内容
// print_r($result); exit(0);
// 遍历记录集,显示列的内容:TITLE 和AUTHOR
foreach ($result as $row){
echo $row[1] . " - " . $row[2] . "\n";
}
// 取得和显示返回的记录行数
echo "\n[" . sizeof($result) . " 行记录被返回]\n";
?>
GetAll()方法取得记录集后,产生一个二维数组,类似于下面的样子:
Array
(
[0] => Array
(
[0] => 14
[id] => 14
[1] => Mystic River
[title] => Mystic River
[2] => Dennis Lehane
[author] => Dennis Lehane
)
[1] => Array
(
[0] => 15
[id] => 15
[1] => For Kicks
[title] => For Kicks
[2] => Dick Francis
[author] => Dick Francis
)
//下略
)
我们在数组一章,提到过这类混合数组最适合用foreach来处理。这种方法是对Execute()方法的补充或替代,尤其适合在遍历查询整个表时使用。
另外,ADODB还提供取得一条记录的方法:GetOne()。
2.GetOne()方法
ADODB有个比较直接的方法可以比较方便地检测某条记录是否存在,那就是它的GetOne($sql)方法。
该方法返回查询记录的第1条第1个字段名的值,如果执行过程中出现错误,则返回布尔值false。
我们可以检测这个值是否存在:
<?php
Include_once("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", “root”, “passwd”, “adodb”) or die("Unable to connect!");
$rs = $db->GetOne("SELECT * FROM library WHERE id='$id'");
if($rs){
echo '记录存在';
}else {
echo '记录不存在';
}
?>
不过这样有一个问题是,如果数据表中id=$id的记录有多条,不仅仅要知道是否存在有这样一条记录,还要把这条记录提取出来,则可以使用ADODB的GetRow()方法。
3.GetRow()方法
<?php
Include_once("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", “root”, “passwd”, “adodb”) or die("Unable to connect!");
$rs = $db->GetRow("SELECT * FROM library WHERE id='$id'");
if(is_array($rs)){
echo '记录存在';
print_r($rs);
} else {
echo '记录不存在';
}
?>
需要注意的是,GetOne($sql) 和 GetRow($sql) 都能得到一条特定的记录,或者得到该记录不存在的信息,但是如果符合查询条件的记录存在多条时,则这两个方法只传回第一条记录,其他的都自动抛弃。
如果只要得到查询结果的行数,则可以使用结果集方法中的RecordCount()方法。
4.取得返回的记录行数
ADODB还提供了一批实用功能,如在进行查询时,提供了非常有用的RecordCount() 和FieldCount()方法,分别返回记录的数量和字段的数量,以下是应用这两个方法的例子。
<?php
include("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", “root”, “passwd”, “adodb”) or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT * FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 取得和显示返回的记录行数
echo $result->RecordCount() . " 行记录被返回\n";
// 取得和显示返回的字段个数
echo $result->FieldCount() . " 个字段被返回\n";
// clea up
$db->Close();
?>
我们可以使用FetchField()方法取得字段的信息,其中含有该字段的详细资料,包括名称和类型等,请看如下的脚本例子。
<?php
include("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT * FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 取得记录集中字段的结构信息
for($x=0; $x<$result->FieldCount(); $x++){
print_r($result->FetchField($x));
}
// 清理无用的对象
$db->Close();
?>
下面输出的是有关id字段的结构信息。
stdClass myMagicbject
(
[name] => id
[table] => library
[def] =>
[max_length] => 3
[not_null] => 1
[primary_key] => 1
[multiple_key] => 0
[unique_key] => 0
[numeric] => 1
[blob] => 0
[type] => int
[unsigned] => 1
[zerofill] => 0
[binary] =>
)
5.其他相关方法
当执行一个INSERT查询时,如果该表的主键是一个自动增量的字段,则可以使用ADODB的insert_id()方法,来获得最后数据插入时自动产生的增量值。
<?php
include_once(“libs/adodb/adodb.inc.php”);
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", “root”, “root”, “adodb”) or die("Unable to connect!");
// 构造并执行INSERT插入操作
$title = $db->qstr("PHP5与MySQL5 Web开发技术详解");
$author = $db->qstr("杜江");
$query = "INSERT INTO library (title, author) VALUES ($title, $author)";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 显示插入的记录号
if ($result){
echo "最后插入的记录ID: " . $db->Insert_ID();
}
// 清理无用的对象
$db->Close();
?>
脚本中的qstr()方法,功能是过滤SQL查询中的非法字符。
执行后,即无论查询(SELECT)、删除(DELETE)或修改(UPDATE)数据,如果想知道是否对表有影响,可以使用affected_rows()方法,它可以告诉我们操作后有多少(记录)行受到了影响。请看下面的脚本例子:
<?php
include_once("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", “root”, “root”, “adodb”) or die("Unable to connect!");
// 构造并执行一个查询
$query = "DELETE FROM library WHERE author = 'J. Luser'";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 取得和显示执行后影响的记录行数
if ($result){
echo $db->Affected_Rows() . " 行已被删除";
}
// 清理无用的对象
$db->Close();
?>
6.限制查询结果
上面 我们讨论了如何通过使用一个数据库库函数使应用程序更简洁,更易于移植。比如从MS SQL Server转移到MySQL,在MS SQL Server中使用指令“SELECT TOP 15 name FROM employee”取得数据的前15条,可在MySQL中却不支持这种写法,而要写成:SELECT name FROM employee LIMIT 15。
它似乎对我们敲响了警钟,应该停止在查询语句中使用非标准SQL指令,而去认真地学习标准的SQL。
幸运的是,ADODB有一个处理 LIMIT的方法:SelectLimit(),这样我们就根本不用管连接的是MySQL还是MS SQL Server,ADODB会在底层为我们自动转换,请见下面的脚本例子:
<?php
include_once("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 构造并执行一个查询
// 我们要取得5行记录,从符合记录的第3行开始取
$query = "SELECT * FROM library";
$result = $db->SelectLimit($query, 5, 3) or die("Error in query: $query. " . $db->ErrorMsg());
// 遍历记录集
while (!$result->EOF) {
echo $result->fields[1] . " - " . $result->fields[2] . "\n";
$result->MoveNext();
}
// 清理无用的对象
$db->Close();
?>
在这个例子中,selectlimit()方法类似于MySQL的LIMIT语句,可用于控制从某行开始查询,到某行的结果,从而取得我们指定的记录集。
我们可以利用ADODB提供的MetaDatabases()方法取得当前服务器中所有数据库的清单。还有一个方法和它很类似,即使用MetaTables()方法可以取得当前库中所有表的清单。请看下面的例子:
<?php
include(“libs/adodb/adodb.inc.php”);
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 取得数据列表
echo "数据库:\n";
foreach($db->MetaDatabases() as $d){
echo "* $d\n";
}
// 取得数据表清单
echo "\n当前数据库下的表:\n";
foreach($db->MetaTables() as $table){
echo "* $table\n";
}
// 清理无用的对象
$db->Close();
?>
7.快速存取
有时,我们需要对一些不同的值做一些特殊的查询,比如一系列的INSERT(插入)语句。ADODB类提供了两个方法,可以使我们既节约时间又节省系统的开销,请看如下示例:
<?php
include(“libs/adodb/adodb.inc.php”);
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 构造准备查询,使用参数绑定
$query = $db->Prepare("INSERT INTO library (title, author) VALUES (?, ?)");
// 从CSV 中取得要插入的标题和作者名称
$data = file("./book_list.csv");
// 遍历该文件,并执行插入操作
foreach ($data as $l){
$arr = explode(",", $l);
// 插入值并绑定准备语句
$result = $db->Execute($query, array($arr[0], $arr[1])) or die("Error in query: $query. " . $db->ErrorMsg());
}
// 清理无用的对象
$db->Close;
?>
prepare()函数,把一个SQL查询作为参数,读取一个查询,但并不立即执行。prepare()返回一个句柄给一个prepare查询,当保存和传递给Execute()方法后,则立即执行该查询。
8.处理事务
处理事务是许多应用程序的一个重要的特征(比如,钱从你的账户转出,然后转入到某个人的账户中。只要其中任意一步操作失败,这整个过程都必须被认定为失败。不然,钱被划出,而没有进对方的账户;或者,钱没有划出,但对方账户无端多了一笔钱)。
处理事务可以在代码级上进行机警地管理控制。常数错误检查被用来判断执行COMMIT(事务的所有各项都正确,执行正确,结束事务)还是执行ROLLBACK(事务中有错误,所有改动需要恢复原来状况)。
现在的数据库系统绝大多数都支持事务,如MySQL、Oracle、MS SQL Server等,ADODB提供一个非常好的功能,能够让你更透明地使用这一特性。请看下面的例子:
<?php
include(“libs/adodb/adodb.inc.php”);
// 创建一个mysql连接实例对
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", “root”, “root”, “adodb”) or die("Unable to connect!");
//关闭auto-commit自动提交事务
// 开始事务处理语句块
$db->BeginTrans();
// 第一次查询
$query = "INSERT INTO library (title, author) VALUES ('测试用书', '佚名')";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
//使用第一次查询返回的ID号
if ($result){
$id = $db->Insert_ID();
$query = "INSERT INTO purchase_info (id, price) VALUES ($id, 'RMB 31.9')";
$result = $db->Execute($query)
or die("Error in query: $query. " . $db->ErrorMsg());
}
// 如果操作成功
if ($result){
// 事务提交
$db->CommitTrans();
}// 否则回滚
else{
$db->RollbackTrans();
}
// 清理无用的对象
$db->Close;
?>
该脚本首先 需要关掉数据库的auto commit功能,通过begintrans()方法来处理,这种方法也标志着一个事务的开始。可以使用CommitTrans()或 RollbackTrans()函数来处理操作,一旦auto commit已经关掉,你就可以任意执行所需要的查询,确认事务的查询执行无误并完毕后,由我们自己决定何时执行commit操作。
每一 次执行Execute()事务块后,它会返回一个布尔值,告诉我们是否成功地执行了查询。可以跟踪到这个值,以及使用的时间,以决定是否要进行整个交易行 为。一旦你相信一切都没问题,则告诉数据库committrans()方法;如果发现有错误发生,则可以进行回滚操作——执行 rollbacktrans()方法。
值得注意的是,注意您的数据库类型是否支持这些事务函数,前面已经说过,MySQL的InnoDB类型表支持事务,但是MyISAM类型并不支持。
9.使用缓存查询
在一个动态页面中,如果其中的一个查询指令很少改变且频繁被执行,我们则可以使用ADODB的缓存功能,可以将查询指令的结果缓存成静态文件,从而提高PHP脚本的性能。
当试图通过缓存来提高你的应用程序的性能之前,建议先去优化查询指令再开始本操作,这样才会起到事半功倍之效果。
ADODB最棒的功能就是提供查询缓存的功能。缓存可以大大改善应用程序的性能,尤其是网站系统,因为大部分用户都是在浏览网站,数据库完成的任务多半是查询(SELECT操作)。为了更好地理解与应用缓存查询的功能,我们来看下面的脚本例子。
<?php
include_once("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "root", "adodb") or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT * FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 遍历返回的记录集,显示列数据的内容 TITLE 和 AUTHOR
while (!$result->EOF) {
echo $result->fields[1] . " - " . $result->fields[2] . "\n";
$result->MoveNext();
}
// 显示取得的记录行数
echo "\n[" . $result->RecordCount() . " 行记录被返回]\n";
// 关闭数据库连接
$db->Close();
?>
这段代码使用ADODB进行一个SELECT操作。比如说,这就是您的网站,平均有每分钟5000次的点击(PV,Page View)量,那么数据库系统每小时至少要被查询3万次以上,可以想象,这对我们的MySQL数据库的负载是相当繁重的。
因此ADODB提供了缓存的功能,可以将经常查询的结果保存起来,进而降低数据库服务器的负荷,同时也向用户提供更快速的内容响应。
下面是修改上面的脚本,改为使用CacheExecute来进行缓存查询的示例:
<?php
include("libs/adodb/adodb.inc.php");
//设置缓存保存的路径,.表示当前目录
$ADODB_CACHE_DIR = '.'; //为了管理方便,实际开发环境请指向到独立的目录中,如/tmp/adodb
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "passwd", "adodb") or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT * FROM library";
$result = $db->CacheExecute(300,$query) or die("Error in query: $query. " . $db->ErrorMsg());
// 遍历返回的记录集,显示列数据的内容 TITLE 和 AUTHOR
while (!$result->EOF) {
echo $result->fields[1] . " - " . $result->fields[2] . "\n";
$result->MoveNext();
}
// 取得和显示返回的记录行数
echo "\n[" . $result->RecordCount() . " 行记录被返回]\n";
// 关闭数据库连接
$db->Close();
?>
CacheExecute()方法的第一个参数是缓存文件(缓存文件被命名为adodb_*.cache)将被保留的时间,以秒计时;第二个参数是SQL声明。第一个参数是可选择的,若没有限定时间,默认值是3600秒,也就是1个小时。
值得一提的是,使用CacheExcute()方法时,需要将php.ini中的参数magic_quotes_runtime设为0。
也可以根据需要,在程序运行时动态修改它的值:
set_magic_quotes_runtime(0);
注意:将上述代码放到调用数据库的指令之前,我们还可以在任何时候,通过调用CacheFlush()来清除过时的缓存。
10.生成下拉列表菜单
ADODB特意为Web开发任务提供几个通用的方法。其中,最有用的是GetMenu()方法,通过抽取数据库的记录集,自动地生成表单及菜单列表框。
下面介绍的就是从数据库动态构建下拉菜单(Option)的例子。
<html>
<head></head>
<body>
<?php
include_once("libs/adodb/adodb.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "root", "library") or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
//显示HTML下拉列表菜单
echo $result->GetMenu("library", '', false);
// 关闭数据库连接
$db->Close();
?>
</body>
</html>
GetMenu()方法需要传入参数,用来控制列表框的行为。上例中第一个参数是列表框的名字(这个例子为“library”);第二个参数是显示时默认的值,可以为空,从第一个记录开始;第三个参数,指定列表框的项目是否为空;第四个参数,控制是否允许用户多选。
上例的显示结果如下:
<select name="library" >
<option value="15">Mystic River</option>
<option value="16">Where Eagles Dare</option>
<option value="17">XML and PHP</option>
</select>
可以看到,该列表菜单内容是从library表抽取的记录,列表框的名字为“library”,在记录集中,ID是菜单选项的值,名称为菜单框显示的元素。
由此可以看出,GetMenu()方法可以大幅度简化Web开发任务,大大减少代码量。
11.输出到文件
ADODB还允许我们将记录输出为一个不同形式的文件:如逗号分隔符CSV文件,制表符表格,甚至于HTML形式的表格。
这些功能属于ADODB的附属功能,在使用时需要包含相关ADODB类文件,下面是样例的内容。
<?php
include("libs/adodb/adodb.inc.php");
// 包含转换方法的文件
include_once("libs/adodb/toexport.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "passwd", "library") or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 返回一个CSV字符串
echo rs2csv($result);
// 关闭数据库的连接
$db->Close();
?>
输出结果如下:
title,id
Mystic River,15
Where Eagles Dare,16
XML and PHP,17
我们也可以去除结果中第一行,即字段的名称,使用脚本格式如下:
// 返回一个 CSV 字符串
echo rs2csv($result, false);
脚本的输出结果将没有字段名称,如下:
Mystic River,15
Where Eagles Dare,16
XML and PHP,17
ADODB还提供生成制表符或分隔符文件功能,使用rs2tab()方法:
<?php
include("libs/adodb/adodb.inc.php");
// 包含转换方法的文件
include("toexport.inc.php");
//创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "root", "library") or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 返回一个TAB制表符分隔的字符串
echo rs2tab($result);
// 关闭数据库连接
$db->Close();
?>
显示结果如下:
title id
Mystic River 15
Where Eagles Dare 16
XML and PHP 17
ADODB还提供生成HTML表格的功能,使用rs2html()方法:
<html>
<head></head>
<body>
<?php
include_once(“libs/adodb/adodb.inc.php”);
// 包含转换方法的文件
include_once("libs/adodb/tohtml.inc.php");
// 创建一个mysql连接实例对象
$db = NewADOConnection("mysql");
// 打开一个数据库连接
$db->Connect("localhost", "root", "passwd", "library") or die("Unable to connect!");
// 构造并执行一个查询
$query = "SELECT title, id FROM library";
$result = $db->Execute($query) or die("Error in query: $query. " . $db->ErrorMsg());
// 返回一个HTML格式的表格
echo rs2html($result);
// 关闭数据库连接
$db->Close();
?>
</body>
</html>
输出结果如下: