phpcms v9二次开发笔记

phpcms是基于MVC结构的。安装: 下载phpcms_v9 5 9_UTF8 zip;新建目录phpcms,将压缩包里install_package目录下所

phpcms是基于MVC结构的。

安装:
下载phpcms_v9.5.9_UTF8.zip;新建目录phpcms,将压缩包里install_package目录下所有文件复制到phpcms目录。浏览器输入类似于http://localhost/phpcms便可以进入安装过程了。接下来安照步骤走下去即可。

一、目录结构

根目录
| – api 接口文件目录
| – caches 缓存文件目录
| – configs 系统配置文件目录
| – caches_* 系统缓存目录
| – phpcms phpcms框架主目录
| – languages 框架语言包目录
| – libs 框架主类库、主函数库目录
| – model 框架数据库模型目录(每个目录都是一个模块,包含控制器)
| – modules 框架模块目录
| – templates 框架系统模板目录(视图,默认在default目录)
| – phpsso_server phpsso主目录
| – statics 系统附件包
| – css 系统css包
| – images 系统图片包
| – js 系统js包
| – uploadfile 网站附件目录
| – admin.php 后台管理入口
| – index.php 程序主入口
| – crossdomain.xml FLASH跨域传输文件
| – robots.txt 搜索引擎蜘蛛限制配置文件
| – favicon.ico 系统icon图标

二、路由

单入口,模块访问方法[示例]:
http://yourdomain.com/index.php?m=content&c=index&a=show&id=1

m = content 为模型/模块名称 位于phpcms/modules/content
c = index 为控制器名称 位于phpcms/modules/content/index.php
a = show 为时间名称 位于phpcms/modules/content/index.php 中show()方法
id = 1 为其他参数 与正常get传递参数形式相同

路由配置:
phpcms/caches/configs/route.php
默认是

return array(
	'default'=>array('m'=>'content', 'c'=>'index', 'a'=>'init'),
);

即定义了m,c,a以及默认会访问content模块的index控制器的init方法

三、模块

phpcms v9框架中的模块,位于phpcms/modules目录中 每一个目录称之为一个模块。即url访问中的m。

如果要创建一个模块,只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。

例如我要开发一个叫做test的模块,那么首先在 phpcms/modules 目录下创建文件夹,并将其命名为test。

test模块的标准结构通常是这样的。

classes 为模块类库包
functions 为模块函数库包
templates 为模块模板包。这里通常放置含有权限控制的控制器模板,也就是后台模板。

如果您的模板有单独的前台模板,你需要在phpcms\templates\default下创建一个您的模块目录来放置前台模板,"default"为你的风格包名称,我们默认适用default

四、控制器

位于phpcms/modules/模块/目录下面。
类名就是文件名.php,例如一个名为mytest的控制器,那么他的命名为mytest.php即可。
控制器类的类名称与控制器文件名必须相同。
控制器类默认继承系统的函数库,可以直接使用。

phpcms还有模块体系,即控制器属于模块。

五、模型

数据库模型位于:phpcms/model/ 目录下。
数据模型文件的命名规则建议为数据表名称+'_model.class.php'
如果在我们的创建的模块中我要使用一个数据库“test”,首先需要建立一个数据库模型文件,文件名称为'test_model.class.php'

内容如下:

<?php
   defined('IN_PHPCMS') or exit('No permission resources.');
   pc_base::load_sys_class('model', '', 0);
   class test_model extends model {
     public function __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,一般情况下不需要修改。
3.$this->table_name = 'test'为数据表名称

这样我们就建立好了一个数据库模型类。
在模块的控制器中使用

$this->db = pc_base::load_model('test_model');

来加载。

六、视图

视图位于phpcms\templates\default下。其中default表示默认主题目录。default下的视图文件夹与模块文件夹一一对应。

七、配置

配置文件位置:caches/configs/,其中:

database.php数据库
route.php路由
system.php系统配置

八、系统类库及函数调用

1、系统类库位于系统的phpcms/libs/classes目录下面,函数库文件名为*.class.php,其中global.func.php为框架中默认加载,global.func.php中函数可直接使用
2、系统函数库位于系统的phpcms/libs/functions目录下面,函数库文件名为*.func.php

使用pc_base::load_sys_class()加载类
使用pc_base::load_sys_func()加载函数
使用pc_base::load_model()加载数据模型
使用pc_base::load_config()加载配置文件

我们可以在类的前面加载需要的类库。例如:

pc_base::load_sys_class('model', '', 0);
class test_model extends model {}

九、数据库操作

参照phpcms/libs/classes/model.class.php中方法

参考
Phpcms官网:http://www.phpcms.cn/
PHPCMS V9帮助中心:http://v9.help.phpcms.cn/html/dev/