PEAR::DB fetchRow

$result->fetchRow 及 $dbh->setFetchMode

第一个例子已告诉了大家可以用 $result->fetchRow 去读取查询的结果。用 PHP 写过数据库程序的朋友都知道 PHP 提供了三种方式来传回查询： *_fetch_row 、 *_fetch_array 及 *_fetch_object 。 PEAR::DB 当然也不会漏了这功能。 fetchRow 的第一个参数就是所谓读取模式 (fetch mode, 结果以那种方式传回) ，可以有下列值：

• DB_FETCHMODE_ORDERED (缺省值)
• DB_FETCHMODE_ASSOC
• DB_FETCHMODE_OBJECT

如没有设定读取模式，缺省就是 DB_FETCHMODE_ORDERED 。这模式 在例一已示范过了，只是把传回的结果存放在一以数字作索引的阵列(Array)的中。前后次序是根据 SELECT 命令中栏名的次序。模式 DB_FETCHMODE_ASSOC 则存放在以栏名作索引的阵列，例如：

$result = $dbh->query('SELECT id, name, mail FROM test_table');while ( $row = $result->fetchRow(DB_FETCHMODE_ASSOC)) {    echo "ID: $row['id']<br>";    echo "Name: $row['name']<br>";    echo "E-mail: $row['mail']<br>";}

模式 DB_FETCHMODE_OBJECT 比较复杂，你最好先定义一个类别。这个类别必需要有一个只用一个阵列作参数的 constructor ，而 constructor 要从阵列中的值设回属性，如下：

 class TestUser {     var $id, $name, $mail;     function TestUser($attr = null) {         if ( is_array($attr) ) {             $this->id = $attr['id'];             $this->name = $attr['name'];             $this->mail = $attr['mail'];         }     }     function toString() {         $res = "!TestUser{/n  ID: $this->id/n";         $res .= "  Name: $this->name/n";         $res .= "  Mail: $this->mail/n}/n";         return $res;    } }

有了这个类别，我们就可以用 DB_FETCHMODE_OBJECT 去读取资料：

$dbh->setFetchMode(DB_FETCHMODE_OBJECT, 'TestUser');$result = $dbh->query('SELECT id, name, mail FROM test_table');while ( $row = $result->fetchRow()) {   echo nl2br($row->toString());}

上面的例子也首次使用了 setFetchMode 这个方法。很多人应已猜到这方法是用来设定缺省的读取模式，而如果设定的模式是 DB_FETCHMODE_OBJECT ，你就可以用第二个参数设定 fetchRow 时传回物件的类别，如上例中的 TestUser 。没有设定类别的话，fetchRow 会传回类别为 DB_row 的物件。

[编辑]

$dbh->getOne($query, $params = array())

getOne 会传回查询结果中第一笔记录的第一个栏的值。

$numOfRecord = $dbh->getOne('SELECT count(*) FROM test_table');

[编辑]

$dbh->getRow($query, $fetchmode, $params)

getRow 会传回查询结果的第一笔记录。

 $result = $dbh->getRow('SELECT * FROM test_table WHERE id = 4',     DB_FETCHMODE_ASSOC); if ( DB::isError($result) ) {    echo "Error: " . $result->getMessage();    exit(1); } echo "ID: $result['id']<br>"; echo "Name: $result['name']<br>";

[编辑]

$dbh->getCol($query, $col = 0, $params)

有 getRow 自然有 getCol ，作用为何也不必多说。参数 col 就是用来指定要那一栏，可以是数目字 (零代表 SELECT 命令中的第一个栏) ，也可以是栏名。不过说实，我暂时也想不到有什么理由需要这个参数。

 $result = $dbh->getCol('SELECT name FROM test_table'); if ( DB::isError($result) ) {    echo "Error: " . $result->getMessage();    exit(1); } echo "Name: " . join(', ', $result) . "<br>";

[编辑]

$dbh->getAssoc($query, $force_array)

getAssoc 会将查询的所有结果放入以第一栏为索引的阵列。例如 getAssoc('SELECT id, text FROM mydate') 的结果会是：

array (  '1' => 'one',  '2' => 'two',  '3' => 'three')

getAssoc('SELECT id, text, date FROM mydate') 的结果则是：

array (  '1' => array('one', '944'),  '2' => array('two', '944'),  '3' => array('three', '944'))

[编辑]

$dbh->getAll($query, $params, $fetchmode)

从名字都可以看出这个数可以一次过把所有查询的结果存回来 ，如 getAll('SELECT id, text FROM mydate', null, DB_FETCHMODE_ORDERED) 的结果会以下：

array(  array('1', 'one'),  array('2', 'two'),  array('3', 'three'))

而 getAll('SELECT id, text FROM mydate', null, DB_FETCHMODE_ASSOC) 的结果则会以下：

array(  array( 'id' => '1', 'text' => 'one'),  array( 'id' => '2', 'text' => 'two'),  array( 'id' => '3', 'text' => 'three'))