为你的phpcms创建一个模块的一般开发流程是:创建数据库和数据表;(没有数据库操作可略过,可通过phpcms的模型管理创建或直接操作数据库,创建表格)
为你的phpcms创建一个模块的一般开发流程是:
- 创建数据库和数据表;(没有数据库操作可略过,可通过phpcms的模型管理创建或直接操作数据库,创建表格)
- 创建模块目录 phpcms/modules/xxx
- 创建模块控制器类; phpcms/modules/xxx/yyy.php
- 创建模块类与模块函数;(如果只是简单的模块可以不必创建) phpcms/modules/xxx/yyy.php 中的 function zzz(){}
- 创建模板文件;phpcms/modules/xxx/templates/zzz.tpl.php
- 运行和调试。
若想在后台管理系统中创建指向菜单,过程如下:
对应中文语言名称: 随便填
菜单英文名称:随便填
模块名: xxx
文件名:yyy
方法名: zzz
创建模块
位于phpcms/modules目录中 每一个目录称之为一个模块
如果要创建一个模块,只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。
例如我要开发一个叫做test的模块,那么首先在 phpcms/modules 目录下创建文件夹,并将其命名为test。
test模块的标准结构通常是这样的。
如果您的模板有单独的前台模板,你需要在phpcms\templates\default下创建一个您的模块目录来放置前台模板,"default"为你的风格包名称,我们默认适用default
创建模块控制器类
在创建模块中我们已经创建好了一个名为“test”的模块,接下来我们继续为这个模块添加两个控制器类。
phpcms v9的控制器就是模块的类文件,位于phpcms/modules/模块/目录下面。类名成就是文件名+.php,例如一个名为mytest的控制器,那么他的命名为mytest.php即可。控制器类默认继承系统的函数库,可以直接使用。控制器类的类名称与控制器文件名必须相同。
控制器类文件包含两种形式:
1.mytest.php 控制器,前台浏览(不含权限控制)
[php]
- <?php
- defined('IN_PHPCMS' 'No permission resources.');
- class mytest {
- function __construct() {
- }
- public init() {
- $myvar'hello world!';
- $myvar;
- }
- public mylist() {
- $myvar'hello world!this is a example!';
- $myvar;
- }
- }
- ?>
这个控制器的url访问方法前面已经介绍过了,
://www.yourname.com/index.php?m=test&c=mytest
://www.yourname.com/index.php?m=test&c=mytest&a=mylist
没有填写 “a” 的情况下,默认调用init方法
2.mytest_admin.php 控制器,后台管理(含权限控制)
后台控制控制器需要加载admin模块下的admin类,并继承该类。需要注意的是因为你添加的控制器类继承了其他的类,你要小心你控制器的方法名不要和该类中的方法名一样了,否则会造成影响,具体请查看admin类中有哪些方法。
[php]
- <?php
- defined('IN_PHPCMS' 'No permission resources.');
- pc_base::load_app_class('admin''admin',0);
- class admin {
- public __construct() {
- }
- public init() {
- $myvar'oh,i am phpcmser';
- $myvar;
- }
- public mylist() {
- $myvar'hello world!this is a example!';
- $myvar;
- }
- }
- >
在控制器中增加模板调用
phpcms 可以实现完全的模板与程序分离,所以在我们的控制器程序中要加载模板,才可以更友好的显示出来。
1.加载前台模板
前台模板文件在phpcms\templates\default\模块名称 目录中,本示例也就在phpcms\templates\default\test中
加载模板方法如下:
template('test','mytest','default');
其中 test为模块名称 mytest 为模板目录下模板名称,default为风格名称,默认不填为defalut
在上面例子中如果要给mytest.php中init方法加载一个mytest的模板,如下
[php]
- public init() {
- $var'hello world!';
- include'test''mytest''default');
- }
这样我们通过url访问该方法的时候也就加载了对应的模板。
2.加载后台模板
后台模板文件在phpcms\modules\模块名称\templates 目录中,本示例也就在phpcms\modules\test\templates 中
加载模板方法如下:
->('mytest_admin_list');
其中mytest_admin_list为phpcms\modules\test\templates中mytest_admin_list.tpl.php,注意:此处模板必须以.tpl.php 作为后缀
在上面例子中如果要给mytest_admin.php中init方法加载一个mytest_admin_list的模板,如下
[php]
- public init() {
- $myvar'oh,i am phpcmser';
- include$this'mytest_admin_list');
- }
创建数据库模型类
数据库模型位于:phpcms/model/ 目录下。
数据模型文件的命名规则建议为数据表名称+'_model.class.php'
如果在我们的创建的模块中我要使用一个数据库“test”,首先需要建立一个数据库模型文件,文件名称为'test_model.class.php'
内容如下:
[php]
- <?php
- defined('IN_PHPCMS' 'No permission resources.');
- pc_base::load_sys_class('model''', 0);
- class model {
- public __construct() {
- $this'database');
- $this'default';
- $this'test';
- parent::__construct();
- }
- }
- ?>
注意:
1.数据库模型类名称必须与文件名称相同;
2.$this->db_setting = 'default'为数据库配置文件中配置数据库链接池名称,默认为default,一般情况下不需要修改。
3.$this->table_name = 'test'为数据表名称
这样我们就建立好了一个数据库模型类。
在模块的控制器中使用
->=::('test_model');
来加载。
具体如下
[php]
- <?php
- defined('IN_PHPCMS' 'No permission resources.');
- class mytest {
- private$db;
- function __construct() {
- $this'test_model');
- }
- public init() {
- $result$this->db->select();
- var_dump($result);
- }
- }
- ?>
其中$this->db中所支持的方法请参照phpcms/libs/classes/model.class.php中方法