Drupal文档教程翻译 - 代码片段使用指南 (2) - VII II X - Joomla控，Drupal粉 - 开源CMS建站新闻杂谈、文档教程、案例介绍、扩展相关、个人博客及收藏

Drupal文档教程翻译 - 代码片段使用指南 (2)

Drupal文档教程翻译 - 代码片段(snippet) Friday, 30 July 2010 09:16

本站原创编译，转载请给面子，尊重劳动果实，欢迎交流指正。

各位早，炎热的Drupal文档中文翻译时间。昨天我们开始搞代码片段snippet方面的话题，了解了一些有关snippet的概念和常识；今天来具体看看怎样使用PHP代码片段。在系统中或是主题模板中添加PHP代码snippet的方式有很多种，我们来看一些比较典型的。

直接修改系统中的PHP文件

最简单直接的方式；有时在第一次对系统原生PHP文件做过修改之后，会看到出错提示“Parse error: syntax error, unexpected '<'”，问题出在我们所添加的snippet的PHP标签上面。在我们将来所能见到提供PHP snippet的Druapl文档，所有的代码片段都是被“”标签封装的，就像普通的PHP代码，但实际上当我们使用这些snippet的时候，需要把这对标签去掉。

例如下面是一段比较典型的snippet，在使用时，我们只需要把里面function的部分拿出来放到所需的地方即可；另外注释文字也向我们说明了这一点：

<?php
/** The actual snippet starts on this line. But this line is just a comment, it doesn't do anything */
function do_very_complicated_stuff ($drupal) {
  $inexplicable = confusing(
etc...
 
/** The snippet ends here. This line is just a comment */
?>

在管理后台的用户界面中直接添加snippet

有时我们可以直接在管理后台里面使用PHP snippet，例如block、node和views的管理设置中；有些PHP snippet也只能通过这种方式来添加。但是要记得，我们首先需要到Administer › Site building › Modules 里面启用PHP Filter模块，否则系统将不会通过编辑器识别这些PHP代码。

启用了PHP Filter之后，我们可以试着创建一个新内容节点，在编辑器下面应该已经可以看到有关PHP输入格式的选项了；要在内容中使用可执行的PHP代码，必须选中该选项。如果启用了模块之后还是无法看到该选项，那么很可能是当前使用的用户类型没有PHP代码权限；可以尝试到Administer › Site configuration › Input formats 中，以及Administer › User management › Permissions 中进行相关设置。

如果我们正在使用FCKedit或是TinyMCE一类的高级编辑器，记得在粘贴PHP代码之前将模式切换为源码。

需要注意的是，在这种管理后台直接添加snippet的方式中，多数情况下不需要去除PHP的封装标签；例如在block设置中为指定的页面设置该block的公开状态，这时我们必须使用完整的带有PHP标签的snippet代码。

下面的几篇相关文档可作为参考补充：