CmlPHP v2.x 开发手册

• 语言: 中文（简体）
• 格式: .pdf
• 来源: cdn.cmlphp.com

摘要

CmlPHP v2.x 是一个基于 PHP 5.3+ 开发的 MVC/HMVC/MVSC/HMVSC 框架，支持 composer、分布式数据库和缓存，提供多种 URL 模式和路由支持。框架集成了缓存机制，优化性能，并提供了安全防护如防注入、CSRF 检查和表单令牌。同时，CmlPHP 支持插件扩展，通过钩子机制实现功能增强。文档详细介绍了框架的配置、开发指引、安全措施及插件使用方法，适合快速上手开发。

AI总结

《CmlPHP v2.x 开发手册》简介

本手册主要介绍了CmlPHP框架的V2.x版本的开发使用方法，旨在帮助开发人员快速、高效地使用该框架进行项目开发。

### 1. 框架简介
CmlPHP是一款基于PHP5.3+（v2.7起要求PHP5.4+）的MVC/HMVC/MVSC/HMVSC框架，具有以下核心特点：
- **组件支持**：支持Composer、分布式数据库、分布式缓存（异常自动容灾），以及文件、Memcache、Redis、APC等缓存方式。
- **URL模式**：支持多种URL模式和RESTful风格的URL路由。
- **扩展性**：支持多项目集成、第三方扩展和插件。
- **缓存管理**：在Model层集成了缓存功能，开发者无需关注数据缓存问题，通过API调用即可获得最佳性能。
- **部署灵活性**：支持根目录、子目录、单入口、多入口部署，适配独立服务器、虚拟主机、VPS等多种环境。

### 2. 项目结构
- **目录骨架**：提供推荐的项目目录骨架，可快速初始化项目。
- **入口文件**：从v2.7起，入口文件中可灵活配置各个目录组成，框架会自动处理伪静态规则，减少配置工作。
- **资源管理**：支持将项目下Resource目录映射到公用目录（如public），便于静态资源管理。

### 3. 开发指引
- **配置文件**：包括normal.php、common.php、plugin.php、route.php等，支持动态修改配置。
- **URL与路由**：框架自动处理URL配置，支持多种URL模式。
- **请求与响应**：通过`\Cml\Http\Input`类提供多种方法处理GET、POST、REQUEST数据，支持字符串、整数、布尔值等类型。
- **安全性**：
- 数据库防注入：框架在数据库层内置防注入处理。
- 用户输入验证：通过`\Cml\Http\Input`类处理用户数据输入。
- CSRF防护：默认开启对非站内域名POST数据的检查，可配置表单令牌防止CSRF攻击。
- **数据处理**：支持MySQL数据查询、分页查询、数据添加、更新、删除等操作，提供获取上一次插入ID、更新影响行数等功能。

### 4. 扩展功能
- **插件机制**：通过钩子（Hook）实现插件扩展，支持在模板中使用`{{hook}}`定义钩子位置，并在插件配置文件中挂载插件。
- **(static resources management)**：支持静态资源管理，以提升开发效率和网站性能。

### 5. 安全与防护
框架内置了多种安全机制，如防注入、CSRF防护、表单令牌验证等，以帮助开发者编写更安全的代码。

### 6. 常见问题与升级日志
文档中还涵盖了常见问题解答和升级日志，帮助开发者解决开发过程中可能遇到的问题并了解框架的版本更新。

### 总结
CmlPHP v2.x是一款功能强大、扩展性高、安全性强的PHP框架，适合快速开发和高性能需求的项目。通过本手册，开发者可以快速熟悉框架的使用方法，提升开发效率和项目质量。