CakePHP 2.x CookBook 中文版 第三章 入门
CakePHP 框架为应用程序提供了坚实的基础。它控制着所有方面，从用户的初始请求直到 web 页面的最终渲染。由于本框架遵循 MVC 原则，使得自定义和扩展应用程序变得更容易。
本框架还提供了一个基本的原始结构，从文件名到数据库表名，保持了应用程序的一致性和逻辑性。这个概念简单而强劲。遵循规则，就会知道东西都在哪儿，都是怎样组织的。
体验和学习 CakePHP 的最好办法是坐下来做点什么。我们将开始构建一个简单的博客系统。
博客课程
欢迎来到 CakePHP。你也许浏览这个课程因为你想了解 CakePHP 如何工作的更多信息。我们旨在提高生产力，使编程更愉悦：我们希望你深入代码，以了解这一点。
本课程将引领你创建一个简单的博客应用程序。我们获取和安装 CakePHP，建立和配置数据库，并且建立列表、新建、编辑和删除博客贴子的逻辑。
以下是我们需要的东西：
- 一个运行中的 web 服务器。假定使用的是 Apache，不过使用其它 web 服务器的说明也是类似的。我们可能要做一点服务器配置，但是大多数人完全不需要任何配置就可以运行 Cake。 请确认你拥有 PHP 5.2.8 或更高版本。
- 一个数据库服务器。在本课程中我们将使用 MySQL 服务器。你需要了解足够的建立数据库的 SQL 信息：Cake 将从那得到控制权。如果我们使用 MySQL，还要确认 PHP 已经启用了pdo_mysql。
- 基本的 PHP 知识。最好还懂面向对象编程：但是如果你只是个编程爱好者，也不必担心。
- 最后，需要有一点 MVC 编程模式的基本知识。在理解 模型 - 视图 - 控制器一节能找到一个快速预览。不用担心，大约只有半页左右。
让我们开始吧！
获得 Cake
首先让我们取得一份新鲜的 Cake 代码的拷贝。
要得到新鲜的下载，访问 Github 上的 CakePHP 项目：http://github.com/cakephp/cakephp/downloads并且下载 2.0 的最新版本。
也可以使用 git 克隆代码仓库：git。
1 git clone git://github.com/cakephp/cakephp.git
不管是怎样下载的，都把代码放进 DocumentRoot 之内。一旦完成，目录内的东西看起来应该像下面这样：
/path_to_document_root /app /lib /plugins /vendors .htaccess index.php README
现在也许是多学一点儿关于 CakePHP 目录结构如何工作的好时候：浏览CakePHP 的文件夹结构一节。
建立博客数据库
接着，设置博客的基本数据库。如果你还不曾这么做，建立一个为本教程所用的空数据库，名称任选。现在，建立一个单表用来存储博客贴子。我们也抛出几个贴子用于测试。在数据库上执行如下语句：
1 /* First, create our posts table: */ 2 CREATE TABLE posts ( 3 id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY, 4 title VARCHAR(50), 5 body TEXT, 6 created DATETIME DEFAULT NULL, 7 modified DATETIME DEFAULT NULL 8 ); 9 10 /* Then insert some posts for testing: */ 11 INSERT INTO posts (title,body,created) 12 VALUES ('The title', 'This is the post body.', NOW()); 13 INSERT INTO posts (title,body,created) 14 VALUES ('A title once again', 'And the post body follows.', NOW()); 15 INSERT INTO posts (title,body,created) 16 VALUES ('Title strikes back', 'This is really exciting! Not.', NOW());表名和列名并非随意指定的。如果遵循 Cake 的数据库命名规则和 Cake 类命名规则（两者的要点都在CakePHP 约定一节），能够得到额外的好处：附送的功能并且无需配置。Cake 足够灵活以适应糟糕的遗留数据库结构，但是遵循规则会节省很多时间。
更多的信息参见CakePHP 约定一节，简单点说，只要把表命名为“posts“就能自动与 Post 模块挂靠在一起，而 modified 和 created 列则会被 Cake 自动管理。
Cake 数据库配置
步步高升：让我们告诉 Cake 数据库在哪儿以及如何连接它。对于多数情况，这是唯一的配置。
/app/Config/database.php.default是 CakePHP 数据库配置文件的一个副本，在同一目录中复制这个文件，命名为database.php。
这个配置文件非常简单：只要用实际的值替换数组 $default 的值。下面是一个完整的配置数组的示例：
1 public $default = array( 2 'datasource' => 'Database/Mysql', 3 'persistent' => false, 4 'host' => 'localhost', 5 'port' => '', 6 'login' => 'cakeBlog', 7 'password' => 'c4k3-rUl3Z', 8 'database' => 'cake_blog_tutorial', 9 'schema' => '', 10 'prefix' => '', 11 'encoding' => '' 12 );
保存了新的database.php文件之后，打开浏览器浏览 Cake 欢迎页面。上面将会显示数据库连接文件被找到，并且已能正确地连接到数据库。
注解
记得你需要 PDO，并且 php.ini 文件中 pdo_mysql 必须可用（enabled）。
可选的配置
另外还有三项配置。许多开发人员完成了长长的列表项，但是它们不包含在本教程中。一是定义一个自定义字符串（salt）用于安全哈希。二是定义一个自定义数字（seed）用于加密。三是允许 CakePHP 写入它的tmp文件夹。
安全 salt 用来生成哈希值。编辑/app/Config/core.php文件的 187 行修改默认的salt值。什么样的值不会有麻烦呢？长到不容易被猜到的值。
1 /** 2 * A random string used in security hashing methods. 3 */ 4 Configure::write('Security.salt', 'pl345e-P45s_7h3*S@l7!');密码种子用于加/解密字符串。编辑/app/Config/core.php的 192 行修改默认的seed值。什么样的值不会有麻烦呢？长到不容易被猜到的值。
1 /** 2 * A random numeric string (digits only) used to encrypt/decrypt strings. 3 */ 4 Configure::write('Security.cipherSeed', '7485712659625147843639846751');最后一项任务是使app/tmp目录允许 web 写入。最好的办法是先用（）找出运行 web 服务器的用户，然后将app/tmp的所有者指向该用户。在 *nix 系统中运行类似下面的命令：
1 $ chown -R www-data app/tmp
如果囿于某些条件而不能写入这个文件夹，你会收到一个不能使用产品模式的警告。
mod_rewrite 说明
偶尔有用户会遇到 mod_rewrite 方面的问题，所以我们在这做个简要说明。如果 CakePHP 欢迎页面有点儿可笑（没有图片或 CSS 样式），意味着系统中缺少 mod_rewrite 功能。有一些对正确运行有帮助的提示： :
确定 .htaccess 覆盖是被允许的：在 httpd.conf 中每个目录有一个节定义这条规则。确认是在正确的目录中把AllowOverride设置All。出于安全和执行方面的原因，不要在
中把AllowOverride设置为All。替代方案是寻找指向所用 web 站点目录的 块。 -
确定 .htaccess 覆盖是被允许的：在 httpd.conf 中每个目录有一个节定义这条规则。确认是在正确的目录中把AllowOverride设置All。出于安全和执行方面的原因，不要在
中把AllowOverride设置为All。替代方案是寻找指向所用 web 站点目录的 块。 -
确认编辑了正确的 httpd.conf，而不是某个用户或特别站点的 httpd.conf。
-
有些情况下，可能拿到的是一个不带 .htaccess 文件的 CakePHP 副本。出现这种情况的原因是由于一些操作系统隐藏（不显示）以 . 开头的文件，以致拷贝时没有拷贝这个文件。确保 CakePHP 的副本来自下载一节的站点或 git 仓库。
-
确认 Apache 正确的加载了 mod_rewrite。应该可以在 httpd.conf 中看到如下的内容：:
1 LoadModule rewrite_module libexec/httpd/mod_rewrite.so
或者（在 Apache 1.3）中
1 AddModule mod_rewrite.c
如果不想或不能让运行中的系统使用 mod_rewrite（及其它兼容模块），需要使用 CakePHP 内置的漂亮 URLs。取消/app/Config/core.php文件中如下一行的注释：
1 Configure::write('App.baseUrl', env('SCRIPT_NAME'));同时删除这几个 .htaccess 文件：
/.htaccess /app/.htaccess /app/webroot/.htaccess
这会用类似 www.example.com/index.php/controllername/actionname/param 的 URL 代替 www.example.com/controllername/actionname/param。
如果 CakePHP 安装在 Apache 以外的 web 服务器上，可以在高级安装一节找到工作在 URL 重写机制下的介绍。
接下来的博客课程 —— 加入一个层，将开始第一个 CakePHP 应用程序。
-
博客课程 —— 加入一个层
建立 Post 模型
模型（model）类是 CakePHP 应用程序的面包和奶油。通过建立与数据库结合的模型类，我们就有了随后放置所需的显示、添加、编辑和删除操作的基础。
CakePHP 的模型类放在 /app/Model 文件夹，我们建立的文件将被存为 /app/Model/Post.php。完整的文件类似于：
1 class Post extends AppModel { 2 }
在 CakePHP 中命名规则非常重要。通过把类命名为 Post，CakePHP 会自动认定这个模型将被用在 PostsController 中，而且会与名为posts的数据库表关联。.
注解
如果 CakePHP 不能在 /app/Model 文件夹内找到相对应的文件，它会动态地建立一个模型对象。也就是说，如果不慎写错了文件名（例如 post.php 或者 posts.php），CakePHP 就不认识所有的设置并使用默认的设置代替它。
关于模型的更多信息，诸如表前缀、回调和数据校验，请参阅手册中模型一章。
建立 Posts 控制器
接着我们为贴子建立一个控制器。这个控制器是发生贴子交互的地方。简单地说，它就是完成运行模型和获得贴子相关工作的地方。我们将在/app/Controller目录的PostsController.php文件中放置一个控制器类。类的基本内容类似于：
1 class PostsController extends AppController { 2 public $helpers = array('Html', 'Form'); 3 }
现在在控制器中添加一个动作。控制器中的动作通常实现单一的功能或接口。例如，当用户请求http://www.example.com/post/index（这个和http://www.example.com/post相同），他们可能期待看见一个贴子列表。这个动作的代码类似于：
1 class PostsController extends AppController { 2 public $helpers = array('Html', 'Form'); 3 4 public function index() { 5 $this->set('posts', $this->Post->find('all')); 6 } 7 }
我来解释一下这个动作。通过在 PostsController 中定义一个函数index()，用户现在就能够通过向www.example.com/posts/index 提交访问程序逻辑。类似地，如果定义一个函数叫foobar()，用户就能够访问 www.example.com/posts/index。
警告
以短小的方式命名控制器和动作是一种诱惑，要抑制这种诱惑。遵循 CakePHP 的命名规则（以复数命名控制器等）建立易读、易理解的动作名称。随后可以通过``路由``映射 URLs 到代码。
上例中index动作中使用set()方法从控制器向视图（后面会创建）传递数据。设置视图那一行中名为 ‘posts’ 的变量等于 Post 模型的find('all')方法的返回值。由于遵循了 Cake 的命名规则，Posts 模型自动可用（$this->Post）。
要学习 Cake 控制器的更多内容，请浏览控制器一章。
建立 Post 视图
现在已经有了数据流、模型、程序逻辑和定义数据流向的控制器。我们要建立与上面例子中的 index 动作对应的视图。
Cake 视图仅是呈现应用程序布局的片段。对于多数应用程序，视图是混合了 PHP 的 HTML，但是它也可以是 XML、CSV，甚至是二进制数据。
布局是包装视图的处理显示的代码，能够定义和切换，但是现在，我们使用默认的布局。
还记得上一节是如何使用set()方法给视图中的 ‘posts’ 变量赋值的吗？所传递的数据类似于：
1 // print_r($posts) output: 2 3 Array 4 ( 5 [0] => Array 6 ( 7 [Post] => Array 8 ( 9 [id] => 1 10 [title] => The title 11 [body] => This is the post body. 12 [created] => 2008-02-13 18:34:55 13 [modified] => 14 ) 15 ) 16 [1] => Array 17 ( 18 [Post] => Array 19 ( 20 [id] => 2 21 [title] => A title once again 22 [body] => And the post body follows. 23 [created] => 2008-02-13 18:34:56 24 [modified] => 25 ) 26 ) 27 [2] => Array 28 ( 29 [Post] => Array 30 ( 31 [id] => 3 32 [title] => Title strikes back 33 [body] => This is really exciting! Not. 34 [created] => 2008-02-13 18:34:57 35 [modified] => 36 ) 37 ) 38 )
Cake 的视图文件存储在/app/View目录下与控制器名称（去掉了 controller 后缀）同名的文件夹中（现在的情况下，要创建/app/View/Posts文件夹）。使用漂亮的表格格式化数据，其视图类似于：
1 2 3
Blog posts
4 5 6 7 8 9 10 11 12 13 14 15 16 20 21 22 23 24| Id | Title | Created |
|---|---|---|
| 17 Html->link($post['Post']['title'], 18 array('controller' => 'posts', 'action' => 'view', $post['Post']['id'])); ?> 19 |
希望这看起来挺简单。
你可能已经注意到例子中所用的那个调用$this->HTML的对象，这是 CakePHP 中 ‘HtmlHelper’ 的一个实例。CakePHP 带有一个生成类似链接、表单输出、JavaScript 和 Ajax 快照的视图助手集合。在助手一节你能学到更多如何使用它们的方法，现在要重点注意的是link()方法，它能用给定的标题（第一个参数）和 URL （第二个参数）生成 HTML 链接。
推荐使用数组格式在 CakePHP 中指定 URLs。在“路由”一节对此有更多的解释。使用数组格式处理 URLs 可以获得 CakePHP 服务器的路由兼容性。也可以用 /controller/action/param1/param2 的格式将 URLs 关联到应用程序。
现在，让你的浏览器指向http://www.example.com/posts/index。你会看到带有标题和帖子列表的格式正确的视图。
如果你点击了我们建立的这个视图中的某个链接（它将一个帖子标题链接到 URL /posts/view/some_id）， 你应该会发现 CakePHP 会报告那个 action 还没有定义。 如果你没有收到这个报告，表明有些事情可能出错了，或者你竟然已经定义了它，这是很诡异的一种情形^_^。 现在，让我们在 PostsController 中建立它：
1 class PostsController extends AppController { 2 public $helpers = array('Html', 'Form'); 3 4 public function index() { 5 $this->set('posts', $this->Post->find('all')); 6 } 7 8 public function view($id = null) { 9 $this->Post->id = $id; 10 $this->set('post', $this->Post->read()); 11 } 12 }
set()调用看上去有点眼熟。需要注意的是，我们在此优先使用read()而不是find('all')，这是因为我们仅仅要得到一条帖子信息。
还要注意，我们的视图 action 获取了一个参数: 我们希望看到的帖子的 ID。 这个参数是通过 URL 请求传递给 action 的。 如果用户请求 /posts/view/3，那么值 ‘3’ 就被传递给$id。
现在让我们建立一个新的 ‘view’ action 放在/app/View/Posts/view.ctp文件中。
1 2 34 5
Created:
6 7尝试输入链接/posts/index或者手动访问/posts/view/1，看看工作是否正常。.
添加帖子
虽然从数据库中读出贴子并展示给我们是个不错的开始，但是我们还需要可以添加贴子。
首先，从在 PostsController 中建立 add() 方法开始：
1 class PostsController extends AppController { 2 public $helpers = array('Html', 'Form', 'Session'); 3 public $components = array('Session'); 4 5 public function index() { 6 $this->set('posts', $this->Post->find('all')); 7 } 8 9 public function view($id) { 10 $this->Post->id = $id; 11 $this->set('post', $this->Post->read()); 12 13 } 14 15 public function add() { 16 if ($this->request->is('post')) { 17 $this->Post->create(); 18 if ($this->Post->save($this->request->data)) { 19 $this->Session->setFlash('Your post has been saved.'); 20 $this->redirect(array('action' => 'index')); 21 } else { 22 $this->Session->setFlash('Unable to add your post.'); 23 } 24 } 25 } 26 }
注解
在使用 Session 的任何一个 controller 中都需要包含 SessionComponent （和SessionHelper）。如果需要，可以将它包含在 AppController 中。
add()实现了这样几个功能：如果表单提交的数据非空，就试图使用 Post 模型保存数据。如果因为某些原因保存未成功，则渲染视图，这给了我们向用户显示数据校验或其它警告的机会。
每个 CakePHP 请求包含一个CakeRequest对象，它可以通过$this->request访问。 request 对象包含这次请求被获取的信息，并能够用于应用程序流的控制。 在本例中，我们使用CakeRequest::is()方法检验请求是否是以 HTTP POST 格式提交的。
当用户使用表单向应用程序提交数据（POST），其信息可以使用$this->request->data获取。 可以使用pr()或debug()方法输出这些数据。
我们使用了 Session 组件的SessionComponent::setFlash()方法发送了一条信息给 session 变量，用于在中转页上显示。 在中转页的布局中我们用SessionHelper::flash显示和清除这个 session 变量。 该控制器的Controller::redirect方法用于跳转到其它 URL。 参数array('action'=>'index')指定了跳转到 /posts URL，等于 posts 控制器的 index 方法。 你可以参考API中的Router::url()功能，它使你可以指定为不同的 Cake 函数指定一个 URL 格式。
调用save()方法将检查检验错误，并在出现错误时跳过保存。 我们将在后续的章节中讨论如何处理这些错误。
数据校验
Cake 在获取表单校验的单调输出方面做了大量的工作。每个人都痛恨无止境的编写表单及其验证。CakePHP 使其变得更快更容易。
想要更好的利用校验功能，就需要在视图中使用FormHelper助手。FormHelper助手默认在所有视图中都可用，用法是$this->Form。
这是我们添加的视图：
1 2 3
Add Post
4 Form->create('Post'); 6 echo $this->Form->input('title'); 7 echo $this->Form->input('body', array('rows' => '3')); 8 echo $this->Form->end('Save Post'); 9 ?>在这里，我们用 FormHelper 助手生成一个 HTML 表单的起始标签。$this->Form->create()生成的 HTML 是：
1
如果create()是不带参数调用的，表示创建的表单将以 POST 形式提交给同一个控制器的add()（或者当表单中含有id元素时提交给edit()）动作。
$this->Form->input()方法用来生成同名的表单元素，这个方法的第一个参数告诉 CakePHP 前后台通讯的是哪个域，第二个参数允许指定选项：本例中，是 textarea 域的行数。这里有一点自动完成的：input()方法将基于 model 指定的域生成不同的表单元素。
$this->Form->end()调用生成一个 submit 元素并结束表单。如果提供给end()方法的第一个参数是字符串，FormHelper 生成一个相应名称的 submit 域并关闭表单标签。再说一次，助手一节有更多的助手信息。
现在我们返回并更新/app/View/Posts/index.ctp视图使其包含一个新的 “Add Post” 链接。在
之前添加如下行：
1 Html->link( 2 'Add Post', 3 array('controller' => 'posts', 'action' => 'add') 4 ); ?>
你可能会奇怪：我如何通知 Cake 我的校验要求？校验规则是定义在模型中的。让我们回顾 Post 模型并稍作调整：
1 class Post extends AppModel { 2 public $validate = array( 3 'title' => array( 4 'rule' => 'notEmpty' 5 ), 6 'body' => array( 7 'rule' => 'notEmpty' 8 ) 9 ); 10 }
$validate数组告诉 CakePHP 在save()方法被调用时如何校验我们的数据。这里，我指定 title 和 body 都不能为空。CakePHP 的校验功能很强劲，带有一批预置的规则（如 信用卡号码、Email 地址等），而且可以灵活地添加自己的校验规则。可以浏览数据校验获取更多的相关信息。
现在已经有了校验规则，试着输入空的 title 和 body，看看它们是如何工作的。当我们使用 FormHelper 的FormHelper::input()方法创建表单，校验的错误信息会自动显示。
- 文章
- 推荐
- 热门新闻