当前位置：文档库 › phpcms_v9二次开发手册

phpcms_v9二次开发手册

PHPCMS二次开发教程https://www.wendangku.net/doc/f811317224.html,/try/201109/1187_1.htm

文件目录结构

根目录

| – 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图标

PHPCMS V9 核心文件说明

模块与控制器

模块：

phpcms v9框架中的模块，位于phpcms/modules目录中每一个目录称之为一个模块。即url访问中的m。

访问content模块示例：https://www.wendangku.net/doc/f811317224.html,/index.php?m=content

控制器：

phpcms v9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。类名成就是文件名+.php，例如一个名为abc的控制器,那么他的命名为abc.php即可。控制器类默认继承系统的函数库，可以直接使用。控制器类的类名称与控制器文件名必须相同。如果您创建了一个abc.php在 test模块下，那么我们在浏览器里面输入URL：https://www.wendangku.net/doc/f811317224.html,/index.php?m=test& c=abc

二次开发技巧

如果要对已存在的控制器进行二次开发，为了方便升级不建议直接对内核文件直接修改该，您可以通过“MY_*.php”的形式进行二次开发。

例如您要对改phpcms/mood/index.php进行二次开发。您可以在与

index.php同级的目录下建立"MY_index.php"

class MY_index extends index{

function __construct() {

parent::__construct();

}

……your code

}

这样当您通过url访问index控制器的时候，系统会默认指向MY_index.php 并且原文件的方法将被继承，可以直接使用。

系统配置文件

文件路径：根目录/caches/configs

?database.php 数据库配置文件

?system.php 系统配置文件

?route.php 路由配置文件

调用方法

如调用系统配置中的web_path:

pc_base::load_config('system', web_path ');

CMS入口文件：

PHPCMS是采用MVC设计模式开发,基于模块和操作的方式进行访问，采用单一入口模式进行项目部署和访问，无论访问任何一个模块或者功能，只有一个统一的入口。

入口程序是在前期处理用户请求的引导程序。它是唯一一个可以被最终用户可以直接请求运行的。

文件路径：根目录/index.php

define('PHPCMS_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR);

include PHPCMS_PATH.'/phpcms/base.php';

pc_base::creat_app();

这段代码首先加载了 phpcms 框架的引导文件 base.php，然后它根据指定的配置文件建立了一个 Web 应用实例并运行。

PHPCMS框架入口文件：

文件路径：根目录/phpcms/base.php 代码片段如下：

define('IN_PHPCMS', true);

define('PC_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR);

if(!defined('PHPCMS_PATH')) define('PHPCMS_PATH',

PC_PATH.'..'.DIRECTORY_SEPARATOR);

define('CACHE_PATH', PHPCMS_PATH.'caches'.DIRECTORY_SEPARATOR); ……

该文件为框架入口文件，包含实例化系统/模块类方法，调用系统/模块方法，系统常用常量等。如：

pc_base::load_model(‘*_model’) 加载数据库模型

pc_base::load_sys_class(‘classname’) 实例化系统类

pc_base::load_app_class(‘classname’,’admin’) 实例化模块类

pc_base::load_sys_func (‘funcfile’) 调用系统函数库

全局函数文件：

文件路径：根目录/phpcms/libs/functions/global.func.php 代码片段如下：

function new_addslashes($string){

if(!is_array($string)) return addslashes($string);

foreach($string as $key => $val) $string[$key] =

new_addslashes($val);

return $string;

}

……

该文件中的函数，为全系统基础函数，可以在系统中直接调用。

二次开发技巧:

如果需要增加自己的全局函数，可根据需要增加到

/phpcms/libs/functions/global.func.php/extention.func.php中，不会影响升级

数据模型基类：

文件路径：根目录/phpcms/libs/classes/model.class.php 代码片段如下：

pc_base::load_sys_class('db_factory', '', 0);

class model { //数据库配置

protected $db_config = ''; //数据库连接

protected $db = ''; //调用数据库的配置项

protected $db_setting = 'default'; //数据表名

protected $table_name = ''; //表前缀

public $db_tablepre = '';

……

加载数据模型后，可以的数据库该类中方法进行数据库操作。

表单调用类：

文件路径：根目录/phpcms/libs/classes/form.class.php。代码片段如下：

class form {

//编辑器调用

public static function editor($textareaid = 'content', $toolbar = 'basic', $module = '', $catid = '', $color = '', $allowupload = 0, $allowbrowser = 1,$alowuploadexts = '',$height = 200,$disabled_page = 0) {

}

//图片上传调用

public static function images($name, $id = '', $value = '', $moudle='', $catid='', $size = 50, $class = '', $ext = '', $alowexts = '',$thumb_setting = array(),$watermark_setting = 0 ) {

}

……

通过实例化该类可以，调用在程序中调用编辑器、表单上传、日期选择、栏目结构等表单。实例化方法：pc_base::load_sys_class('form', '', 0);

模板解析缓存类：

文件路径：根目录/phpcms/libs/classes/template_cache.class.php 。代码片段如下：

final class template_cache {

public function template_compile($module, $template, $style = ‘default’) {

$tplfile = $_tpl =

PC_PATH.'templates'.DIRECTORY_SEPARATOR.$style.DIRECTORY_SEPARATOR.$m odule.DIRECTORY_SEPARATOR.$template.'.html';

……

该类作用为解析模板，解析模板及更新模板缓存

PHPCMS V9 二次开发

PHPCMS URL访问：

参数名称描述位置备注

?M 模型/模块名称 phpcms/modules中模块目录名称必须

? C 控制器名称 phpcms/modules/模块/*.php 文件名称必须

? A 事件名称 phpcms/modules/模块/*.php 中方法名称

模块访问方法[示例]：

二次开发命名规范

类文件需要以.class.php为后缀（这里是指的phpcms的系统类库文件和模块中的类库文件，第三方引入的不做要求），例如http.class.php。

函数文件需要以.func.php为后缀（第三方引入的不做要求），例如

mail.func.php。

类名和文件名一致，例如 phpcmsapp类的文件命名是phpcmsapp.class.php。

数据模型需要以“数据表名称_model.class.php”为形式，类名称与文件名必须相同。

二次开发开发流程

创建数据库模型类

数据库模型位于：phpcms/model/目录下。

数据模型文件的命名规则建议为数据表名称+'_model.class.php'

如果在我们的创建的模块中我要使用一个数据库“test”，首先需要建立一个数据库模型文件，文件名称为'test_model.class.php'

defined('IN_PHPCMS') or exit('No permission resources.');

pc_base::load_sys_class('model', '', 0);

class test_model extends model {

public function __construct() {

$this->db_config = pc_base::load_config('database');

$this->db_setting = ‘default';

$this->table_name = 'test';

parent::__construct();

}

数据库模型类名称必须与文件名称相同；

$this->db_setting = 'default'为数据库配置文件中配置数据库链接池名称，默认为default，一般情况下不需要修改。

$this->table_name = ‘test’为数据表名称

创建模块

如果要创建一个模块，只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。

例如要开发一个叫做test的模块，那么首先在phpcms/modules 目录下创建文件夹，并将其命名为test。模块的标准结构通常是这样的。

如果您的模板有单独的前台模板，你需要在phpcms/templates/default下创建一个您的模块目录来放置前台模板，"default"为你的风格包名称，我们默认适用default

访问test模块示例：https://www.wendangku.net/doc/f811317224.html,/index.php?m=test

创建模块控制器类

为test模块增加一个名为myest的控制器文件路径：根目录

/phpcms/modules/test/mytest.php。代码片段如下：

defined('IN_PHPCMS') or exit('No permission resources.');

class mytest {

function __construct() {

}

public function init() {

$var = 'hello world!';

echo $myvar;

}

public function mylist() {

$var = 'hello world!this is a example!';

echo $myvar;

}

常用操作列表(1)

1.调用数据库模型

$this->db = pc_base::load_model('test_model');

其中$this->db中所支持的方法请参照phpcms/libs/classes/model.class.php 中方法

2.加载系统类

$http = pc_base::load_sys_class('http'); //实例化http类

pc_base::load_sys_class('format', '', 0); //调用form类，不进行实例化操作3.加载系统函

3.加载系统函数库

pc_base::load_sys_func('mail'); //调用mail函数包

4. 加载模块类

$test = pc_base::load_sys_class(‘classname‘,’test’); //实例化test 模块下 classname类

5.加载模块函数库

pc_base::load_sys_func(‘global‘,’test’); //调用test模块的global 函数包

常用操作列表(2)

6.加载前台模板

include template('test', 'mytest', 'default');

7.加载后台模板

include $this->admin_tpl('mytest_admin_list');

8.权限控制

后台控制控制器需要加载admin模块下的admin类，并继承该类

defined('IN_PHPCMS') or exit('No permission resources.');

pc_base::load_app_class('admin','admin',0);

class mytest_admin extends admin {

//这个控制器需要登录后台才可以访问 }

PHPCMS V9 模板与标签

?PC标签

?评论模块

?会员模块

?友情链接模块

?投票模块

?公告模块

?专题模块

?内容模块

?工具箱

?json工具箱

?xml工具箱

?get标签

?碎片工具箱

v9 二次开发之构建模块全过程

第一：开发流程

为你的phpcms创建一个模块的一般开发流程是：

创建数据库和数据表；（没有数据库操作可略过）

创建模块目录

创建模块控制器类；

创建模块类与模块函数；（如果只是简单的模块可以不必创建）

创建模板文件；

运行和调试。

第二：创建模块

phpcms v9框架中的模块，位于phpcms/modules目录中每一个目录称之为一个模块

如果要创建一个模块，只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。

例如我要开发一个叫做test的模块，那么首先在 phpcms/modules 目录下创建文件夹，并将其命名为test。

test模块的标准结构通常是这样的。

其中

classes为模块类库包

functions为模块函数库包

templates为模块模板包这里通常放置含有权限控制的控制器模板，也就是后台模板。

如果您的模板有单独的前台模板，你需要在phpcms\templates\default下创建一个您的模块目录来放置前台模板，"default"为你的风格包名称，我们默认适用default

第三：创建模块控制器类

在创建模块中我们已经创建好了一个名为“test”的模块，接下来我们继续为这个模块添加两个控制器类。

phpcms v9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。类名成就是文件名+.php，例如一个名为mytest的控制器,那么他的命名为mytest.php即可。控制器类默认继承系统的函数库，可以直接使用。控制器类的类名称与控制器文件名必须相同。

控制器类文件包含两种形式：

1.mytest.php 控制器，前台浏览（不含权限控制）

defined('IN_PHPCMS')orexit('No permission resources.');

classmytest{

function__construct(){

}

publicfunctioninit(){

$var='hello world!';

echo $myvar;

}

publicfunctionmylist(){

$var='hello world!this is a example!';

echo $myvar;

}

这个控制器的url访问方法前面已经介绍过了，

https://www.wendangku.net/doc/f811317224.html,/index.php?m=test&c=mytest

https://www.wendangku.net/doc/f811317224.html,/index.php?m=test&c=mytest&a=mylist

没有填写“a” 的情况下，默认调用init方法

2.mytest_admin.php 控制器，后台管理(含权限控制)

后台控制控制器需要加载admin模块下的admin类，并继承该类。需要注意的是因为你添加的控制器类继承了其他的类，你要小心你控制器的方法名不要和该类中的方法名一样了，否则会造成影响，具体请查看admin类中有哪些方法。

defined('IN_PHPCMS')orexit('No permission resources.');

pc_base::load_app_class('admin','admin',0);

classmytest_adminextendsadmin{

publicfunction__construct(){

}

publicfunctioninit(){

$myvar='oh,i am phpcmser';

echo $myvar;

}

在控制器中增加模板调用

phpcms 可以实现完全的模板与程序分离，所以在我们的控制器程序中要加载模板，才可以更友好的显示出来。

1.加载前台模板

前台模板文件在phpcms\templates\default\模块名称目录中，本示例也就在

phpcms\templates\default\test中

加载模板方法如下:

includetemplate('test','mytest','default');

其中test为模块名称mytest 为模板目录下模板名称,default为风格名称，默认不填为defalut

在上面例子中如果要给mytest.php中init方法加载一个mytest的模板，如下

publicfunctioninit(){

$var='hello world!';

includetemplate('test','mytest','default');

}

这样我们通过url访问该方法的时候也就加载了对应的模板。

2.加载后台模板

后台模板文件在phpcms\modules\模块名称\templates 目录中，本示例也就在

phpcms\modules\test\templates 中

加载模板方法如下：

include $this->admin_tpl('mytest_admin_list');

其中mytest_admin_list为phpcms\modules\test\templates中

mytest_admin_list.tpl.php，注意：此处模板必须以.tpl.php 作为后缀

在上面例子中如果要给mytest_admin.php中init方法加载一个mytest_admin_list的模板，如下

publicfunctioninit(){

$myvar='oh,i am phpcmser';

include $this->admin_tpl('mytest_admin_list');

}

第四：创建数据库模型类

数据库模型位于：phpcms/model/ 目录下。

数据模型文件的命名规则建议为数据表名称+'_model.class.php'

如果在我们的创建的模块中我要使用一个数据库“test”，首先需要建立一个数据库模型文件，文件名称为'test_model.class.php'

内容如下：

defined('IN_PHPCMS')orexit('No permission resources.');

pc_base::load_sys_class('model','',0);

class test_model extends model{

publicfunction__construct(){

$this->db_config=pc_base::load_config('database');

$this->db_setting='default';

$this->table_name='test';

parent::__construct();

}

注意：

1.数据库模型类名称必须与文件名称相同；

2.$this->db_setting = 'default'为数据库配置文件中配置数据库链接池名称，默认为default，一般情况下不需要修改。

3.$this->table_name = 'test'为数据表名称

这样我们就建立好了一个数据库模型类。

在模块的控制器中使用

$this->db=pc_base::load_model('test_model');

来加载。

具体如下

defined('IN_PHPCMS')orexit('No permission resources.');

class mytest{

private$db;

function__construct(){

$this->db=pc_base::load_model('test_model');

}

publicfunction init(){

$result=$this->db->select();

var_dump($result);

}

其中$this->db中所支持的方法请参照phpcms/libs/classes/model.class.php中方法

PC标签使用说明

在PHPCMS V9中我们正式开始需要PC标签做为数据的获取的方式。

PC标签是以下面的方式进行声明

｛pc:content action="lists" cache="3600" num="20" page="$page"｝{/pc}

PC标签必须以{pc}开头，并以{/pc}结尾的代码片段。

当然不以{/pc}结尾并不会引起程序致命性的错误，导致程序无法继续运行。

以下为两种已知可能会出现的问题：

1.当网页中出现两个PC标签时，可能会使得没有闭合的PC标签之后的PC标签

数据和其混乱。

2.在后台可视化编辑时，可能出现网页结构错乱的问题。

PC标签分析：

PC标签中{pc:}冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的PC标签。

action="list"

这个形式所代表的是参数。每一个PHPCMS V9模型都为其PC标签定义了调用的参数。其中有一些调用参数是系统保留的参数，其对所有的PC标签都是有效的。

参数必须使用

参数名="参数值"

的方式填写，多个参数之间使用空格分开（如下例），参数值可使用双引号来包括，无论是什么形式的引号都必须是成对出现的。

{pc:content 参数名="参数值"参数名="参数值"参数名="参数值"}

请查看PC标签保留参数相关章节，以了解具体保留参数及其用途。

PC标签分类：

PC标签包含两个类别，分别为：

1.工具类

2.模块类

工具类，大体上可以理解为PHPCMS V9所提供的一些工具箱。请查看PC标签工具箱相关章节，以了解更多关于工具类的PC标签的更多信息。

而模块类，是PHPCMS V9各个模型提供给大家调用模块数据的数据接口。查看具体模块的相关说明章节，以了解更多关于模块类的PC标签的更多信息。

如何显示PC标签中的数据：

默认情况下PC标签中的数据都是数组方式返回的，你都可以通过$data 来获取到这个数组，如果你在PC标签中定义了return参数，返回的数组将使用return的值进行命令。

一般情况下你可以使用如下的方式来显示值：

{loop $data $key $val}

{$val[title]}

{/loop}

基中的$val[url]和$val[title]需要具体根据所使用的PC标签，返回的数据来判断。

PC标签保留参数

下表为PC标签保留参数表，几乎所有的PC标签都支持这些保留参数设置

下例中是一个完整的使用例子。

{pc:content action="lists" catid="25" num="20" page="$_GET[page]"return="data"}

{loop $data $n $r}

{$r[title]}

{/loop}

{/pc}

get标签

GET标签源自于PHPCMS 2008版，其使用SQL语句直接获取数据的特性，成为大家制作模板的首选。

在V9中这样强大的工具也得到保留下来。

GET标签使用方式如下：

{pc:get sql="SELECT * FROM phpcms_member" cache="3600" page="$page"

dbsource="discuz"return="data"}

{loop $data $key $val}

{$val[username]}

{/loop}

{$pages}

{/pc}

从上面的代码里面可以看出GET标签所支持的参数。对照下面的列表了解每一个参数的用途：

ecshop留言板增加字段说明

ecshop留言板添加一项必填项-联系人一、首先要为你的数据库的ecs_comment增加一个字段以存储联系人姓名：可以直接在后台-->数据库管理--->SQL查询里里直接执行以下sql语句: alter table ecs_comment add contact varchar(60) not null default ''; 此处注意，这条sql语句中的表前缀ecs_要和你网站的前缀一致，不然会报错，如果你不知道你ecshop网站的数据表前缀. 二：步骤1. 更改文件message_board.dwt {$lang.message_board_qq}