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 并且原文件的方法将被继承,可以直接使用。
如果需要增加自己的全局函数,可根据需要增加到/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创建模块开发流程为你的phpcms创建一个模块的一般开发流程是:创建数据库和数据表;(没有数据库操作可略过)创建模块目录创建模块控制器类;创建模块类与模块函数;(如果只是简单的模块可以不必创建)创建模板文件;运行和调试。
第一、创建模块文档结构phpcms v9框架中的模块,位于phpcms/modules目录中每一个目录称之为一个模块如果要创建一个模块,只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。
例如我要开发一个叫做test的模块,那么首先在phpcms/modules 目录下创建文件夹,并将其命名为test。
test模块的标准结构通常是这样的。
其中classes为模块类库包functions为模块函数库包templates为模块模板包这里通常放置含有权限控制的控制器模板,也就是后台模板。
如果您的模板有单独的前台模板,你需要在phpcms\templates\default下创建一个您的模块目录来放置前台模板,"default"为你的风格包名称,我们默认适用default第二:创建模块控制器类在创建模块中我们已经创建好了一个名为“test”的模块,接下来我们继续为这个模块添加两个控制器类。
phpcms v9的控制器就是模块的类文件,位于phpcms/modules/模块/目录下面。
类名成就是文件名+.php,例如一个名为mytest的控制器,那么他的命名为mytest.php即可。
控制器类默认继承系统的函数库,可以直接使用。
控制器类的类名称与控制器文件名必须相同。
控制器类文件包含两种形式:1.mytest.php 控制器,前台浏览(不含权限控制)<?phpdefined('IN_PHPCMS')orexit('No permission resources.');classmytest{function__construct(){}publicfunctioninit(){$var='hello world!';echo $myvar;}publicfunctionmylist(){$var='hello world!this is a example!';echo $myvar;}}>这个控制器的url访问方法前面已经介绍过了,/index.php?m=test&c=mytest/index.php?m=test&c=mytest&a=mylist没有填写“a” 的情况下,默认调用init方法2.mytest_admin.php 控制器,后台管理(含权限控制)后台控制控制器需要加载admin模块下的admin类,并继承该类。
需要注意的是因为你添加的控制器类继承了其他的类,你要小心你控制器的方法名不要和该类中的方法名一样了,否则会造成影响,具体请查看admin类中有哪些方法。
<?phpdefined('IN_PHPCMS')orexit('No permission resources.');pc_base::load_app_class('admin','admin',0);classmytest_adminextendsadmin{publicfunction__construct(){}publicfunctioninit(){$myvar='oh,i am phpcmser';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='hello world!';includetemplate('test','mytest','default');}这样我们通过url访问该方法的时候也就加载了对应的模板。