phpcms 使用指南及二次开发向导

PHPCMS 使用指南及二次开发向导www.phpcms.cn

PHPCMS 使用指南及二次开发向导

• PHPCMS V9 介绍• PHPCMS V9 后台功能• PHPCMS V9 结构设计• PHPCMS V9 核心文件说明• PHPCMS V9 二次开发• PHPCMS V9 模板与标签

PHPCMS 使用指南及二次开发向导　　 PHPCMS V9 （后面简称 V9 ）采用 PHP5+MYSQL 做为技术基础进行开发。 V9 采用 OOP （面向对象）方式进行基础运行框架搭建。模块化开发方式做为功能开发形式。框架易于功能扩展，代码维护，优秀的二次开发能力，可满足所有网站的应用需求。　　 5 年开发经验的优秀团队，在掌握了丰富的 WEB 开发经验和 CMS 产品开发经验的同时，勇于创新追求完美的设计理念，为全球多达 10 万网站提供助力，并被更多的政府机构、教育机构、事业单位、商业企业、个人站长所认可。V9 在保留 2008 版的特点的同时，对新版本作出重大的创新，以期待全新的PHPCMS 系统服务更多的用户。

PHPCMS 使用指南及二次开发向导后台登录地址： http://yourdomain.com/admin.php

PHPCMS 使用指南及二次开发向导Phpcms v9 后台主页面

PHPCMS 使用指南及二次开发向导Phpcms v9 后台主要功能选项

PHPCMS 使用指南及二次开发向导Phpcms v9 后台内容管理

PHPCMS 使用指南及二次开发向导Phpcms v9 后台文章发布


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

模块与控制器

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

访问 content 模块示例： http://www.yourname.com/index.php?m=content

如果您创建了一个 abc.php 在 test 模块下，那么我们在浏览器里面输入 URL ：http://www.yourname.com/index.php?m=test&c=abc

PHPCMS 使用指南及二次开发向导二次开发技巧

　　如果要对已存在的控制器进行二次开发，为了方便升级不建议直接对内核文件直接修改该，您可以通过“ MY_*.php” 的形式进行二次开发。　　例如您要对改 phpcms/mood/index.php 进行二次开发。您可以在与index.php 同级的目录下建立 "MY_index.php"

<?php　　 class MY_index extends index{ 　　　　 function __construct() { 　　　　　　 parent::__construct(); 　　　　 } 　　　　…… your code }

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

PHPCMS 使用指南及二次开发向导系统配置文件

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

database.php 数据库配置文件system.php 系统配置文件route.php 路由配置文件

调用方法如调用系统配置中的 web_path:

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


PHPCMS 是采用 MVC 设计模式开发 , 基于模块和操作的方式进行访问，采用单一入口模式进行项目部署和访问，无论访问任何一个模块或者功能，只有一个统一的入口。入口程序是在前期处理用户请求的引导程序。它是唯一一个可以被最终用户可以直接请求运行的。

<?php 　　 define('PHPCMS_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR);　　 include PHPCMS_PATH.'/phpcms/base.php'; 　　 pc_base::creat_app();?>

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

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

CMS 入口文件：


<?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);　 ... … ... …　 ... … ... …?>

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

该文件为框架入口文件，包含实例化系统 / 模块类方法，调用系统 / 模块方法，系统常用常量等。如：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 框架入口文件：


<?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 代码片段如下：

该文件中的函数，为全系统基础函数，可以在系统中直接调用。二次开发技巧 :如果需要增加自己的全局函数，可根据需要增加到 /phpcms/libs/functions/global.func.php/extention.func.php 中不会影响升级

全局函数文件：


<?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/model.class.php 代码片段如下：

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

数据模型基类：


<?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 ) {}　 ... … ... …　 ... … ... …?>

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

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

表单调用类：


<?php

final class template_cache {　　 public function template_compile($module, $template, $style = ‘default’) 　　　　 {　　 $tplfile = $_tpl = PC_PATH.'templates'.DIRECTORY_SEPARATOR.$style.DIRECTORY_SEPARATOR.$module.DIRECTORY_SEPARATOR.$template.'.html'; 　 ... … ... …　 ... … ... …?>

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

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

模板解析缓存类：


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

参数名称描述位置备注M 模型 / 模块名称 phpcms/modules 中模块目录名称必须C 控制器名称 phpcms/modules/ 模块 /*.php 文件名称必须A 事件名称 phpcms/modules/ 模块 /*.php 中方法名称

模块访问方法 [ 示例 ] ：http://yourdomain.com/index.php?m=content&c=index&a=show&id=1

模型 / 模块名称位于 phpcms/modules/content控制器名称位于 phpcms/modules/content/index.php

事件名称位于 phpcms/modules/content/index.php 中 show() 方法

PHPCMS 使用指南及二次开发向导二次开发命名规范

•类文件需要以 .class.php 为后缀（这里是指的 phpcms 的系统类库文件和模块中的类库文件，第三方引入的不做要求），例如 http.class.php 。•函数文件需要以 .func.php 为后缀（第三方引入的不做要求），例如mail.func.php 。•类名和文件名一致，例如 phpcmsapp 类的文件命名是phpcmsapp.class.php 。•数据模型需要以“数据表名称 _model.class.php” 为形式，类名称与文件名必须相同。

PHPCMS 使用指南及二次开发向导二次开发开发流程

运行和调试创建模板文件（如前台显示可略过）

开发模块类与模块函数（如无可略过）开发模块控制器类

创建模块目录创建数据库和数据表（如数据库操作可略过）

PHPCMS 使用指南及二次开发向导创建数据库模型类

<?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(); 　　 } 　 } ?>

数据库模型位于： phpcms/model/ 目录下。数据模型文件的命名规则建议为数据表名称 +'_model.class.php'如果在我们的创建的模块中我要使用一个数据库“ test” ，首先需要建立一个数据库模型文件，文件名称为 'test_model.class.php'

• 数据库模型类名称必须与文件名称相同；• $this->db_setting = 'default' 为数据库配置文件中配置数据库链接池名称，默认为default ，一般情况下不需要修改。• $this->table_name = ‘test’ 为数据表名称


如果要创建一个模块，只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。例如要开发一个叫做 test 的模块，那么首先在 phpcms/modules 目录下创建文件夹，并将其命名为 test 。模块的标准结构通常是这样的。如果您的模板有单独的前台模板，你需要在 phpcms/templates/default 下创建一个您的模块目录来放置前台模板， "default" 为你的风格包名称，我们默认适用 default

创建模块

访问 test 模块示例： http://www.yourname.com/index.php?m=test

PHPCMS 使用指南及二次开发向导创建模块控制器类

<?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;　　　　　　 }　　 } ?>

为 test 模块增加一个名为 myest 的控制器文件路径：根目录 /phpcms/modules/test/mytest.php 。代码片段如下：

PHPCMS 使用指南及二次开发向导常用操作列表 (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 函数包

PHPCMS 使用指南及二次开发向导常用操作列表 (2)

6. 加载前台模板include template('test', 'mytest', 'default');7. 加载后台模板include $this->admin_tpl('mytest_admin_list');8. 权限控制后台控制控制器需要加载 admin 模块下的 admin 类，并继承该类<?php defined('IN_PHPCMS') or exit('No permission resources.'); pc_base::load_app_class('admin','admin',0); class mytest_admin extends admin { // 这个控制器需要登录后台才可以访问 }?>

PHPCMS 使用指南及二次开发向导PC 标签

工具箱

评论模块会员模块友情链接模块投票模块公告模块专题模块内容模块…. …

json工具箱xml工具箱get 标签碎片工具箱

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

{pc:json url="http://www.yourname.com/asdfasdf.json" cache="3600"}{/pc}

Thank you!

phpcms 使用指南及二次开发向导

Documents