CakePHP3.4开发手册文档CakePHPCookbookDocumentationRelease3.4

需积分: 50 16 浏览量 2017-05-19 14:20:49 上传评论收藏 2.36MB PDF 举报

### CakePHP 3.4 开发手册文档概览 #### CakePHP 一瞥 CakePHP 是一款基于 PHP 的快速开发框架，它强调采用约定优于配置（Convention Over Configuration, CoC）的原则来简化开发过程，使得开发者能够快速构建稳定且安全的应用程序。在 CakePHP 3.4 中，这种原则体现得尤为明显，它通过清晰地定义应用结构、默认行为等，减少开发者需要编写的代码量，从而提高开发效率。 - **模型层**：负责处理数据和业务逻辑。它提供了一套完整的 ORM（对象关系映射）系统，使得开发者能够更方便地与数据库进行交互。 - **视图层**：主要负责用户界面的展示。在 CakePHP 中，视图层支持多种布局和模板引擎，可以根据项目需求灵活选择。 - **控制器层**：作为模型层和视图层之间的桥梁，它负责接收用户的请求，并根据请求调用相应的模型方法处理数据，最后将结果传给视图层显示。 #### CakePHP 请求周期当一个 HTTP 请求到达时，CakePHP 框架会按照以下步骤处理： 1. **路由**：请求会被路由到对应的控制器和动作（action）。 2. **控制器**：接着控制器接收到请求并处理，通常涉及到数据的加载或修改。 3. **模型**：控制器可能会调用模型来进行数据操作，例如查询数据库、验证数据等。 4. **视图**：控制器将处理好的数据传递给视图层进行渲染，然后返回给客户端。 #### 入门指南 **快速启动指南**提供了对 CakePHP 的初步了解，适合刚刚接触该框架的开发者。其中包括了 Bookmarker 教程，这是一个简单的书签管理应用，通过这个教程，开发者可以学习到如何创建模型、控制器以及视图，如何实现基本的 CRUD（创建、读取、更新、删除）功能。 #### 迁移指南对于从旧版本迁移至 CakePHP 3.4 的开发者来说，3.0 迁移指南是必不可少的资源。该指南详细介绍了新版本中的变化，包括但不限于命名空间的调整、配置方式的变化以及全新的 ORM 系统等。具体来说： - **安装与目录结构**：建议使用 Composer 来安装 CakePHP，以确保依赖项的正确管理和版本控制。 - **命名空间**：新版本引入了更为清晰的命名空间结构，以适应现代 PHP 开发的需求。 - **配置**：新的配置方式更加灵活，支持多种存储格式如 YAML 和 JSON。 - **新 ORM**：3.4 版本引入了一个全新的 ORM 层，提高了数据操作的效率和便捷性。 #### 调试与性能优化 - **调试**：CakePHP 提供了一系列工具帮助开发者进行调试，例如内置的日志记录功能和错误报告机制。 - **缓存**：为了提高性能，框架支持多种缓存策略，开发者可以根据应用的实际需求选择合适的缓存方案。 #### 控制器与组件 - **控制器**：作为 MVC 架构中的重要组成部分，控制器负责处理用户的请求，并决定应调用哪个模型和视图。 - **组件**：组件是一种可以被多个控制器共享的代码库，用于实现复用的功能。 #### 模型与数据访问 - **模型**：模型是数据层的核心，它负责与数据库进行交互，执行查询和更新等操作。 - **测试**：CakePHP 内置了强大的测试工具，支持单元测试、集成测试等多种类型的测试，以确保应用程序的质量。 #### 视图与模板 - **视图**：视图层用于呈现数据给用户，框架支持多种模板引擎。 - **辅助类**：辅助类可以帮助开发者更轻松地生成 HTML、表单等元素。 #### 国际化与本地化 - **I18n**：CakePHP 支持多语言环境，可以通过配置文件轻松切换不同的语言。 - **L10n**：针对不同地区的日期时间、货币格式等本地化需求，框架也提供了相应的解决方案。 #### 测试 CakePHP 内置了强大的测试框架，支持单元测试、功能测试等多种类型的测试，以确保应用程序的质量。 #### 实用工具 - **网络**：网络模块提供了处理 HTTP 请求和响应的能力，还包括邮件发送等功能。 - **会话管理**：CakePHP 提供了会话管理工具，帮助开发者轻松实现用户的登录和注销功能。 #### 教程与示例 - **Bookmarker 教程**：通过构建一个简单的书签管理系统，帮助开发者掌握 CakePHP 的基本用法。 - **博客教程**：分三部分介绍如何构建一个完整的博客网站，包括用户认证和授权等功能。 - **内容管理教程**：演示了如何创建一个基本的内容管理系统，涉及数据库设计、文章管理、标签系统等多个方面。 #### 贡献指南对于希望为 CakePHP 社区做出贡献的开发者来说，贡献指南提供了详细的指导，包括文档编写、提交 Bug 报告、代码贡献等方面的内容。 #### 安装与部署 - **安装**：介绍了 CakePHP 的安装要求及安装流程，推荐使用 Composer 进行安装。 - **部署**：包括开发服务器的搭建、生产环境的配置等内容。 #### 配置 - **配置你的应用**：提供了关于如何设置应用配置的基本信息，包括路径设置、国际化配置等。 - **配置类**：介绍了如何使用配置类来管理应用的配置信息。 - **自定义配置引擎**：允许开发者根据实际需求创建自己的配置引擎。 #### 路由 - **快速游览**：简要介绍了 CakePHP 的路由机制及其工作原理。 - **连接路由**：详细解释了如何定义路由规则，以及如何利用这些规则将 URL 映射到特定的控制器和动作。 - **RESTful 路由**：探讨了如何创建符合 RESTful 风格的 URL，并将其映射到相应的控制器动作。 - **生成 URL**：介绍了如何利用 CakePHP 的 URL 生成工具来生成 URL 地址。以上只是 CakePHP 3.4 开发手册文档的一个概括，更多详细内容请参考官方文档。这份文档不仅涵盖了框架的基础知识，还深入探讨了高级主题和技术细节，对于任何希望深入了解和使用 CakePHP 的开发者来说都是宝贵的学习资源。

资源推荐

资源详情

资源评论

CakePHP Cookbook Documentation

Release 3.4

Cake Software Foundation

May 19, 2017

Contents

1 CakePHP at a Glance 1

Conventions Over Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

The Model Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

The View Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

The Controller Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

CakePHP Request Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Just the Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Additional Reading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Quick Start Guide 11

Bookmarker Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Bookmarker Tutorial Part 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3 3.0 Migration Guide 27

Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Upgrade Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Application Directory Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

CakePHP should be installed with Composer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Namespaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Removed Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

New ORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Object settings/conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Shell / Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Network\Http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Network\Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Controller\Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

TestSuite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

View\Helper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

I18n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

L10n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

4 Tutorials & Examples 51

Bookmarker Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Bookmarker Tutorial Part 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Blog Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Blog Tutorial - Part 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Blog Tutorial - Part 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Blog Tutorial - Authentication and Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Content Management Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

CMS Tutorial - Creating the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

CMS Tutorial - Creating the Articles Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

CMS Tutorial - Tags and Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

CMS Tutorial - Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

5 Contributing 107

Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Tickets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Coding Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Backwards Compatibility Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

6 Installation 131

Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Installing CakePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Development Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Production . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Fire It Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

URL Rewriting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

7 Conﬁguration 141

Conﬁguring your Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Additional Class Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

Inﬂection Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Conﬁgure Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Reading and writing conﬁguration ﬁles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

Creating your Own Conﬁguration Engines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Built-in Conﬁguration Engines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Bootstrapping CakePHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Disabling Generic Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

8 Routing 153

Quick Tour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Connecting Routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Creating RESTful Routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Passed Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Generating URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Redirect Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

Custom Route Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Creating Persistent URL Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

Handling Named Parameters in URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

9 Request & Response Objects 177

Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Setting Cross Origin Request Headers (CORS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Common Mistakes with Immutable Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

10 Controllers 193

The App Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

Request Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Controller Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

Interacting with Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Redirecting to Other Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Loading Additional Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Paginating a Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Conﬁguring Components to Load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Conﬁguring Helpers to Load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Request Life-cycle Callbacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

More on Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

11 Views 243

The App View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

View Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Using View Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

View Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Creating Your Own View Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

More About Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

12 Database Access & ORM 353

Quick Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

13 Bake Console 505

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505

14 Caching 513

Conﬁguring Cache Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514

Writing to a Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515

Reading From a Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516

Deleting From a Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

Clearing Cached Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

Using Cache to Store Counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

Using Cache to Store Common Query Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

Using Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

iii

剩余849页未读，继续阅读

评论收藏

内容反馈

zp_ice

粉丝: 2

CakePHP 3.4 开发手册文档 CakePHP Cookbook Documentation Release 3.4

最新资源

CakePHP 3.4 开发手册文档 CakePHP Cookbook Documentation Release 3.4

cakephp文档

cakephp中文手册

CakePHP框架最全中文文档

CakePHP 1.2 API 中文文档

cakephp中文手册.pdf

CakePHP中文手册

CakePHP 3.5 开发手册文档 CakePHP Cookbook Documentation Release 3.5/共900页 PDF

cakephp中文手册API

Django官方开发文档1.11.14 Documentation Release 1.11.14.dev20180502015643

Oracle Database Online Documentation 12c Release 1 (12.1)手册文档

cakephp最新开发文档

cakephp 1.3参考手册

CakePHP 1.3中文帮助文档

cakephp中文手册PDF版

cakephp_4：CakePHP 4

CakePHPphp框架 v4.1.6

cakephp 3.0 使用总结

cakephp 1.3.x 中文手册

cakephp 完全手册 chm版本

cakephp 中文手册

cakephp手册完整打印版

mvc,mvc手册cakephp中文手册

cakephp帮助文档

CakePHP入门翻译手册(序)

cakePHP 中文手册

CakePHP 中文手册.rar

最新资源