搜索
PHPCMSV9二次开发教程官方版文件目录结构根目录|–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图标PHPCMSV9核心文件说明模块与控制器模块：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(){parent::__construct();}……yourcode}这样当您通过url访问index控制器的时候，系统会默认指向MY_index.php并且原文件的方法将被继承，可以直接使用。如果需要增加自己的全局函数，可根据需要增加到/phpcms/libs/functions/global.func.php/extention.func.php中，不会影响升级数据模型基类：文件路径：根目录/phpcms/libs/classes/model.class.php代码片段如下：?phppc_base::load_sys_class('db_factory','',0);classmodel{//数据库配置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.$module.DIRECTORY_SEPARATOR.$template.'.html';……?该类作用为解析模板，解析模板及更新模板缓存PHPCMS创建模块开发流程为你的phpcms创建一个模块的一般开发流程是：创建数据库和数据表；（没有数据库操作可略过）创建模块目录创建模块控制器类；创建模块类与模块函数；（如果只是简单的模块可以不必创建）创建模板文件；运行和调试。第一、创建模块文档结构phpcmsv9框架中的模块，位于phpcms/modules目录中每一个目录称之为一个模块如果要创建一个模块，只要在phpcms/modules目录下创建文件夹并放入你的控制器类就可以了。例如我要开发一个叫做test的模块，那么首先在phpcms/modules目录下创建文件夹，并将其命名为test。test模块的标准结构通常是这样的。其中classes为模块类库包functions为模块函数库包templates为模块模板包这里通常放置含有权限控制的控制器模板，也就是后台模板。如果您的模板有单独的前台模板，你需要在phpcms\templates\default下创建一个您的模块目录来放置前台模板，default为你的风格包名称，我们默认适用default第二：创建模块控制器类在创建模块中我们已经创建好了一个名为“test”的模块，接下来我们继续为这个模块添加两个控制器类。phpcmsv9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。类名成就是文件名+.php，例如一个名为mytest的控制器,那么他的命名为mytest.php即可。控制器类默认继承系统的函数库，可以直接使用。控制器类的类名称与控制器文件名必须相同。控制器类文件包含两种形式：1.mytest.php控制器，前台浏览（不含权限控制）?phpdefined('IN_PHPCMS')orexit('Nopermissionresources.');classmytest{function__construct(){}publicfunctioninit(){$var='helloworld!';echo$myvar;}publicfunctionmylist(){$var='helloworld!thisisaexample!';echo$myvar;}}?这个控制器的url访问方法前面已经介绍过了，=test&c=mytest=test&c=mytest&a=mylist没有填写“a”的情况下，默认调用init方法2.mytest_admin.php控制器，后台管理(含权限控制)后台控制控制器需要加载admin模块下的admin类，并继承该类。需要注意的是因为你添加的控制器类继承了其他的类，你要小心你控制器的方法名不要和该类中的方法名一样了，否则会造成影响，具体请查看admin类中有哪些方法。?phpdefined('IN_PHPCMS')orexit('Nopermissionresources.');pc_base::load_app_class('admin','admin',0);classmytest_adminextendsadmin{publicfunction__construct(){}publicfunctioninit(){$myvar='oh,iamphpcmser';echo$myvar;}}?3.在控制器中增加模板调用phpcms可以实现完全的模板与程序分离，所以在我们的控制器程序中要加载模板，才可以更友好的显示出来。1）.加载前台模板前台模板文件在phpcms\templates\default\模块名称目录中，本示例也就在phpcms\templates\default\test中加载模板方法如下:includetemplate('test','mytest','default');其中test为模块名称mytest为模板目录下模板名称,default为风格名称，默认不填为defalut在上面例子中如果要给mytest.php中init方法加载一个mytest的模板，如下publicfunctioninit(){$var='helloworld!';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,iamphpcmser';include$this-admin_tpl('mytest_admin_list');}第三：创建数据库模型类数据库模型位于：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::__construct();}}?注意：1.数据库模型类名称必须与文件名称相同；2.$this-db_setting='default'为数据库配置文件中配置数据库链接池名称，默认为default，一般情况下不需要修改。