Drupal专业开发全面指南：从基础到高级

需积分: 6 65 浏览量更新于2024-08-02 收藏 5.11MB PDF 举报

《Drupal专业开发指南》是一本详尽的教程，涵盖了Drupal框架的核心概念和实践技能。该文档旨在为Drupal开发者提供全面的学习资源，从基础到高级，包括但不限于以下几个关键章节： 1. **Drupal工作原理**：这一章介绍了Drupal如何作为内容管理系统运作，涉及请求处理和服务提供，帮助读者理解整个平台的工作机制。 2. **模块开发**：从创建第一个模块开始，讲述了模块的结构、功能设计以及如何将其集成到Drupal核心。这包括模块的生命周期管理、配置选项等。 3. **模块特定设置**：这部分深入探讨了如何针对不同模块进行个性化设置，确保其与整体系统的兼容性和优化。 4. **Drupal菜单系统**：菜单是 Drupal 界面的重要组成部分，本章节讲解了菜单的创建、管理以及如何通过它们组织内容和功能。 5. **数据库层**：Drupal的数据存储和查询方式是开发中的关键环节，第5章详细解释了如何与数据库交互，包括CRUD操作和数据模型设计。 6. **用户管理**：包括用户注册、登录流程，以及Drupal提供的用户角色和权限系统，这是保证网站安全和管理的基础。 7. **节点系统**：Drupal的核心内容单位——节点，涉及到创建、编辑和展示，以及它们在主题和模块中的应用。 8. **主题系统**：Drupal的主题设计是实现个性化界面的关键，涵盖了主题安装、模板文件、高级特性的使用，如覆盖默认功能、自定义变量和区块区域。 9. **区块**：区块是可复用的UI组件，本章讲解了区块的创建、钩子方法以及如何在主题中灵活布局。 10. **表单API**：表单API是Drupal中构建交互式用户界面的重要工具，本部分阐述了表单处理流程，以及如何创建各种类型和跨页面的表单。通过阅读这份指南，无论是初次接触Drupal还是寻求进阶知识的开发者，都能系统地学习和掌握Drupal开发的核心技术，提升项目开发效率和用户体验。无论是设计功能丰富的模块、创建美观的主题，还是构建复杂的业务逻辑，这本书都是不可或缺的参考资料。

16 / 303

这个例子看起来有些复杂，所以让我们详细的分析一下。首先，注意到我们在这里实现

了 Drupal 的另一个钩子。这次是 _nodeapi，在 drupal 对节点进行各种处理的时候将会调

用它，所以其他模块（比如我们的）在处理过程继续之前可以修改节点。我们使用变量 $node

来表示一个节点。注意第一个参数前面的 & 意味着对于 $node 对象这里使用参数传递，

这非常棒，因为我们在这里对 $node 所做的任何修改将被保存下来。我们的目标是追加一

个表单，所以我们非常高兴我们可以修改节点。

我们仍然需要一些在我们的代码被调用时 Drupal 内部将会发生什么的信息.这些信息

保存在参数 $op 中了，它可以是 insert（节点被创建），delete（节点被删除），或者一个其

它的值。当前，我们仅对当节点被准备显示出来时，修改节点感兴趣。在这种情况，变量 $op

的值为 view。我们在这里是用了 switch 控制语句，这样我们可以非常容易的看到在每种

情况下我们的模块将会做什么。

接下来，我们快速的检查了一些我们不想呈现注释域的情况。一种情况是当参数 $teaser

为真时。如果它为真，这意味着，这个节点并不是单独呈现了，而是呈现在一个列表中，比

如说一个搜索引擎的结果中。在这种情况下，我们不需要添加任何东西。另一种情况是

$user 对象的用户 ID 为0时，这意味着用户没有登录。（注意，在这里我们是用了关键字

global 来把 $user 对象引进来）。我们使用 break 语句来跳出 switch 语句从而阻止修改页

面。

在我们为 web 页面添加注释表单的以前，我们需要检查一下，将要进行显示的节点的

类型是不是我们在设置页面所设置的类型中的一个，所以我们回显了在我们实现的设置钩子

中所保存的节点类型，并将它保存到了具有可读性的变量 $types_to_annotate 中去。对于

variable_get() 中的第2个参数，我们在这里声明了一个默认数组，用于当站点管理员还没有

访问我们的模块的配置页面并设置配置属性的情况。下面要做的就是检查一下，我们所要

处理的节点的类型是不是确实是 $types_to_annotate 中的一种。同样，我们使用了 break 语

句来放弃，如果节点类型不是我们想要注释的时候。

我们最后要做的就是创建表单，并把它添加到 $node 对象的内容属性中去。首先，我

们需要定义一个表单，这样我们就有了添加的东西。我们将在一个单独的函数中完成这件事，

它的唯一责任就是定义表单：

/**

* Define the form for entering an annotation.

function annotate_entry_form($node) {

$form['annotate'] = array(

'#type' => 'fieldset',

'#title' => t('Annotations')

);

$form['annotate']['nid'] = array(

'#type' => 'value',

'#value' => $node->nid

);

$form['annotate']['note'] = array(

'#type' => 'textarea',

'#title' => t('Notes'),

17 / 303

'#default_value' => $node->annotation,

'#description' => t('Make your personal annotations about this content here. Only you (and

the site administrator) will be able to see them.')

);

$form['annotate']['submit'] = array(

'#type' => 'submit',

'#value' => t('Update')

);

return $form;

}

和我们在函数 annotate_admin_settings() 使用的方式一样，通过创建一个键入的数组我

们创建了表单—只是在这次我们把我们的文本输入框和提交按钮放到了 fieldset 中去，这样

他们在 web 页面中就组织到了同一个组下。首先，我们创建一个数组，它的 #type 为

fieldset，并为它提供了一个标题。然后我们创建文本域数组。注意，文本域数组的数组键是

fieldset 数组中的一员。换句话说，我们使用 $form['annotate']['note'] 替换了 $form ['note']。

这样，Drupal 将把这个文本域元素当作 fieldset 元素中的一员。最后，我们创建了提交按

钮，然后返回了定义我们表单的数组。

现在让我们回到 annotate_nodeapi() 上，通过向节点的内容添加一个 #value 和一个

#weight，我们将创建的表单追加到了页面的内容上。值包含了要展示的内容，重量告诉

Drupal 把它展示到哪里。我们想把我们的注释表单放到页面的下面，所以我们为它分配了

一个相对较大的重量10。我们要展示的是我们的表单，所以我们调用函数 drupal_get_form()

来将我们的表单从一个描述如何创建它的数组的形式转化为最终的 HTML 表单。注意，在

这里我们事如何将 $node 对象传递到我们的表单函数中去的。我们需要这样做来得到以前

的注释并把它预先填充到表单中。

使用你的 web 浏览器查看一个页面，你应该可以看到这个用于追加的注释表单（如图

2-2所示）：

图2-2 出现在 drupal web 页面上的注释表单

当我们点击 Update 按钮时，将会发生什么呢？什么都没有，因为我们还没有为它写任

何代码呢。现在就让我们添加这些代码。但是在我们出发以前，我们不得不考虑一下我们将

把用户输入的数据存储到哪里。

把数据存储到数据库表中

存储一个模块的数据的最常用的方式是为这个模块创建一个单独的数据库表。这将使得

模块的数据与 drupal 核心数据表区分开来。当决定为你的模块创建那些字段时，你应该问

自己：你需要存储哪些数据？如果我对这个表进行查询时，我将需要什么？最后，还要为我

19 / 303

);"

);

$success = TRUE;

break;

default:

drupal_set_message(t('Unsupported database.'));

}

if ($success) {

drupal_set_message(t('The module installed tables successfully.'));

}

else {

drupal_set_message(t('The installation of the annotate module was unsuccessful.'),'error');

}

这个文件简单直接。当第一次启用 annotate 模块时，drupal 会寻找文件 annotate.install

并运行函数 annotate_install()，如果一切顺利的话，数据库表将被创建。通过禁用然后再启

用这个模块，现在就可以完成它。

秘密消息：如果在你的 .install 文件中包含一个文字错误,或者由于其他原因执行失败，

你可以使 drupal 忘记你的模块和它对应的表，Administer > Site building > Modules 禁用你

的模块，然后在数据库的 system 表中删除对应模块的一行。

当创建了用以存储数据的表以后，我们将不得不对我们的代码做一些修改。其一，我们

将需要添加一些代码，一旦用户填入注释并且点击 Update 按钮以后，用来解决对数据的处

理流程。我们用于表单提交的函数如下：

* Save the annotation to the database.

function annotate_entry_form_submit($form_id, $form_values) {

global $user;

$nid = $form_values['nid'];

$note = $form_values['note'];

db_query("DELETE FROM {annotations} WHERE uid = %d and nid = %d", $user->uid,

$nid);

db_query("INSERT INTO {annotations} (uid, nid, note, timestamp) VALUES (%d, %d,

'%s', %d)", $user->uid, $nid, $note, time());

drupal_set_message(t('Your annotation was saved.'));

}

由于我们仅允许一个用户对一个节点只能有一个注释，所以我们可以安全的删除以前的

注释（如果存在的话）然后插入我们自己的到数据库中。对于我们于数据库的交互，有几

点需要注意。首先，我们不需要考虑数据库连接，这是因为在 Drupal 的引导程序中他已经

为我们完成了这一工作。第2，当我们是用一个数据库表时，我们需要把它放到花括号里 {}。

这样可使数据库的前缀化无缝的集成（参看 http://drupal.org/node/2622）。第三，我们在查询

语句中使用了占位符，然后为其提供相应的变量，这样 Drupal 内建的查询清洁机制可以启

20 / 303

用以阻止 SQL 注入攻击。我们使用 %d 占位符用于数字，使用 %s 占位符用于字符串。

然后，我们使用 drupal_set_message() 来在用户的会话中插入一消息，它将会在用户查看的

下一个页面中被 Drupal 作为一个通知展示出来。这样，用户可以获得一些反馈信息。

最后，我们需要修改我们的 nodeapi 钩子代码，这样的话，如果已经存在了一个注释，

它将被从数据库中取出。恰好在我们把我们的表单分配给 $node->content 以前，我们添加

以下代码：

// Get previously saved note, if any.

$result = db_query("SELECT note FROM {annotations} WHERE uid = %d AND nid = %d",

$user->uid, $node->nid);

$node->annotation = db_result($result);

我们首先查询数据库以取出这一用户对一节点所做的注释。接着，我们使用 db_result

来从结果集中取出第一行。由于我们仅允许一个用户对同一节点只能做一个注释，所以结果

集中也只有一行。

测试你的模块。他现在应该能够保存和回显注释了。拍下你的背---你已经从头开始创建

了一个模块了。现在你已经站在了成为Drupal核心开发者的大道上了。

更远的一些步骤

我们将与开源社区分享这一模块，这是自然的，所以需要创建一个 README.txt 文件，

然后把它放到 annotation 的目录下，和 notate.info、annotate.module、annotate.install 文件

放在一起。接下来，你可以把它上传到 drupal.org 上的贡献模块库中，然后创建一个项目

页面来追踪社区中其他用户的反馈。

总结

当读完这一章后，你应该可以：

从头创建一个 Drupal 模块

了解如何钩住 Drupal 代码的执行

存储和回显特定模块的设定

使用 Drupal 的表单 API 来创建和处理一些简单的表单

使用数据库来存储和回显数据。

第3章模块特定设置（1）

当你自己创建一个模块时，你常常想让站点管理员能够通过选择不同的模块设置属性

来改变模块的行为。本章将详细讲述如何将一个模块呈现在 Drupal 的管理页面，如何为用

户呈现一个关于设置的表单，以及存储设置属性。

把你的模块放到管理页面的模块列表中

Drupal 的管理页面为站点管理员展示了不同的站点配置选项。你想在这个配置页面找

个未知把你的模块放下，这样站点管理员就可以调整你的模块的设置。现在让我们为前章所

创建的注释模块添加更多的配置选项。

创建一个链接

我们需要在管理页面提供一个链接，这样站点管理员可以进入修改我们设置的页面。通

过在菜单钩子（关于更多的菜单钩子的信息，参看第4章）上创建一个入口，我们将链接放

剩余302页未读，继续阅读

ldxdqi

粉丝: 2
资源: 1

Drupal专业开发全面指南：从基础到高级

drupal学习资料包

Drupal专业开发指南（中文版）.pdf

drupal专业开发指南（中文版）.pdf

Apress.Pro.Drupal.Development.Apr.2007.pdf

Apress.Drupal.8.for.Absolute.Beginners.pdf

Apress.Pro.Drupal.Development.2nd.Aug.2008.pdf

Drupal专业开发指南

Drupal 5 Themes.pdf

Drupal详细介绍.pdf

Packtpub.Drupal.7.Sep.2010.rar

最新资源