CakePHP框架最全中文文档.

(一) CakePHP 的基本原则

A. CakePHP 的结构

控制器 (Controller)，模型 (Model) 及视图 (View) 是 CakePHP 的特色，除此之外它

也包含了一些附加的类和对象，使得在 MVC 设计模式下开发更快更有乐趣。组件

(Component)、行为 (Behavior) 及助手 (Helper)，提供了可扩展性及可重用性来快速新增功

能到你的应用中。现在，我们将站在较高的层级上，接着开始寻找一些关于如何使用这些工具

的细节。

a) 控制器扩展──组件(Component)

组件 (Component) 是一个帮助简化控制器逻辑的类。如果你有一些想要在控制器(或应用

beforeFilter(), 在所有的控制器动作逻辑开始之前执行



beforeRender(), 在控制器动作逻辑之后执行，但在视图输出之前



afterFilter(), 在所有的控制器动作逻辑之后执行，包括视图输出。 也许在

afterRender() 与 afterFilter() 之间没有什么不同，除非你手动在你的控制器动作

之中呼叫 render() 及此后的包含一些逻辑操作。

b) 视图扩展──助手(Helper)

助手 (Helper) 是用来辅助视图逻辑的类。与组件在控制器中的使用非常类似，助手允许

在多个视图中存取及共享显示逻辑。其中一个核心助手是，AjaxHelper，它使得在视图中请求

料储存在树结构中，你可以具体指定你的 User 模型使用像树结构的行为，并获得在你的树结

构中自由操作移除、新增和搬移节点的功能

模型 (Model) 也支持另一个叫做 DataSource 的类。DataSource 是一个让模型以一致的

方式操作不同类别数据的抽象层。虽然在 CakePHP 应用中主要的数据来源通常是数据库，但

你也可以编写附加的 DataSource 来使模型表达 RSS feeds、CSV 文件、LDAP 目录数据 或

iCal 事件。DataSources 允许你从不同的数据来源来操作记录，而不只限制在使用 SQL 语句。

DataSources 也允许你通过 LDAP 模型关联到许多 iCal 事件。

就像控制器一样，模型也有使用回调函数的特性：



beforeFind()



afterSave()



beforeDelete()



afterDelete()

透过这些回调函数的名称，就应该可以了解它们的作用。你可以在讲述模型的章节找到更详细

的信息。

d) 应用扩展 Application Extensions

控制器 (Controller)、助手 (Helper)、模型 (Model) 都有各自的父类，你可以用来定

"/controller/action/var1/var2" 对映至 Controller::action($var1, $var2)，但是你可以

使用路由来自定 URL 以及它们如何对应你的应用。

一些在应用中的功能是值得整个打包的。插件 (Plugin) 是一个实现了特定功能的程序包，包

含了模型、控制器和视图，并可以延申到多个应用之中。用户管理系统或简单的 blog 也许是

一个相当适合的 CakePHP 插件

B. 一次典型的 CakePHP 请求

我们已经看过 CakePHP 的基本成分了，那么现在就来看看各个对象怎么完成一个基本的请

求。继续讲我们之前的请求的例子，想象一下我们的朋友 Ricardo 刚刚在一个 CakePHP 的应用

的首页上点击了“立刻买一个自定义的蛋糕!”这个链接。

3. 使用路由后，请求的 URL 被映射到一个控制器的动作中(在特定的一个控制器的类的一

个方法)。在这个例子，是 CakeController 类的 buy()方法。在控制器的所有动作逻辑

执行之前会调用 beforeFilter()回调方法(callback)。

4. 控制器可能会使用模型来处理应用的数据。在这个例子里，控制器使用了一个模型从数

据里得到 Ricardo 上次买的东西。在这次操作中所有这个模型适用的回调方法、习惯

(behavior)和数据源(DataSource)都可能得到实施。即使模型没有被用到，所有的

CakePHP 控制器的初始化至少都需要一个模型。

5. 当模型取得数据后，数据会被返回到控制器。模型的回调方法可能会被实施。

6. 控制器可能使用组件对数据进行进一步的加工，或者进行其他的操作(例如会话处理、

验证或者发电子邮件)。

会被执行，可能包括了各种元素及(或者)帮助方法。默认情况下，视图会在一个布局

(layout)里被渲染。

8. 附加的控制器回调方法(像 afterFilter)可能被实施。最后，完整的经过渲染的视图代

让我们来看看 CakePHP 的盒子里是用什么组成的。你知道 CakePHP 看起来像是从基本 MVC

组成的，但你也同样需要知道它档案是如何组织的。



cake



docs



index.php



vendors

料夹里的所有档案，如果你修改而导致魔法失效，我们将无法帮助你除错。docs 资料夹放置

了典型的读我、版本更新记录及授权资料档案。最后，vendors 资料夹是可以放置需要使用在

你应用程序的第三方 PHP 函数库

a) App 资料夹

CakePHP 的 app 目录将是开发应用程序时最常使用的一个。就让我们来更仔细的看 app 资料夹

里面有些什么

locale 储存用来国际化的字符档案。

models 包含你的应用程序模型、行为和资料来源。

这是用来储存 CakePHP 暂存资料的。实际上储存的资料是看你如何设定 CakePHP，

但这个资料夹通常用来储存模型描述、记录档和会谈资讯。

所有的第三方类别或函数库应该被放置在这个资料夹。可以简单的以

App::import(‘vendor’, ‘name’)使用它们。也许你会觉得多馀或困惑于此

处有 vendors 而上一层目录内也有 vendors 资料夹，这其中的差异是当我们讨论

到管理多应用程序和较为复杂的系统设定时，可以使用不同的配置。

维护的恶梦中释放出来。命名规则达成一致的系统开发，允许其它的开发者较容易加入或是提

供协助

CakePHP 的命名规则从许多开发者多年的经验及一些惯例筛选出来。尽管我们建议你开发

时使用命名规则，我们应该提及大部份这些规则简单又直观，特别是在修改旧有系统时较为轻

松容易

a) 档案及类别名称命名规则

一般来说，文件名是由下划线将单词分开，但是类名通常使用驼峰命名法。举例来说，类

KissesAndHugsController 的文件名会是 kisses_and_hugs_controller.php。

然而文件名不一定都以这样的规则来命名。例如：类 EmailComponent 的文件名是

email.php，而类 HtmlHelper 的文件名会是 html.php。

外键在 hasMany、belongsTo 或 hasOne 关系中随着相关模型在之后加上_id 是被认可的。

所以如果一个糕点师有许多饼干，饼干这个资料表透过 baker_id 外键将参考到糕点师这个资

料表。

结合资料表，使用 hasAndBelongsToMany (HABTM)关系在模型之间的命名方式必需依照字

母先后次序(是 apples_zebras 而不是 zebras_apples)

所有资料表与 CakePHP 模型互动(除了 join 资料表)需要有一个主键使每一列单一识别。

如果你希望使用无单一识别主键的资料表，像是你的 posts_tags 结合资料表，CakePHP 的命

名规则就是加在资料表名称的单一主键。

CakePHP 不支援复合主键。在这情况下你要直接操作你的结合资料表资料，这代表你需要

使用直接查询呼叫或是增加主键来使用一般的模型。例如: