phpcms-v9二次开发手册

PHPCMS二次开发教程伊生臻爱整理1PHPCMS二次开发教程PHPCMS二次开发教程...............................1文件目录结构...................................2PHPCMSV9核心文件说明.........................3PHPCMS框架入口文件：..........................4PHPCMSV9二次开发.............................7创建模块控制器类...............................9v9二次开发之构建模块全过程.....................11PC标签使用说明..................................18PC标签保留参数..................................20get标签.........................................21内容模块........................................22PHPCMSv9.1.7整合discuzX2的解决办法..........28PHPCMS二次开发教程伊生臻爱整理2文件目录结构根目录|–api接口文件目录|–caches缓存文件目录|–configs系统配置文件目录|–caches_*系统缓存目录|–phpcmsphpcms框架主目录|–languages框架语言包目录|–libs框架主类库、主函数库目录|–model框架数据库模型目录|–modules框架模块目录|–templates框架系统模板目录|–phpsso_serverphpsso主目录|–statics系统附件包|–css系统css包|–images系统图片包|–js系统js包|–uploadfile网站附件目录|–admin.php后台管理入口|–index.php程序主入口|–crossdomain.xmlFLASH跨域传输文件|–robots.txt搜索引擎蜘蛛限制配置文件|–favicon.ico系统icon图标PHPCMS二次开发教程伊生臻爱整理3PHPCMSV9核心文件说明模块与控制器模块：phpcmsv9框架中的模块，位于phpcms/modules目录中每一个目录称之为一个模块。即url访问中的m。访问content模块示例：=content控制器：phpcmsv9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。类名成就是文件名+.php，例如一个名为abc的控制器,那么他的命名为abc.php即可。控制器类默认继承系统的函数库，可以直接使用。控制器类的类名称与控制器文件名必须相同。如果您创建了一个abc.php在test模块下，那么我们在浏览器里面输入URL：=test&c=abc二次开发技巧如果要对已存在的控制器进行二次开发，为了方便升级不建议直接对内核文件直接修改该，您可以通过“MY_*.php”的形式进行二次开发。例如您要对改phpcms/mood/index.php进行二次开发。您可以在与index.php同级的目录下建立MY_index.php?phpclassMY_indexextendsindex{function__construct(){PHPCMS二次开发教程伊生臻爱整理4parent::__construct();}……yourcode}这样当您通过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);includePHPCMS_PATH.'/phpcms/base.php';pc_base::creat_app();?这段代码首先加载了phpcms框架的引导文件base.php，然后它根据指定的配置文件建立了一个Web应用实例并运行。PHPCMS框架入口文件：文件路径：根目录/phpcms/base.php代码片段如下：PHPCMS二次开发教程伊生臻爱整理5?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代码片段如下：?phpfunctionnew_addslashes($string){if(!is_array($string))returnaddslashes($string);foreach($stringas$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);PHPCMS二次开发教程伊生臻爱整理6classmodel{//数据库配置protected$db_config='';//数据库连接protected$db='';//调用数据库的配置项protected$db_setting='default';//数据表名protected$table_name='';//表前缀public$db_tablepre='';……?加载数据模型后，可以的数据库该类中方法进行数据库操作。表单调用类：文件路径：根目录/phpcms/libs/classes/form.class.php。代码片段如下：?phpclassform{//编辑器调用publicstaticfunctioneditor($textareaid='content',$toolbar='basic',$module='',$catid='',$color='',$allowupload=0,$allowbrowser=1,$alowuploadexts='',$height=200,$disabled_page=0){}//图片上传调用publicstaticfunctionimages($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。代码片段如下：?phpfinalclasstemplate_cache{publicfunctiontemplate_compile($module,$template,$style=‘default’){$tplfile=$_tpl=PC_PATH.'templates'.DIRECTORY_SEPARATOR.$style.DIRECTORY_SEPARATOR.$mPHPCMS二次开发教程伊生臻爱整理7odule.DIRECTORY_SEPARATOR.$template.'.html';……?该类作用为解析模板，解析模板及更新模板缓存PHPCMSV9二次开发PHPCMSURL访问：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”为形式，类名称与文件名必须相同。二次开发开发流程PHPCMS二次开发教程伊生臻爱整理8创建数据库模型类数据库模型位于：phpcms/model/目录下。数据模型文件的命名规则建议为数据表名称+'_model.class.php'如果在我们的创建的模块中我要使用一个数据库“test”，首先需要建立一个数据库模型文件，文件名称为'test_model.class.php'?phpdefined('IN_PHPCMS')orexit('Nopermissionresources.');pc_base::load_sys_class('model','',0);classtest_modelextendsmodel{publicfunction__construct(){$this-db_config=pc_base::load_config('database');$this-db_setting=‘default';$this-table_name='test';parent::__cons