Drizzle PHP入门
通过Drizzle PHP扩展,可以在PHP里获得全面的API来操纵Drizzle数据库。这一扩展目前由Eric Day, James Luedke以及其它人员维护,可以遵照PHP许可证从PECL里免费获得。虽然这个扩展目前还处于Beta阶段,但它已经涵盖了PHP应用程序中可能涉及到的各种常见任务。
要开始使用了Drizzle PHP扩展v0.4.0 ),用PECL自动安装程序就可以了,如下:
- shell> pecl install drizzle-beta
或者,你也可以下载它的源代码,并将其编译成一个可加载的PHP模块,如下:
- shell> tar -xzvf drizzle-0.4.0.tar.gz
- shell> cd drizzle-0.4.0
- shell> phpize
- shell> ./configure
- shell> make
- shell> make install
至此,在你的PHP模块目录下应该就有了名为drizzle.so的一个可加载模块。在php.ini配置文件里启用此扩展,重新启动Web服务器,并用phpinfo()函数检查这一扩展是否已经启用:
小提示
下面的例子演示了用Drizzle PHP扩展执行SELECT语句查询数据库服务器,并将查询结果以HTML表格的格式输出。
- < html>
- < head>
- < style type="text/css">
- table,tr,td {
- border: solid 1px black;
- border-collapse: collapse;
- padding: 5px;
- }
- < /style>
- < /head>
- < body>
- < h2>List Items< /h2>
- < ?php
- // set connection parameters
- $host = 'localhost';
- $port = 4427;
- $user = 'root';
- $pass = 'guessme';
- $db = 'test';
- // create drizzle object
- $drizzle = drizzle_create();
- // connect to database server
- $conn = drizzle_con_add_tcp($drizzle, $host, $port, $user, $pass, $db, 0)
- or die('ERROR: ' . drizzle_error($drizzle));
- // execute query
- $sql = 'SELECT ItemDesc, ItemQty FROM items';
- $result = @drizzle_query($conn, $sql)
- or die ('ERROR: ' . drizzle_con_error($conn));
- // buffer result set
- drizzle_result_buffer($result)
- or die('ERROR: ' . drizzle_con_error($conn));
- // check number of rows in result set and print
- if (drizzle_result_row_count($result)) {
- echo '< table>';
- while (($row = drizzle_row_next($result))) {
- echo '< tr>';
- echo '< td>' . $row[0] . '< /td>';
- echo '< td>' . $row[1] . '< /td>';
- echo '< /tr>';
- }
- echo '< /table>';
- } else {
- echo 'No records found';
- }
- // free result set
- drizzle_result_free($result);
- // close connection
- drizzle_con_close($conn);
- ?>
- < /body>
- < /html>
该脚本一开始就通过指定必要的信息来建立与数据库服务器的一个连接。这些信息包括服务器名称,服务器端口,用户名和密码,以及要查询的数据库名称。这些值都是用普通的PHP变量保存的。drizzle_create()函数会初始化一个Drizzle对象,这些连接时需要的参数则是通过drizzle_con_add_tcp()函数添加进去的。这个函数返回一个连接标识符,用于接下来与数据库服务器间的通信。
下一步是创建查询语句并执行。这是通过drizzle_query()函数实现的,它需要两个参数,一个是查询语句,另一个是连接标识符。drizzle_query()函数的返回值是一个结果对象,代表着这次查询的结果。如果你愿意的话,可以使用drizzle_result_buffer()函数缓存这个结果集;不过要注意,如果查询返回的结果集很大的话,这对内存的占用也是非常明显的。
drizzle_result_row_count()函数返回缓存的结果集中记录的条数。这些记录可以用drizzle_row_next()函数检索,它能在结果集中迭代,并且以数组的形式获取每条结果。然后就可以通过数组符号访问各个字段了。
当你处理完每个结果集之后,最好用drizzle_result_free()函数释放它所用的内存。若要彻底清理干净,则可使用drizzle_con_close()函数断开与Drizzle服务器的连接。
下面这段代码的输出演示:
使用面向对象
你也可以用面向对象方式使用Drizzle API,之前所用的每个函数都对应于对象的一种方法。请看下面这段代码,它与之前那段是等价的:
- < html>
- < head>
- < style type="text/css">
- table,tr,td {
- border: solid 1px black;
- border-collapse: collapse;
- padding: 5px;
- }
- < /style>
- < /head>
- < body>
- < h2>List Items< /h2>
- < ?php
- // set connection parameters
- $host = 'localhost';
- $port = 4427;
- $user = 'root';
- $pass = 'guessme';
- $db = 'test';
- // create drizzle object
- $drizzle = new drizzle();
- // connect to database server
- $conn = $drizzle->addTcp($host, $port, $user, $pass, $db, 0)
- or die('ERROR: ' . $drizzle->error());
- // execute query
- $sql = 'SELECT ItemDesc, ItemQty FROM items';
- $result = @$conn->query($sql)
- or die('ERROR: ' . $conn->error());
- // buffer result set
- $result->buffer()
- or die('ERROR: ' . $conn->error());
- // check number of rows in result set and print
- if ($result->rowCount()) {
- echo '< table>';
- while (($row = $result->rowNext())) {
- echo '< tr>';
- echo '< td>' . $row[0] . '< /td>';
- echo '< td>' . $row[1] . '< /td>';
- echo '< /tr>';
- }
- echo '< /table>';
- } else {
- echo 'No records found';
- }
- // close connection
- $conn->close();
- // deinitialize object
- unset($drizzle);
- ?>
- < /body>
- < /html>
在这里,new关键字实例化了一个Drizzle对象,并且向这个对象的addTcp()方法传递了相关的连接信息。由此产生的DrizzleCon对象提供了 query () 方法,可以用来在数据库服务器上执行查询。此外还有DrizzleResult对象也提供了一些方法来执行对结果集的获取、缓存、处理等操作。
如果你仔细研究以上这两个脚本,就会发现它们在函数和方法命名以及代码结构上的许多相似之处。
PHP之友评论