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

phpcms新建模块安装使用方法教程

卢帆新2025-05-16phpcms教程已有人查阅

导读1.安装配置---小问题：估计就我这么傻 T-T ，改成自己的目录名。2.模块的目录：模块存放在modules文件夹里，打开这个文件夹，里面的一个文件夹代表一个模块。3.建立模块以及其基本目录结构。

1.安装配置---小问题：
估计就我这么傻 T-T ，改成自己的目录名。
2.模块的目录：
模块存放在modules文件夹里，打开这个文件夹，里面的一个文件夹代表一个模块。
3.建立模块以及其基本目录结构。
现在新建个test模块，要在phpcms/modules目录下新建个myself目录（这个test目录就是模块）
再依次新建classes、functions、install、templdates、uninstall目录
4.创建了模块的基本目录以后，需要为新建模块做安装准备
4.1 新建myself模块的配置文件
在install目录下新建一个config.inc.php文件，

defined('IN_PHPCMS') or exit('Access Denied');
defined('INSTALL') or exit('Access Denied');
$module = 'myself'; //模块的标识符，唯一性，不可重名,应该和目录同名
$modulename = '挂件';
$introduce = '测试模块，用来测试的';
$author = '挂件';
$authorsite = 'http:// .guajian.com';
$authoremail = 'guajian@sina.com';

配置好了以后保存，然后回到后台，更新缓存，点击模块管理，可以看到：
不用点击安装。
4.2 将模块添加到左侧菜单栏
在新建的myself模块目录下的install目录里，新建个extention.inc.php文件，,填写以下代码，注意，parentid中的29是上面一级菜单模块这个菜单的Id号，如果要在主菜单显示，可以parentid的值改为0，如果要在指定菜单中显示，可以把parentid改成对应菜单id 的值即可，菜单的id可以在扩展中的菜单管理中查看。

<?php
defined('IN_PHPCMS') or exit('Access Denied');
defined('INSTALL') or exit('Access Denied');
$parentid=$menu_db->insert(array('name'=>'myself',
'parentid'=>29,
'm'=>'myself',
'c'=>'myself',
'a'=>'init',
'data'=>'',
'listorder'=>0,
'display'=>'1'
),true);
// 这里可以生成管理菜单，也就是生成当前菜单的子菜单
$language=array('myself'=>'挂件');
?>

4.3新建模块后台类文件(类文件就是控制器) 和模板文件（就是视图）-MVC
phpcms的url是这样的index.php?m=admin&c=index&a=public_main,
m的值表示是模块名，c表示是类名，a表示的是类的方法名，在上一步中，我们已经向菜单表中插入一条模块名为test，类名为test，方法名为init的条菜单记录。所以就必需在myself模块(即myself根目录)中新建一个myself类文件，并添加init方法，代码如下。

<?php
defined('IN_PHPCMS') or exit('No permission resources.');
pc_base::load_app_class('admin','admin',0);
class myself extends admin {
function __construct() {
parent::__construct();
}
public function init() {
include $this->admin_tpl('myself');
}
}
?>

上述init方法调用了myself模版，所以必需要在myself/templdates目录下新建对应模块，现在新建个myself.tpl.php文件，命名规则是 .tpl.php

<?php
defined('IN_ADMIN') or exit('No permission resources.');
include $this->admin_tpl('header','admin');
?>
<div class="pad_10">
我可是你的挂件啊
</div>
</body>
</html>

4.4之后一步，安装模块：
安装模块就要往数据库表单里添加信息，所以先写一个插入模块信息的sql文件
在install文件夹里新建个modules.sql文件，代码如下

INSERT INTO `v9_module` (`module`, `name`, `url`, `iscore`, `version`, `description`, `setting`, `listorder`, `disabled`, `installdate`, `updatedate`) VALUES ('myself', '挂件', 'myself/', '0', '1.0', '', '挂件', '0', '0', '2017-05-03', '2017-05-03');

iscore如果为1,表示是系统内置模块，是必选模块，对于二次开发来说，写为0即可。disabled如果为1表示禁止卸载，如果为0表示可卸载，根据需求，当前要实现的是可安装和卸载。setting是模块的配置变量，用来设置模块的一些基本信息，值为一个字符串数组。例如，表单向导中的模块配置功能。
4.5创建数据表模型类
各模块的数据表模型位于：phpcms/model/ 目录下。
数据模型文件的命名规则建议为：数据表名称 + '_model.class.php'
打开install目录，新建model.php文件.
写上以下代码

defined('IN_PHPCMS') or exit('Access Denied');
defined('INSTALL') or exit('Access Denied');
return array('myself');

作用是用来定义模块的表名，在安装时模块时，系统会根据这个数组的值调用同目录下的同名sql文件。
而在phpcms中，一个表对应一个模型类文件。因为，上面在model文件中的返回数组中添加了一个值 array（myself），对应的，就要新建一个同名的sql文件和一个model文件。
先在install目录下新建一个myself.sql文件

DROP TABLE IF EXISTS `v9_test`;
CREATE TABLE `v9_test (
`id` mediumint(8) unsigned DEFAULT '0',
`name` char(20) NOT NULL,
PRIMARY KEY (`id`),
KEY `id` (`id`)
) TYPE=MyISAM COMMENT '挂件表';

作用：在数据库生成了一张当前模块需要使用的名为myself的表
然后在phpcms/model目录新建个myself_model.class.php文件

<?php
defined('IN_PHPCMS') or exit('No permission resources.');
pc_base::load_sys_class('model', '', 0);
class myself_model extends model
{
public function __construct()
{
$this->db_config = pc_base::load_config('database');
$this->db_setting = 'default';
$this->table_name = 'myself';
parent::__construct();
}
}
?>

5.安装
做好了上述准备，进入后台，更新缓存，点击模块管理，找到添加的模块点击安装
确定以后，安装成功后会自动更新栏目缓存。等待更新完成后，退出登录，重新登录后台。
点击挂件栏目
就可以看到刚才我们设置的模版的内容，
myself/templdates目录下myself.tpl.php文件。
6.卸载自己添加的模块
在uninstall 目录里新建 extention.inc.php 以及 model.php
Extention 里代码如下
Model 里
因为用到了表 myself，在install里有myself.sql 创建了表，在unstall里也应该有mysql.Sql用于删除表.
配置好以后就可以进行模块的卸载了，卸载掉以后，逃退出重新登录才能看到左侧菜单栏的效果。
注意：
install 里面还有两个文件夹，模块的语言文件名和模块的名称一样，在模块的install目录下的languages目录对应的语言新建一个mysql.lang.php文件，在安装时，系统会自动把文件拷贝到phpcms/languages下对应的语言目录下。
templates 用于存放前台模版，在安装前把前台所需要的模板，全部放在这个目录。模块安装时，系统会自动在网站根目录下的templdates目录中，新建一个和模块名一样的目录，把install/templates目录下的模板文件拷贝一份进来。
前台的逻辑处理文件直接在模块根目录下新建即可。
7.接下来就是模版的开发了。
有些时候可能会用到bootstrap，那么bootstrap应该放到哪里呢？放到static文件夹里吗？
这个时候要看情况了，有两种方法
1.直接放在和static同级的目录下，因为phpcms前台都是通过入口文件index.php 访问的，static和index.php同级，放在一起就可以直接引用
bs 是文件夹名字。
2.既然有JS_PATH,CSS_PATH ,那就造一个BS_PATH
在phpcms目录下有base.php，里面定义了JS_PATH,复制一份修改，
因为加载了配置文件system，找到caches/configs/system.php 大概30行，复制修改，这样bs路径就设置好了。
然后把文件放到指定位置（static目录里，我命名是bs），再到模版里引入就可以了。
这是在前台模版里引入的样式。
参考视频：网易云课堂里有phpcms二次开发教程，主要是安装和模版开发，但是也是用的pc标签,但是实际开发中很少用pc，比如我就是用php,。
开发新模块算是一个大的项目需求，正常的项目需求就是对已有的模块进行功能的增删改。