Adodb的十个实例(清晰版)

答案：
本想学pear的，可是网上看到的几篇帖子对adodb的评价相当高，所以改学了这个。  
ADODB的优点有这几个(网上说的，不是我说的)：  
1、速度比pear快一倍；  
2、支持的数据库类型比pear多很多，甚至可以支持ACCESS;  
3、无须安装，无须服务器支持(对新手来说，这点很重要吧)  
不知道adodb是什么或是想下载adodb的朋友可以去这个链接看看：http://www.phpe.net/class/106.shtml   
另外，如果哪位兄弟翻译了README的全文或知道哪里有译文请给我回个帖，谢谢。  
Tutorial   
Example 1: Select Statement   
任务: 连接一个名为Northwind的Access数据库, 显示 每条记录 的前两个字段.   

在这个实例里, 我们新建了一个ADOC连接(ADOConnection)对象, 并用它来连接一个数据库. 这个连接采用PConnect 方法, 这是一个持久 连接. 当我们要查询数据 库时, 我们可以随时调 用这个连接的Execute()函数. 它会返回一个ADORecordSet对象 which is actually a cursor that holds the current row in the array fields[]. 我们使用MoveNext()从一个记录转向下一个记录 .   

NB: 有一 个非常实用的函数 SelectLimit在本例中没有用到, 它可以控制显示的记录数(如只显示前十条记录 ，可用作分页显示 ).   


PHP:--------------------------------------------------------------------------------  

<?   
include('adodb.inc.php'); #载入ADOdb   
$conn = &ADONewConnection('access'); # 新建一个连接   
$conn->PConnect('northwind'); # 连接到一个名为northwind的MS-Access数据库   
$recordSet = &$conn->Execute('select * from products'); #从products数据表中搜索所有数据   
if (!$recordSet)   
print $conn->ErrorMsg(); //如果数据搜索发生错误显示错误信息   
else   
while (!$recordSet->EOF) {   
print $recordSet->fields[0].' '.$recordSet->fields[1].'<BR>';   
$recordSet->MoveNext(); //指向下一个记录   
} //列表显示数据   

$recordSet->Close(); //可选   
$conn->Close(); //可选   
?>   
--------------------------------------------------------------------------------  

$recordSet在$recordSet->fields中返回当前数组, 对字段进行数字索引(从0开始). 我们用MoveNext() 函数移动到下一个记录 . 当数据库搜索到结尾时EOF property被 设置 为true. 如果Execute()发生错误 , recordset返回flase.   

$recordSet->fields[]数组产生于PHP的数据库扩展。有些数据库扩展只能按数字索引而不能按字段名索引.如果坚持要使用字段名索引，则应采用SetFetchMode函数.无论采用哪种格式索引，recordset都可以由Execute()或SelectLimit()创建。   


PHP:--------------------------------------------------------------------------------  
$db->SetFetchMode(ADODB_FETCH_NUM);   
$rs1 = $db->Execute('select * from table'); //采用数字索引   
$db->SetFetchMode(ADODB_FETCH_ASSOC);   
$rs2 = $db->Execute('select * from table'); //采用字段名索引   
print_r($rs1->fields); # shows array([0]=>'v0',[1] =>'v1')   
print_r($rs2->fields); # shows array(['col1']=>'v0',['col2'] =>'v1')--------------------------------------------------------------------------------  


如果要获取记录号,你可以使用$recordSet->RecordCount()。如果没有当前记录则返回-1。   

实例 2: Advanced Select with Field Objects   
搜索表格，显示前两个字段. 如果第二个字段是时间或日期格式,则将其改为美国标准时间格式显示.   

PHP:--------------------------------------------------------------------------------  

<?   
include('adodb.inc.php'); ///载入adodb   
$conn = &ADONewConnection('access'); //新建一个连接   
$conn->PConnect('northwind'); //连接名为northwind的MS-Access数据库   
$recordSet = &$conn->Execute('select CustomerID,OrderDate from Orders'); //从Orders表中搜索CustomerID和OrderDate两个字段   
if (!$recordSet)   
print $conn->ErrorMsg(); //如果数据库搜索错误,显示错误信息   
else   
while (!$recordSet->EOF) {   
$fld = $recordSet->FetchField(1); //把第二个字段赋值给$fld   
$type = $recordSet->MetaType($fld->type); //取字段值的格式   

if ( $type == 'D' || $type == 'T')   
print $recordSet->fields[0].' '.   
$recordSet->UserDate($recordSet->fields[1],'m/d/Y').'<BR>'; //如果字段格式为日期或时间型,使其以美国标准格式输出   
else   
print $recordSet->fields[0].' '.$recordSet->fields[1].'<BR>'; //否则以原样输出   

$recordSet->MoveNext(); //指向下一个记录   
}   
$recordSet->Close(); //可选   
$conn->Close(); //可选   

?>   
--------------------------------------------------------------------------------  

在这个例子里, 我们用FetchField()函数检查了第二个字段的格式. 它返回了一个包含三个变量的对象   

name: 字段名   
type: 字段在其数据库中的真实格式   
max_length:字段最大长度,部分数据库不会返回这个值,比如MYSQL,这种情况下max_length值等于-1.   
我们使用MetaType()把字段的数据库格式转化为标准的字段格式   

C: 字符型字段,它应该可以在<input type="text">标签下显示.   
X: 文本型字段,存放比较大的文本,一般作用于<textarea>标签   
B: 块,二进制格式的大型对象,如图片   
D: 日期型字段   
T: 时间型字段   
L: 逻辑型字段 (布尔逻辑或bit-field)   
I: 整型字段   
N: 数字字段. 包括自动编号(autoincrement), 数字(numeric), 浮点数(floating point), 实数(real)和整数(integer).   
R: 连续字段. 包括serial, autoincrement integers.它只能工作于指定的数据库.   
如果metatype是日期或时戳类型的，我们用用户定义的日期格式UserDate()函数来输出，UserDate()用来转换PHP SQL 日期字符串格式到用户定义的格式，MetaType()的另一种用法是在插入和替换前确认数据有效性.   

实例 3: Inserting  
在订单数据表中插入一个包含日期和字符型数据的记录,插入之前必须先进行转换, eg: the single-quote in the word John's.   

PHP:--------------------------------------------------------------------------------  

<?   
include('adodb.inc.php'); // 载入adodb   
$conn = &ADONewConnection('access'); //新建一个连接   

$conn->PConnect('northwind'); //连接到ACCESS数据库northwind   
$shipto = $conn->qstr("John's Old Shoppe");   

$sql = "insert into orders (customerID,EmployeeID,OrderDate,ShipName) ";   
$sql .= "values ('ANATR',2,".$conn->DBDate(time()).",$shipto)";   

if ($conn->Execute($sql) === false) {   
print 'error inserting: '.$conn->ErrorMsg().'<BR>';   
} //如果插入不成功输出错误信息   
?>   
--------------------------------------------------------------------------------  

在这个例子中,我们看到ADOdb可以很容易地处理一些高级的数据库操作. unix时间戳 (一个长整数)被DBDate()转换成正确的Access格式, and the right escape character is used for quoting the John's Old Shoppe, which is John''s Old Shoppe and not PHP's default John's Old Shoppe with qstr().   

观察执行语句的错误处理. 如果Execute()发生错误, ErrorMsg()函数会返回最后一个错误提示. Note: php_track_errors might have to be enabled for error messages to be saved.   

实例 4: Debugging   
<?   
include('adodb.inc.php'); // 载入adodb   
$conn = &ADONewConnection('access'); //新建一个连接   
$conn->PConnect('northwind'); //连接到ACCESS数据库northwind   
$shipto = $conn->qstr("John's Old Shoppe");   
$sql = "insert into orders (customerID,EmployeeID,OrderDate,ShipName) ";   
$sql .= "values ('ANATR',2,".$conn->FormatDate(time()).",$shipto)";   
$conn->debug = true;   
if ($conn->Execute($sql) === false) print 'error inserting';   
?>   

在上面这个例子里，我们设置了debug = true.它会在执行前显示所有SQL信息, 同时，它也会显示所有错误提示. 在这个例子里，我们不再需要调用ErrorMsg() . 要想显示recordset, 可以参考 rs2html()实例.   

也可以参阅 Custom Error Handlers 的部分内容。   

实例 5: MySQL and Menus   
连接到MySQL数据库agora, 并从SQL声明中产生一个<select>下拉菜单 ，菜单的 <option> 选项显示为第一个字段, 返回值为第二个字段.   

PHP:--------------------------------------------------------------------------------  

<?   
include('adodb.inc.php'); # load code common to ADOdb   
$conn = &ADONewConnection('mysql'); //eate a connection   
$conn->PConnect('localhost','us

上一个：AJAX for PHP简单表数据查询实例
下一个：30分钟学会用PHP写带数据库的简单通讯录第1/3页