让我们从头到脚仔细的看看一个模块的基干,同时将不同类型的文档从中选出来进行单独说明。
模块的第2行(在<?php开始标签之后),应该包含一个CVS标签,用来追踪文件的版本号:
// $Id$
当把代码提交到CVS以及使用CVS更新代码(CVS的代码是最新的)时,系统将会自动对这一标签进行解析和扩展。之后,它将自动地变成下面的样子:
// $Id: comment.module,v 1.617.2.2 2008/04/25 20:58:46 goba Exp $
在本章后面,你将学到更多关于如何使用CVS的知识。
在声明函数以前,你需要花点功夫为模块写点文档,介绍模块能做什么,文档的格式如下所示:
/**
* @file
* One-line description/summary of what your module does goes here.
*
* A paragraph or two in broad strokes about your module and how it behaves.
*/
为常量编写文档
PHP常量全部都应该大写,可以使用下划线分隔单词。当定义PHP常量时,最好能够解释一下它们是用来做什么的,如下面的代码片段所展示的这样:
/**
* Role ID for authenticated users; should match what's in the "role" table.
*/
define('DRUPAL_AUTHENTICATED_RID', 2);