phpcms_v9二次开发手册

PHPCMS二次开发教程文件目录结构根目录| – 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模块示例：/index.php?m=content控制器：phpcms v9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。

类名成就是文件名+.php，例如一个名为abc的控制器,那么他的命名为abc.php即可。

控制器类默认继承系统的函数库，可以直接使用。

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

如果您创建了一个abc.php在 test模块下，那么我们在浏览器里面输入URL：/index.php?m=test& c=abc二次开发技巧如果要对已存在的控制器进行二次开发，为了方便升级不建议直接对内核文件直接修改该，您可以通过“MY_*.php”的形式进行二次开发。

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

您可以在与index.php同级的目录下建立"MY_index.php"<?phpclass 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<?phpdefine('PHPCMS_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR);include PHPCMS_PATH.'/phpcms/base.php';pc_base::creat_app();?>这段代码首先加载了 phpcms 框架的引导文件 base.php，然后它根据指定的配置文件建立了一个 Web 应用实例并运行。

PHPCMS框架入口文件：文件路径：根目录/phpcms/base.php 代码片段如下：<?phpdefine('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 代码片段如下：<?phpfunction 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 代码片段如下：<?phppc_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。

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

代码片段如下：<?phpfinal 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访问：PHPCMS是采用MVC设计模式开发,基于模块和操作的方式进行访问，采用单一入口模式进行项目部署和访问，无论访问任何一个模块或者功能，只有一个统一的入口。

参数名称描述位置备注∙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”为形式，类名称与文件名必须相同。