phpcms_v9二次开发手册

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"

class MY_index extends index{

function __construct() {

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设计模式开发,基于模块和操作的方式进行访问，采用单一入口模式进行项目部署和访问，无论访问任何一个模块或者功能，只有一个统一的入口。

入口程序是在前期处理用户请求的引导程序。它是唯一一个可以被最终用户可以直接请求运行的。

文件路径：根目录/index.php

define('PHPCMS_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR);

include PHPCMS_PATH.'/phpcms/base.php';

pc_base::creat_app();

?>

这段代码首先加载了 phpcms 框架的引导文件 base.php，然后它根据指定的配置文件建立了一个 Web 应用实例并运行。

PHPCMS框架入口文件：

文件路径：根目录/phpcms/base.php 代码片段如下：

define('IN_PHPCMS', true);

define('PC_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR);

if(!defined('PHPCMS_PATH')) define('PHPCMS_PATH',

PC_PATH.'..'.DIRECTORY_SEPARATOR);

define('CACHE_PATH', PHPCMS_PATH.'caches'.DIRECTORY_SEPARATOR); ……

?>

该文件为框架入口文件，包含实例化系统/模块类方法，调用系统/模块方法，系统常用常量等。如：

pc_base::load_model(‘*_model’) 加载数据库模型

pc_base::load_sys_class(‘classname’) 实例化系统类

pc_base::load_app_class(‘classname’,’admin’) 实例化模块类

pc_base::load_sys_func (‘funcfile’) 调用系统函数库

全局函数文件：

文件路径：根目录/phpcms/libs/functions/global.func.php 代码片段如下：

function new_addslashes($string){

if(!is_array($string)) return addslashes($string);

foreach($string as $key => $val) $string[$key] =

new_addslashes($val);

return $string;

}

……

?>

该文件中的函数，为全系统基础函数，可以在系统中直接调用。

二次开发技巧:

如果需要增加自己的全局函数，可根据需要增加到

/phpcms/libs/functions/global.func.php/extention.func.php中，不会影响升级

数据模型基类：

文件路径：根目录/phpcms/libs/classes/model.class.php 代码片段如下：