PHPCMSV9控制器模块开发文档

服务器要求PHP 版本5.2 或更新的版本。

MySQL版本推荐5.0或者更新版本。

模型-视图-控制器(MVC)MVC是一个设计模式，它强制性的使应用程序的输入、处理和输出分开。

使用MVC应用程序被分成三个核心部件：模型（M）、视图（V）、控制器（C），它们各自处理自己的任务。

视图：视图是用户看到并与之交互的界面。

对老式的Web应用程序来说，视图就是由HTML 元素组成的界面，在新式的Web应用程序中，HTML依旧在视图中扮演着重要的角色，但一些新的技术已层出不穷，它们包括Adobe Flash和象XHTML，XML/XSL，WML等一些标识语言和Web services。

如何处理应用程序的界面变得越来越有挑战性。

MVC一个大的好处是它能为你的应用程序处理很多不同的视图。

在视图中其实没有真正的处理发生，不管这些数据是联机存储的还是一个雇员列表，作为视图来讲，它只是作为一种输出数据并允许用户操纵的方式。

模型：模型表示企业数据和业务规则。

在MVC的三个部件中，模型拥有最多的处理任务。

例如它可能用象EJBs和ColdFusion Components这样的构件对象来处理数据库。

被模型返回的数据是中立的，就是说模型与数据格式无关，这样一个模型能为多个视图提供数据。

由于应用于模型的代码只需写一次就可以被多个视图重用，所以减少了代码的重复性。

控制器：控制器接受用户的输入并调用模型和视图去完成用户的需求。

所以当单击Web页面中的超链接和发送HTML表单时，控制器本身不输出任何东西和做任何处理。

它只是接收请求并决定调用哪个模型构件去处理请求，然后确定用哪个视图来显示模型处理返回的数据。

现在我们总结MVC的处理过程，首先控制器接收用户的请求，并决定应该调用哪个模型来进行处理，然后模型用业务逻辑来处理用户的请求并返回数据，最后控制器用相应的视图格式化模型返回的数据，并通过表示层呈现给用户。

文件目录结构根目录| – api 接口文件目录| – caches 缓存文件目录| – configs系统配置文件目录| – caches_* 系统缓存目录| – phpcms phpcms框架主目录| – languages 框架语言包目录| – libs 框架主类库、主函数库目录| – model 框架数据库模型目录| – modules 框架模块目录| – templates 框架系统模板目录| – phpsso_server phpsso主目录| – statics 系统附件包| – css系统css包| – images 系统图片包| – js系统js包| – uploadfile 网站附件目录| – admin.php 后台管理入口| – index.php 程序主入口| – crossdomain.xml FLASH跨域传输文件| – robots.txt 搜索引擎蜘蛛限制配置文件| – favicon.ico 系统icon图标URL访问PHPCMS是采用MVC设计模式开发,基于模块和操作的方式进行访问，采用单一入口模式进行项目部署和访问，无论访问任何一个模块或者功能，只有一个统一的入口。

下面我们将通讲解一个留言本实例，来帮助你更好的掌握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代码：CREATE TABLE `phpcms_guestbook` (`gid` smallint(5) NOT NULL auto_increment,`title` char(80) NOT NULL,`content` text NOT NULL,`reply` text NOT NULL,`userid` mediumint(8) unsigned NOT NULL default '0',`username` char(20) NOT NULL,`gender` tinyint(1) unsigned NOT NULL default '0',`head` tinyint(3) unsigned NOT NULL default '0',`email` char(40) NOT NULL,`qq` char(15) NOT NULL,`homepage` char(25) NOT NULL,`hidden` tinyint(1) unsigned NOT NULL default '0',`passed` tinyint(1) unsigned NOT NULL default '0',`ip` char(15) NOT NULL,`addtime` int(10) unsigned NOT NULL default '0',`replyer` char(20) NOT NULL,`replytime` int(10) unsigned NOT NULL default '0',PRIMARY KEY (`gid`),KEY `hidden` (`hidden`,`gid`));4.3创建模块目录PHPCMS v9框架中的模块，位于phpcms/modules目录中每一个目录称之为一个模块，如果要创建一个模块，只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。

phpcms使用手册Phpcms使用手册目录1.简介 (2)2.功能使用 (2)2.1我的面板 (2)2.1.1修改个人信息 (2)2.1.2修改密码 (3)2.1.3生成首页 (3)2.2设置 (4)2.2.1相关设置 (4)2.2.2管理员设置 (7)2.3模块 (11)2.3.1数据源 (11)2.4内容 (14)2.4.1内容发布管理 (14)2.4.2发布管理 (22)2.4.3内容相关设置 (22)2.5用户 (28)2.6界面 (28)2.6.1模板风格 (28)2.6.2标签向导 (30)2.7扩展 (30)2.8phpsso (30)1.简介PHPCMS V9（简称V9）采用PHP5+MYSQL做为技术基础进行开发。

V9采用OOP（面向对象）方式进行基础运行框架搭建。

模块化开发方式做为功能开发形式。

框架易于功能扩展，代码维护，优秀的二次开发能力，可满足所有网站的应用需求。

5年开发经验的优秀团队，在掌握了丰富的WEB开发经验和CMS 产品开发经验的同时，勇于创新追求完美的设计理念，为全球多达10万网站提供助力，并被更多的政府机构、教育机构、事业单位、商业企业、个人站长所认可。

V9在保留2008版的特点的同时，对新版本作出重大的创新，以期待全新的PHPCMS 系统服务更多的用户。

2.功能使用2.1我的面板2.1.1修改个人信息写入你要修改的数据：真实姓名，E-mail，语言。

提交后，如提示成功则可完成修改操作，否则提示错误消息。

如下图所示：2.1.2修改密码录入你的旧密码和修改的密码。

提交后，如提示成功则可完成修改操作，否则提示错误消息。

如下图所示：2.1.3生成首页如下图所示：点击“生成首页”。

如提示成功则可完成修改操作，否则提示错误消息。

成功信息:同时你也可以通过：当前位置菜单栏——>生成首页；进行生成首页。

2.2设置2.2.1相关设置2.2.1.1站点管理1、添加站点V9系统支持多站点发布，添加站点时可选择发布点，并且可以选择seo设置，站点模版，上传附件设置等选项。

控制器模块开发文档= beat 1.0 =编写：车险无忧日期：2014 / 06 / 30第一章控制器概述控制器，即为MVC设计模式中的控制（controller）模块，负责处理应用程序中用户交互的部分，通常负责控制用户输入，调取视图，向模型发送数据。

简单来说，当用户点击web中的超链接和发送HTML表单操作时，控制器开始处理用户输入内容，并且决定调用哪个模型来处理请求，并决定使用哪个视图来显示返回的数据。

在PHPCMS V9中，控制器也就是模块的类文件，位于phpcms/modules/模块/目录下面。

类名称为文件名.php。

但控制器类名称必须与控制器文件名称相同。

我们首先试试创建第一个程序：1.1 输出Hello world！我们创建一个简单的控制器，以便直观的了解其工作原理。

使用你喜欢的编辑器创建一个名为hello.php的文件，然后输入下面代码：classhello{functionindex(){echo'Hello World';}}然后在phpcms/modules目录下创建一个名为hello的文件夹，将刚刚创建的hello.php文件保存在phpcms/modules/hello文件夹下。

(phpcms/modules/hello/hello.php)现在，使用URLhttp://localhost/?m=hello&c=hello&a=index来访问您的网站，不出意外，你应该看到Hello World！（我们假设您的服务器在本地，如果在其他服务器上，你可以将localhost换成你的域名）。

第二章系统配置2.1 URL访问PHPCMS遵循MVC开发模式，基于控制器和操作的方式进行访问，采用单一入口index.php 进行项目的部署和访问，无论访问任何一个模块或者功能，都需要通过该文件。

http://localhost/?m=hello&c=hello&a=index&id=3* M = hello 为模型/模块的名称，位于phpcms/modules/content* C = hello为控制器名称，位于phpcms/modules/hello/hello.php* A = index为事件名称，位于phpcms/modules/hello/hello.php中index()方法。

PHPCMS v9模型二次开发[高级]概述：PHPCMS v9模型二次开发主要分为底层模型开发，即代码级的模型开发；其次，是可视化的模型开发，即通过登录系统后台添加模型。

第一种模型开发对技术要求很高，但是，能实现很多PHPCMS v9没有实现或者不能实现的功能。

第二种模型开发完全隐藏了技术的实现，操作简单，使用方便，在没有特殊功能的时候，这个是首先。

我们今天先讲第二种，可视化的模型开发。

假如，现在我们有一个产品展示功能。

要显示的信息如下：*）产品名称*）产品价格*）出厂时间*）规格参数*）配件列表*）产品图片然后，PHPCMS v9提供的文章模型、图片模型、下载模型根本不能满足我们的这个需求。

此时，我们就会涉及到添加模型的操作。

1、登录系统后台，进入导航“内容”----》"管理模型"然后，在页面的右边找到“添加模型”，点击进入添加模型：模型名称必须填写，当我们在添加栏目的时候就可以选择以这个名称命名的模型了。

模型表键名也必须填写，这个将会在数据库里面有二张表对应，假设此时的表前缀是:v9_则对应的两张表名为：v9_products、v9_products_data2、点击确定创建好自定义的“产品模型”之后，点击“字段管理”点击“字段管理”之后，在弹出的页面里面进行字段的禁用、删除、添加等操作。

比如：添加产品名称、产品价格、产品规格、出厂时间等字段。

删除：阅读收费、允许评论、分页方式、相关文章等字段。

禁用：关键词、推荐位等字段。

删除字段与禁用字段都很方便快捷，现在来谈谈添加字段。

在点击“字段管理”进入页面后，左上角会有一个“添加字段”的功能。

点击“添加字段”进入页面。

如图：我们以添加一个是否显示产品的功能字段，那么在字段类型那里可以选择“选项”；由于，我们会经常使用这个字段进行查询，所以，我们在“作为主表字段”设置为是；字段名设置为isshows,这个地方的字段名对应表中的v9_products表中的字段，添加字段完成之后，可以在这个表中看得出来。

phpcmsv9代码分析（三）这篇讲讲模型。

1. phpcms/libs/classes/model.class.php这是所有模型类的父类，其他模型类继承它，设置表名，表前缀。

1 2 3 4 5 6 7 8pc_base::load_sys_class('db_factory', '', 0); class model { protected $db_config = ''; //数据库配置 protected $db = ''; //数据库连接 //调用数据库的配置protected $db_setting = 'default';项9 protected $table_name = ''; 1 0 public 1 1 1 2 1 3 1 4 1 5 1 6 1 7 1 8 { $this->db_setting = 'default'; } $this->table_name = $this->db_config[$this->db_setting]['tablepre'].$this>table_nam e; $this->db_tablepre = $this->db_config[$this->db_setting]['tablepre']; $this->db = db_factory::get_instance($this->db_config)->get_database($this->db_setting); } ............ } public function __construct() { if (!isset($this->db_config[$this->db_setting])) $db_tablepre = ''; //表前缀 //数据表名该类还定义了通用的数据库操作函数。

[PHPCMS V9二次开发]自定义字段模型-文本组∙浏览： 365∙更新： 2012-03-08 11:44举报作者声明：本篇经验系本人依照真实经历原创，未经许可，谢绝转载。

PHPCMS V9，我们在做作者声明：本篇经验系本人依照真实经历原创，未经许可，谢绝转载。

PHPCMS V9，我们在做类似于酒店房型等类型的时候，需要用到文本组字段模型，但PHPCMS并未提供该模型。

如下图所示效果：展示效果如下：步骤/方法1.打开phpcms\modules\content\fields目录，复制文件夹downfiles,并改名为textgroups。

2.打开phpcms\modules\content\fields\fields.inc.php文件，增加字段类型：'textgroups'=>'多文件上传',3.打开phpcms\modules\content\fields\textgroups目录（第一步复制的文件夹），修改以下文件：4.form.inc.phpfunction textgroups($field, $value, $fieldinfo) {extract(string2array($fieldinfo['setting']));$list_str = '';if($value) {$value = string2array(html_entity_decode($value,ENT_QUOTES));if(is_array($value)) {foreach($value as $_k=>$_v) {$list_str .= "<div id='textsgroups{$_k}'> <input type='text'name='{$field}_fx[]' value='{$_v[fx]}' style='width:100px;'class='input-text'> <input type='text' name='{$field}_fj[]'value='{$_v[fj]}' style='width:100px;' class='input-text'><input type='text' name='{$field}_cx[]' value='{$_v[cx]}'style='width:100px;' class='input-text'> <input type='text'name='{$field}_kd[]' value='{$_v[kd]}' style='width:100px;'class='input-text'> <input type='text' name='{$field}_vip[]'value='{$_v[vip]}' style='width:100px;' class='input-text'> <a href=\"javascript:remove_div('textsgroups{$_k}')\">".L('remove_ out')."</a></div>";}}}$string ='<script type=text/javascript>function add_textsfile(returnid) {var ids = parseInt(Math.random() * 10000);var str = "<li id=\'textsgroups"+ids+"\'> <input type=\'text\' name=\'"+returnid+"_fx[]\' value=\'\' style=\'width:100px;\'class=\'input-text\'> <input type=\'text\'name=\'"+returnid+"_fj[]\' value=\'\' style=\'width:100px;\'class=\'input-text\'> <input type=\'text\'name=\'"+returnid+"_cx[]\' value=\'\' style=\'width:100px;\'class=\'input-text\'> <input type=\'text\'name=\'"+returnid+"_kd[]\' value=\'\' style=\'width:100px;\' class=\'input-text\'> <input type=\'text\'name=\'"+returnid+"_vip[]\' value=\'\' style=\'width:100px;\' class=\'input-text\'> <ahref=\"javascript:remove_div(\'textsgroups"+ids+"\')\">Remove</a> </li>";$(\'#\'+returnid).append(str);}</script>';$string .= '<input name="info['.$field.']" type="hidden"value="1"><fieldset class="blue pad-10"><legend>'.L('mm_fxlist').'</legend><div id="tt"><input type="text" value="'.L('mm_fx').'" readonlystyle="width:100px;border:0;" class="input-text"><input type="text" value="'.L('mm_fj').'" readonlystyle="width:100px;border:0;" class="input-text"><input type="text" value="'.L('mm_cx').'" readonlystyle="width:100px;border:0;" class="input-text"><input type="text" value="'.L('mm_kd').'" readonlystyle="width:100px;border:0;" class="input-text"><input type="text" value="'.L('mm_lyj').'" readonlystyle="width:100px;border:0;" class="input-text"></div>';$string .= $list_str;$string .= '<ul id="'.$field.'" class="picList"></ul></fieldset><div class="bk10"></div>';$string .= $str."<input type=\"button\" class=\"button\"value=\"".L('mm_addfx')."\"onclick=\"add_textsfile('{$field}')\">";return $string;}5.修改input.inc.phpfunction textgroups($field, $value) {$hotel = $_POST[$field.'_fx'];$hotel_fj = $_POST[$field.'_fj'];$hotel_cx = $_POST[$field.'_cx'];$hotel_kd = $_POST[$field.'_kd'];$hotel_vip = $_POST[$field.'_vip'];$array = $temp = array();if(!empty($hotel)) {foreach($hotel as $key=>$hote) {$temp['fx'] = $hote;$temp['fj'] = $hotel_fj[$key];$temp['cx'] = $hotel_cx[$key];$temp['kd'] = $hotel_kd[$key];$temp['vip'] = $hotel_vip[$key];$array[$key] = $temp;}}$array = array2string($array);return $array;}6.修改的output.inc.phpfunction textgroups($field, $value) {return string2array($value);}7.更新后台缓存。