Drupal 7 数据库 操作(很好，很犀利)

Drupal 7 使用 PDO 连接数据库，鉴于 PHP 6将把 PDO 做为默认数据库连接方式，这是必须的选择。实际上，Drupal 7之前的数据库抽象层，和 PDO 的某些理念一致，用相同的方法操作不同类型的数据库，减少了模块开发者的工作，也提升了程序的兼容性和可移植性。引入 PDO，相对于之前的版本，数据库接口当然有不小的变化。

最显著的，db_fetch_object()、db_fetch_array() 这两个最常用的函数没用了。从前，db_query()或pager_query()之后，几乎必然跟着上述两个函数之一，现在，没有了。而那些 SQL 语句中熟悉的占位符（%d, %s, %f, %n），也没有了。要谈这两个问题，先要了解一下大家最最熟悉的 db_query() 的改变。

在 Drupal 6 中，db_query() 接受无限个参数，第一个为 SQL 语句，后面的参数为查询值，用以替换语句中的占位符，大致类似于：
 

<?php
  db_query("SELECT * FROM {system} WHERE filename = '%s'", 'system');
?>

 

在 db_query() 中，%d 和 %s 是不能混用的，一个是数字整型，一个是字符串，%s 也必须使用单引号，防止注入。然后，Drupal 将检查参数的合法性，最后执行语句，返回一个资源对象，用 db_fetch_object() 或 db_fetch_array() 取出结果集。

在 Drupal 7 中，db_query() 接受三个参数，第一个为 SQL 语句，第二个是一组查询值，第三个是数据库连接的一些设置，大致类似于：
 

<?php
  db_query('SELECT * FROM {system} WHERE filename = ?', array('system'));
?>

 

在语句中的占位符，不再需要考虑是字符串或是数字，可以完全用 ? 号表示，后面的查询值是一个索引数组，顺序必须与前面的占位符一致，个数也必须相同。很多时候，语句较为复杂，可能需要许多占位符，全用 ? 号，显得混乱，可以这样来让代码更清晰：
 

<?php
  db_query('SELECT * FROM {system} WHERE filename = :name OR type = :theme', array(':name' => 'system',':theme' => 'theme'));
?>

这时候，第二个参数必须是一个关联数组，占位符即是数组键名。这些占位符是完全自定义的，你可以使用你喜欢的“合法”字符。这条语句中很清楚的表明，%d、%s 这些占位符不存在了，被 ? 或自定义的占位符取代了。为什么呢？在 drupal 6 中，%d、%s 是用来定义传入值的类型，然后 Drupal 数据库层做出相应的类型检查。而在 Drupal 7中，PDO 将检查传入值的合法性，不需要程序来实现，所以，那些占位符，也光荣退休了。我觉得这一点会提升一些性能，毕竟程序来做检查，比 PHP 底层来检查，来得慢一些。

 

而第三个参数，一般很少用到，除非你想修改一些默认设置。比如，想使用一个新的数据库连接，想返回另一种形式的结果集。Drupal 7支持多个数据连接，在 settings.php 文件中，数据库信息为一个数组，键名即是数据库连接的标识，如 $databases['default'] 是默认连接，这是必须的。模块开发者，可以在模块文件中，自行定义新连接，在操作时，设置连接标识即可，例如：
 

<?php
  $attributes = array(
    'target' => 'mynewdata', // 数据库连接标识
    'fetch' => PDO::FETCH_ASSOC, // 返回的结果集类型
  );
  db_query('SELECT * FROM {system} WHERE filename = :name OR type = :theme', array(':name' => 'system',':theme' => 'theme'), $attributes);
?>

 

PDO 默认返回一个索引和关联数组相结合的结果集，Drupal 7中默认设置为返回一个对象，即：PDO::FETCH_OBJ，你可以设置成 PDO::FETCH_ASSOC：返回关联数组，PDO::FETCH_COLUMN：返回首列。等等。所以，db_fetch_object() 和 db_fetch_array() 不需要了，在 db_query() 中直接把这一步省略了。

对比一下：
 

<?php
  // 结果集为对象
  // Drupal 6
  $result = db_query('SELECT filename, type FROM {system}');
  while($o = db_fetch_object($result)){
    echo $o->filename;
  }

 

// Drupal 7
   if( $result  =  db_query ( 'SELECT filename, type FROM {system}' )){
    foreach( $result  as  $o ){
      echo  $o -> filename ;
    }
  }

 

// 结果集为数组
  // Drupal 6
   $result  =  db_query ( 'SELECT filename, type FROM {system}' );
  while( $o  =  db_fetch_array ( $result )){
    echo  $o [ 'filename' ];
  }

 

// Drupal 7
   if( $result  =  db_query ( 'SELECT filename, type FROM {system}' , array(), array( 'fetch'  =>  PDO :: FETCH_ASSOC ))){
    foreach( $result  as  $o ){
      echo  $o [ 'filename' ];
    }
  }

 

// 获取第一行
  // Drupal 6
  // 当然，这里应该用 db_query_range() 来限制查询数量为 1 条更合适
   $o  =  db_fetch_object ( db_query ( 'SELECT filename, type FROM {system}' ));
  echo  $o -> filename ;

 

// Drupal 7
   $result  =  db_query ( 'SELECT filename, type FROM {system}' );
  echo  $result -> fetch ()-> filename ;

 

// 获取一列
  // Drupal 6
   $filename  =  db_result ( db_query_range ( 'SELECT filename FROM {system}' ,  0 ,  1 ));
  echo  $filename ;

 

// Drupal 7
  // 注意：db_query_range() 的结构和 Drupal 6 基本一致的
   $result  =  db_query_range ( 'SELECT filename FROM {system}' ,  0 ,  1 );
  echo  $result -> fetchColumn ();
?>

 

如果对面向对象结构不太熟悉，看起来有点晕。实际上，对于 db_query() 返回的结果，可以使用以下方式获取：
 

<?php
  $result->fetch(); // 获取一行
  $result->fetchAll(); // 获取全部，
  $result->fetchObject(); // 以对象方式获取一行
  $result->fetchAssoc(); // 以关联数组方式获取一行
  $result->fetchColumn(); // 获取首列
?>

 

因为 PDO 面向对象的特性，所以，直接使用这样的方式也是合法的：
 

<?php
  db_query('SELECT filename, type FROM {system}')->fetch();
  db_query('SELECT filename, type FROM {system}')->fetchAssoc();
  db_query_range('SELECT filename FROM {system}', 0, 1)->fetchColumn();
?>

 

如果使用动态查询，这会更加更加更加的长。如果在 Drupal 7中看到很长很长很长一串的联接，也不要太奇怪。

----------------读了老东east的这篇后，对Drupal7的数据库有了更深些的认识，很不错的文章，感谢East的分享！