您现在的位置是：首页 > cms教程 > phpcms教程phpcms教程

phpcms二次开发新建模块

张豆焕2025-05-20phpcms教程已有人查阅

导读1、新建模块就是phpcms/modules/目录下面新建文件夹，文件夹名即为模块名。2、模块内一般新建三个文件夹：classes（模块要使用的类放置在这个文件夹，通过pc_base::load_app_classes()函数加载使用）///

1、新建模块就是phpcms/modules/目录下面新建文件夹，文件夹名即为模块名。
2、模块内一般新建三个文件夹：classes（模块要使用的类放置在这个文件夹，通过pc_base::load_app_classes()函数加载使用）///
functions（模块要使用的函数放置在这个文件夹，通过pc_base::load_app_func()函数加载使用）////
template（模块后台管理的模板文件，通过

$this->admin_tpl()方法调用）///

除此之外，经常还有install文件夹和uninstall文件夹。具体参照安装源码包。
3、模块的实现机制。
控制器：即模块内的一个php文件，这是个类文件，文件名和文件内定义的类名必须一致。
当我们在浏览器输入index.php?m=模块名&c=控制器名&c=控制器内方法名时候，首先找到模块文件夹，再找到控制器，然后调用控制器内的方法。
控制器内方法一般有两类：
（1）显示一些内容；
（2）处理提交的内容；
对于“显示一些内容”的方法，首先准备一些模板中需要使用的变量，然后使用include template('','')调用模板。最重要的是模板的调用，模板中需要的变量必须在控制器内的方法中定义。
一般如下：

public function list_type() {
$siteid = SITEID;
$type_id = trim(urldecode($_GET['type_id']));
$type_id = intval($type_id);
if($type_id==""){
$type_id ='0';
}
$setting = getcache('link', 'commons');
$SEO = seo(SITEID, '', L('link'), '', '');
include template('link', 'list_type');//这一句是模板调用，这一句上面的语句基本都是为这一句做准备
}

对于“处理提交的内容”，一般结构是这样的：

public function register() {
$siteid = SITEID;//定义下面所需变量
if(isset($_POST['dosubmit'])){//如果提交按钮按下去了，执行下面的操作，一般就是插入数据库并显示插入成功
if($_POST['name']==""){
showmessage(L('sitename_noempty'),"?m=link&c=index&a=register&siteid=$siteid");
}
if($_POST['url']==""){
showmessage(L('siteurl_not_empty'),"?m=link&c=index&a=register&siteid=$siteid");
}
if(!in_array($_POST['linktype'],array('0','1'))){
$_POST['linktype'] = '0';
}
$link_db = pc_base::load_model(link_model);//加载数据模型
$_POST['logo'] =new_html_special_chars($_POST['logo']);
$logo = safe_replace(strip_tags($_POST['logo']));
$name = safe_replace(strip_tags($_POST['name']));
$url = safe_replace(strip_tags($_POST['url']));
if($_POST['linktype']=='0'){
$sql = array('siteid'=>$siteid,'typeid'=>intval($_POST['typeid']),'linktype'=>intval($_POST['linktype']),'name'=>$name,'url'=>$url);
}else{
$sql = array('siteid'=>$siteid,'typeid'=>intval($_POST['typeid']),'linktype'=>intval($_POST['linktype']),'name'=>$name,'url'=>$url,'logo'=>$logo);
}
$link_db->insert($sql);//执行数据插入操作
showmessage(L('add_success'), "?m=link&c=index&siteid=$siteid");//显示插入成功
} else { //否则就显示页面，等待输入并提交
$setting = getcache('link', 'commons');
$setting = $setting[$siteid];
if($setting['is_post']=='0'){
showmessage(L('suspend_application'), HTTP_REFERER);
}
$this->type = pc_base::load_model('type_model');
$types = $this->type->get_types($siteid);//获取站点下所有友情链接分类
pc_base::load_sys_class('form', '', 0);
$SEO = seo(SITEID, '', L('application_links'), '', '');
include template('link', 'register');
}
}

4、关于模板
模板中使用的是标签技术，比如内容模块中，用来显示分类的标签如下：

{pc:content action="lists" catid="15" num="8" order="id DESC" page=""}

那么，如果是我们自己定义的模块呢？应该是这个样子：

{pc:模块名 action="动作函数" catid="15" num="8" order="id DESC" page=""}

模块名不用多说，就是刚才我们定义的文件夹名。那么动作函数是哪来的呢？它定义在模块名/classes目录下的“模块名_tag.class.php”中，同样，这个类文件内主类名也应该是“模块名_tag”，此中定义一个名为“动作函数”的方法。这个方法接收一个参数data，这是一个数组参数，数组的键名就是上面的action,catid,num,order,page等等（这些变量名是可以自己定义的），值就是“动作函数”,15,8,等。
一个典型的格式如下：

public function type_lists($data) {
if (!in_array($data['listorder'], array('desc', 'asc'))) {
$data ['listorder'] = 'desc';
}
$sql = array('module'=>ROUTE_M,'siteid'=>$data['siteid']);
$r = $this->type_db->select($sql, '*', $data['limit'], 'listorder '.$data['listorder']);
return new_html_special_chars($r);
}