phpcms_v9二次开发手册

### PHPCMS V9 二次开发手册解析 #### 一、概述 《PHPCMS V9 二次开发手册》是一份详细的文档，旨在指导开发者如何有效地进行PHPCMS V9平台的二次开发工作。这份手册不仅包含了PHPCMS V9的基础架构介绍，还深入讲解了如何利用其提供的各种特性来实现定制化的功能。以下是对手册中关键知识点的总结和扩展。 #### 二、文件目录结构详解 **根目录**: - **api接口文件目录**: 存储API相关的文件，便于前端与后端的交互。 - **caches缓存文件目录**: 用于存储系统缓存文件，提高数据读取效率。 - **configs系统配置文件目录**: 包含所有系统配置文件，如数据库配置、路由配置等。 - **caches_*系统缓存目录**: 特定于不同功能模块的缓存文件夹。 - **phpcms**: 主要框架目录，包括框架的核心组件。 - **languages**: 存放语言包文件。 - **libs**: 存放主要的类库和函数库。 - **model**: 存放数据库模型文件。 - **modules**: 模块目录，每个子目录代表一个模块。 - **templates**: 存放系统模板文件。 - **phpsso_server**: PHP SSO（Single Sign-On）服务主目录。 - **statics**: 存放静态资源，如附件等。 - **css**: CSS样式表文件。 - **images**: 图片资源。 - **js**: JavaScript文件。 - **uploadfile**: 网站附件上传目录。 - **admin.php**: 后台管理入口文件。 - **index.php**: 主程序入口文件。 - **crossdomain.xml**: 用于Flash跨域传输的配置文件。 - **robots.txt**: 搜索引擎爬虫访问规则文件。 - **favicon.ico**: 系统图标文件。 #### 三、PHPCMS V9 核心文件说明 **模块与控制器**: - **模块**: 位于`phpcms/modules`目录下的每一个子目录代表一个模块，如`content`模块。模块通常对应于URL中的`m`参数，例如`http://www.yourname.com/index.php?m=content`。 - **控制器**: 控制器是模块内的类文件，位于`phpcms/modules/模块/`目录下，命名方式为`类名.php`。例如，名为`abc`的控制器，文件名为`abc.php`。控制器类默认继承系统的函数库。 **二次开发技巧**: - 如果需要对现有的控制器进行二次开发，建议不要直接修改内核文件。可以通过创建一个新的文件`MY_*.php`来进行二次开发，如要修改`index.php`，可以在同一目录下创建`MY_index.php`。 ```php <?php class MY_index extends index { function __construct() { parent::__construct(); } // ...自定义代码 } ``` 当通过URL访问`index`控制器时，系统会自动转向`MY_index.php`。 #### 四、系统配置文件 - **database.php**: 数据库配置文件。 - **system.php**: 系统配置文件。 - **route.php**: 路由配置文件。 **调用方法**: ```php pc_base::load_config('system', 'web_path'); ``` #### 五、CMS入口文件 **PHPCMS 入口文件** (`index.php`): - 这个文件作为PHPCMS框架的唯一入口，用于处理用户的请求，并引导整个应用程序的执行流程。 - 示例代码: ```php <?php define('PHPCMS_PATH', dirname(__FILE__) . DIRECTORY_SEPARATOR); include PHPCMS_PATH . '/phpcms/base.php'; pc_base::creat_app(); ?> ``` **PHPCMS 框架入口文件** (`phpcms/base.php`): - 这个文件用于初始化框架环境，设置常量，加载核心类库等。 - 示例代码: ```php <?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); // ... ``` 以上是对《PHPCMS V9 二次开发手册》的关键知识点的详细介绍。通过理解这些核心概念和结构，开发者可以更高效地进行定制开发，实现所需的功能。