Drupal 7 数据库 操作

****在操作drupal 的数据库前建议先了解一下 drupal的数据表

***一般情况下，我们使用drupal 只需了解drupal 的函数，当然要精通还是需要深入的了解drupal的框架。

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();
?>

如果使用动态查询，这会使表达式更加的长。