Drupal常用开发工具（一）——Devel模块

　　进行 Drupal 开发时有许多模块和工具可供使用，其中最常用的两项便是 Devel 及 Drupal for Firebug。本文和《Drupal常用开发工具（二）——Drupal for Firebug》将分别对它们进行介绍。

　　与本文相关的很多内容可以通过 Devel Demo 模块进行查看，如有纠正或补充可以在官方问题队列中发帖，也可以在本文后进行留言。

 

Devel模块

　　Devel 集合了多个开发辅助模块，除了作为核心的 Devel 模块外，Devel 模块包中还包含了其它子模块，如 Devel Generate 可用于生成测试内容、术语和用户等。（注意Theme Developer 模块已经从Devel 模块中分离出来成为单独的模块）

　　Devel 的子模块并不在本文中进行介绍，如有兴趣可到项目页面阅读相关的说明文档。

 

dpm()

　　使用drupal_set_message() 函数将变量显示在页面的 ‘message’ 区域。使用此函数，可以变量进行跟踪。因为Devel模块现在使用Krumo 对变量进行显示，所以输出结果会变得复杂一些。

dpm($input, $name = NULL);

　　如果因为某些原因，你没有使用Krumo，可以使用 $name 参数来对不同的 dpm() 调用进行区分。

 

dvm()

　　使用drupal_set_message() 函数将var_dump() 函数处理变量的结果显示在 ‘message’ 位置。这个函数的输出比基于Krumo 的dpmt() 函数的结果要难读一些，但使用它可以很方便的进行复制粘贴。

dvm($input, $name = NULL);

 

dpr()

　　将变量以易读的格式显示在页面头部（不使用Krumo），对于没有 $message 变量的主题会是一个非常好的选择。

dpr($input, $return = FALSE, $name = NULL);

　　将 $return 参数设置为TRUE，则将显示数据以函数结果返回而不进行打印。

 

dvr()

与dpr() 基本相同，不过输出结果经过 var_dump() 函数得出。

 

kpr()

类似dpm()，不过是在页面上方显示Krumo形式的输出结果，适用于页面模板中没有 $message 变量的情况。

 

dargs()

　　输出传入当前路由函数的参数值。以下图为例，参数分别为 ‘foo’和’42’。当你不确定Drupal路由函数当前接收到的参数是什么时，可以使用这个函数进行确认。（译注：其实就是将 Drupal 内核 args() 函数的结果显示到页面上）

dargs();

 

dd()

　　将变量记录到临时目录下名为drupal_debug.txt 的记录文件中，此函数的所有输出会追加到记录文件后，以方便开发者跟踪查看变量的变化情况。

• 如果使用Mac OS X，可以使用Logging Console对记录文件中的内容进行查看。
• 如果使用Linux，则可以使用 ‘tail –f drupal_debug.txt’ 命令查看被记录的数据。

 

dd($data, $label = NULL)

 

ddebug_backtrace()

打印函数调用堆栈

 

db_queryd()

　　此函数是 db_query() 的调试版本，它能将数据库查询结果或错误信息显示到浏览器。当想要监控一些数据库请求信息，但又不希望列出当前页面所进行的所有数据库请求会很有用。

db_queryd($query, $args = array());