2014二次开发实例–留言本.docVIP

下面我们将通讲解一个留言本实例，来帮助你更好的掌握PHPCMS V9的二次开发流程。并在开发过程中体验PHPCMS V9。 在此我们只做基本功能的演示，更多的功能开发，期待你的继续挖掘。 4.1需求分析 本实例用PHPCMS V9基础功能开发设计一个留言本管理系统，要求如下： 后台： 可管理、回复、删除留言信息 可控制留言是否前台显示 可对留言系统配置设置选项，例如是否起用验证码，默认是否显示、是否允许游客留言等配置。模块配置信息可多站点存储。 可批量管理所有未回复留言 后台管理演示效果如下图所示： 前台： 根据后台模块配置选项，控制是否显示在线留言填写表单。 在线提交留言，根据后台配置选项，是否显示验证码，是否需管理员审核显示。 留言列表页，需根据后台配置每页条数进行分页。 前台演示效果如下图所示： 4.2数据库和数据表的设计 这里使用Mysql数据库来存储信息。 首先构建一个留言信息表 guestbook ， 它有12个字段，即消息编号(gid)，站点ID(siteid)，标题(title)，内容(content)，回复内容(reply)，回复状态(reply_status)，会员ID(uid)，会员姓名(username)，审核状态(passed) ，留言时间(inputtime)，回复人(replyer)，回复时间(replytime)。下面是创建该表的SQL代码： 4.3创建模块目录 PHPCMS v9框架中的模块，位于phpcms/modules目录中 每一个目录称之为一个模块，如果要创建一个模块，只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。 当前我们要开发一个叫做guestbook的留言本模块，那么首先在?phpcms/modules 目录下创建文件夹，并将其命名为guestbook。 如下图所示： guestbook 模块的标准结构通常是这样的，如下图所示： 其中 classes? 为模块类库包 functions?为模块函数库包 templates?为模块模板包?这里通常放置含有权限控制的控制器模板，也就是后台模板。 如果您的模块有单独的前台模版，你需要在phpcms/templates/default下创建一个您的模块同名目录来放置前台模板，“default”为你的风格包名称，我们默认适用default。 4.4创建数据模型类文件 建好数据表，创建完模块文件夹以后，接下来进行留言本数据模型的创建。 数据库模型位于：phpcms/model/ 目录下。 数据模型文件的命名规则建议为数据表名称+_model.class.php 如果在我们的创建的模块中我要使用一个数据表“test”，首先需要建立一个数据库模型文件，文件名称为test_model.class.php，程序结构如下图： 在实例中，只需要把加粗字换成当前数据表名即可。 在本例中guestbook_model.class.php数据模型文件为留言本信息表数据模型，结构如下： 说明：任何自定义模块的数据模型类，均继承于model.class.php 数据模型基类。在此基类中PHPCMS 系统已经把最常用的数据库操作方法进行了封装。 二次开发者不必关于如何操作数据库，只需要根据需要用到的，已定义操作方法的要求，传递参数即可。系统会自动对数据进行处理，并返回定义结果。 4.5开发模块控制器和函数 在上面的创建模块中我们已经创建好了一个名为“guestbook”的留言本模块，接下来我们继续为这个模块添加两个控制器类。 PHPCMS V9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。类名也就是文件名+.php，例如一个名为guestbook的控制器，那么他的命名为guestbook.php即可。控制器类默认继承系统的函数库，可以直接使用。需要注意的是：控制器类的类名称与控制器文件名必须相同。 本留言本模块有以下二个控制器 控制器名称 默认调用控制函数 说明 index.php init() 前台页面控制器 guestbook.php init() 后台管理控制器 下面将对二个控制做分别一个详细介绍。 4.5.1前台index.php控制器开发 前台控制器主要涉及前台留言显示、在线留言的提交处理等功能函数，以下为全部源代码，接下来我们将对每个功能块，做个详细介绍，代码如下图所示： 接下来将对本控制程序的每一段代码后对其进行分析和解释。