1、phpcmsv9二次开发手册PHPCMS二次开发教程文件目录结构根目录| api接口文件目录| caches 缓存文件目录 | configs 系统配置文件目录 | caches_* 系统缓存目录| phpcms phpcms框架主目录 | languages 框架语言包目录 | libs 框架主类库、主函数库目录 | model 框架数据库模型目录 | modules 框架模块目录 | templates 框架系统模板目录| phpsso_server phpsso主目录| statics 系统附件包 | css 系统css包 | images 系统图片包 | js 系统js包| uploa
2、dfile 网站附件目录| admin.php 后台管理入口| index.php 程序主入口| crossdomain.xml FLASH跨域传输文件| robots.txt 搜索引擎蜘蛛限制配置文件| favicon.ico 系统icon图标PHPCMS V9 核心文件说明模块与控制器模块:phpcms v9框架中的模块,位于phpcms/modules目录中 每一个目录称之为一个模块。即url访问中的m。访问content模块示例:控制器: phpcms v9的控制器就是模块的类文件,位于phpcms/modules/模块/目录下面。类名成就是文件名+.php,例如一个名为abc的控制器
3、,那么他的 命名为abc.php即可。控制器类默认继承系统的函数库,可以直接使用。控制器类的类名称与控制器文件名必须相同。如果您创建了一个abc.php在 test模块下,那么我们在浏览器里面输入URL: c=abc二次开发技巧如果要对已存在的控制器进行二次开发,为了方便升级不建议直接对内核文件直接修改该,您可以通过“MY_*.php”的形式进行二次开发。例如您要对改phpcms/mood/index.php进行二次开发。您可以在与index.php同级的目录下建立MY_index.php?php class MY_index extends index function _construct
4、() 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设计模式开发,基于模块和操作的方式进行访问,采用单一入口模式进行项目部
5、署和访问,无论访问任何一个模块或者功能,只有一个统一的入口。入口程序是在前期处理用户请求的引导程序。它是唯一一个可以被最终用户可以直接请求运行的。文件路径:根目录/index.php这段代码首先加载了 phpcms 框架的引导文件 base.php,然后它根据指定的配置文件建立了一个 Web 应用实例并运行。PHPCMS框架入口文件:文件路径:根目录/phpcms/base.php 代码片段如下:该文件为框架入口文件,包含实例化系统/模块类方法,调用系统/模块方法,系统常用常量等。如: pc_base:load_model(*_model) 加载数据库模型 pc_base:load_sys_c
6、lass(classname) 实例化系统类 pc_base:load_app_class(classname,admin) 实例化模块类 pc_base:load_sys_func (funcfile) 调用系统函数库全局函数文件:文件路径:根目录/phpcms/libs/functions/global.func.php 代码片段如下: $val) $string$key = new_addslashes($val); return $string; ?该文件中的函数,为全系统基础函数,可以在系统中直接调用。二次开发技巧:如果需要增加自己的全局函数,可根据需要增加到/phpcms/libs
7、/functions/global.func.php/extention.func.php中,不会影响升级数据模型基类:文件路径:根目录/phpcms/libs/classes/model.class.php 代码片段如下:加载数据模型后,可以的数据库该类中方法进行数据库操作。表单调用类:文件路径:根目录/phpcms/libs/classes/form.class.php。 代码片段如下:通过实例化该类可以,调用在程序中调用编辑器、表单上传、日期选择、栏目结构等表单。 实例化方法:pc_base:load_sys_class(form, , 0);模板解析缓存类:文件路径:根目录/phpcm
8、s/libs/classes/template_cache.class.php 。 代码片段如下:该类作用为解析模板,解析模板及更新模板缓存PHPCMS V9 二次开发PHPCMS URL访问:PHPCMS是采用MVC设计模式开发,基于模块和操作的方式进行访问,采用单一入口模式进行项目部署和访问,无论访问任何一个模块或者功能,只有一个统一的入口。参数名称 描述 位置 备注 M 模型/模块名称 phpcms/modules中模块目录名称 必须 C 控制器名称 phpcms/modules/模块/*.php 文件名称 必须 A 事件名称 phpcms/modules/模块/*.php 中方法名称
9、模块访问方法示例:二次开发命名规范类文件需要以.class.php为后缀(这里是指的phpcms的系统类库文件和模块中的类库文件,第三方引入的不做要求),例如http.class.php。函数文件需要以.func.php为后缀(第三方引入的不做要求),例如mail.func.php。类名和文件名一致,例如 phpcmsapp类的文件命名是phpcmsapp.class.php。数据模型需要以“数据表名称_model.class.php”为形式,类名称与文件名必须相同。二次开发开发流程创建数据库模型类数据库模型位于:phpcms/model/目录下。数据模型文件的命名规则建议为数据表名称+_mo
10、del.class.php如果在我们的创建的模块中我要使用一个数据库“test”,首先需要建立一个数据库模型文件,文件名称为test_model.class.phpdb_config = pc_base:load_config(database);$this-db_setting = default;$this-table_name = test;parent:_construct();?数据库模型类名称必须与文件名称相同; $this-db_setting = default为数据库配置文件中配置数据库链接池名称,默认为default,一般情况下不需要修改。 $this-table_name
11、 = test为数据表名称创建模块如果要创建一个模块,只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。例如要开发一个叫做test的模块,那么首先在phpcms/modules 目录下创建文件夹,并将其命名为test。模块的标准结构通常是这样的。如果您的模板有单独的前台模板,你需要在phpcms/templates/default下创建一个您的模块目录来放置前台模板,default为你的风格包名称,我们默认适用default访问test模块示例:创建模块控制器类为test模块增加一个名为myest的控制器 文件路径:根目录/phpcms/modules/test
12、/mytest.php。 代码片段如下:常用操作列表(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
13、.加载模块类$test = pc_base:load_sys_class(classname,test); /实例化test模块下 classname类5.加载模块函数库pc_base:load_sys_func(global,test); /调用test模块的global函数包常用操作列表(2)6.加载前台模板includetemplate(test,mytest,default);7.加载后台模板include $this-admin_tpl(mytest_admin_list);8.权限控制后台控制控制器需要加载admin模块下的admin类,并继承该类PHPCMS V9 模板与标签 P
14、C标签 评论模块 会员模块 友情链接模块 投票模块 公告模块 专题模块 内容模块 工具箱 json工具箱 xml工具箱 get标签 碎片工具箱 v9 二次开发之构建模块全过程第一:开发流程为你的phpcms创建一个模块的一般开发流程是:创建数据库和数据表;(没有数据库操作可略过)创建模块目录创建模块控制器类;创建模块类与模块函数;(如果只是简单的模块可以不必创建)创建模板文件;运行和调试。第二:创建模块phpcms v9框架中的模块,位于phpcms/modules目录中 每一个目录称之为一个模块如果要创建一个模块,只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以
15、了。例如我要开发一个叫做test的模块,那么首先在phpcms/modules 目录下创建文件夹,并将其命名为test。test模块的标准结构通常是这样的。其中classes为模块类库包functions为模块函数库包templates为模块模板包这里通常放置含有权限控制的控制器模板,也就是后台模板。如果您的模板有单独的前台模板,你需要在phpcmstemplatesdefault下创建一个您的模块目录来放置前台模板,default为你的风格包名称,我们默认适用default第三:创建模块控制器类在创建模块中我们已经创建好了一个名为“test”的模块,接下来我们继续为这个模块添加两个控制器类。
16、phpcms v9的控制器就是模块的类文件,位于phpcms/modules/模块/目录下面。类名成就是文件名+.php,例如一个名为mytest的控制器,那么他的命名为mytest.php即可。控制器类默认继承系统的函数库,可以直接使用。控制器类的类名称与控制器文件名必须相同。控制器类文件包含两种形式:1.mytest.php 控制器,前台浏览(不含权限控制)这个控制器的url访问方法前面已经介绍过了,没有填写 “a” 的情况下,默认调用init方法2.mytest_admin.php 控制器,后台管理(含权限控制)后台控制控制器需要加载admin模块下的admin类,并继承该类。需要注意的
17、是因为你添加的控制器类继承了其他的类,你要小心你控制器的方法名不要和该类中的方法名一样了,否则会造成影响,具体请查看admin类中有哪些方法。在控制器中增加模板调用phpcms 可以实现完全的模板与程序分离,所以在我们的控制器程序中要加载模板,才可以更友好的显示出来。1.加载前台模板前台模板文件在phpcmstemplatesdefault模块名称 目录中,本示例也就在phpcmstemplatesdefaulttest中加载模板方法如下:includetemplate(test,mytest,default);其中test为模块名称mytest为模板目录下模板名称,default为风格名称,
18、默认不填为defalut在上面例子中如果要给mytest.php中init方法加载一个mytest的模板,如下publicfunctioninit()$var=hello world!;includetemplate(test,mytest,default);这样我们通过url访问该方法的时候也就加载了对应的模板。2.加载后台模板后台模板文件在phpcmsmodules模块名称templates 目录中,本示例也就在phpcmsmodulestesttemplates 中加载模板方法如下:include $this-admin_tpl(mytest_admin_list);其中mytest_a
19、dmin_list为phpcmsmodulestesttemplates中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内容如下:db_config=pc_base:load_config(database);$this-db_setting=default;
copyright@ 2008-2023 冰点文库 网站版权所有
经营许可证编号:鄂ICP备19020893号-2