入门指南

CakePHP 框架为应用程序提供了坚实的基础。它可以处理任何事情,从最初用户的请求直到最终网页的渲染。由于 CakePHP 框架遵循 MVC 的原则,让你可以轻松定制和扩展应用程序的大多数方面。

本框架还提供了一个基本的组织结构,从文件名到数据库表名,保持了整个应用程序的一致性和逻辑性。这个理念简单而强大。遵循约定,你就总是知道所有东西的准确位置以及它们是怎样组织的。

体验和学习 CakePHP 的最好办法是坐下来构建点什么。首先,我们将构建一个简单的博客应用程序。

博客教程

欢迎使用 CakePHP。阅读这个教程多半是因为你想了解更多有关 CakePHP 是如何工作的。我们的目的是提高生产力,并使编写代码更令人愉快,我们希望当你深入代码时会感受到这一点。

这个教程将引导你创建一个简单的博客应用。我们将会获取和安装 CakePHP,建立并配置数据库,创建足够的应用逻辑去列出博客文章清单,添加、编辑和删除博客文章。

这是你所需要的:

  • 一个运行中的 web 服务器。我们将假定你使用的是 Apache,虽然使用其它 web 服务器的步骤也差不多。我们可能需要对服务器的配置作一些调整,但大部分人不需要改动任何配置就可以让 CakePHP 跑起来。请确保你的 PHP 是5.2.8或更高版本。
  • 一个数据库服务器。在本教程中我们将使用 MySQL 数据库。你需要对 SQL 有足够的了解,以便创建一个数据库:CakePHP 将从这里接管数据库。既然我们使用 MySQL,请确保你在PHP 中开启了 pdo_mysql 模块。
  • 基础的 PHP 知识。你对面向对象编程的经验越多越好,不过如果你只懂面向过程编程,也不要害怕。
  • 最后, 你将需要对 MVC 编程模式有基本的了解。这里有一个简介理解模型-视图-控制器(MVC)。别怕,只是半页而已。
    让我们开始吧!

获取 CakePHP

首先,让我们获取一份最新的 CakePHP 代码的拷贝。

要获得最新的代码,请访问在 GitHub 上的 CakePHP 项目:https://github.com/cakephp/cakephp/tags ,并下载2.0的最新发行版本。

你也可以用 git 检出(clone)最新的代码。git clone git://github.com/cakephp/cakephp.git

不管你是通过什么方式下载的,将下载后的代码放到你的文档根目录(DocumentRoot)里。完成后,你的目录应当象这样:

  1. /path_to_document_root
  2. /app
  3. /lib
  4. /plugins
  5. /vendors
  6. .htaccess
  7. index.php
  8. README

现在也许是个适当的时机去了解一下 CakePHP 的目录结构是如何组织的,请参阅CakePHP 目录结构 一节 。

Tmp 目录的权限

下面我们要让目录 app/tmp 可以被 web 服务器写入。最好的方法是找出你的 web 服务器使用哪个用户运行。你可以在 web 服务器可以执行的任何 PHP 文件中运行<?php echo whoami; ?>。你应当会看到一个用户名被输出。将目录 app/tmp 的拥有者(owner)改为该用户。最终(在 *nix系统中)运行的命令会象这样:

  1. $ chown -R www-data app/tmp

如果因为某些原因 CakePHP 不能写入到该目录, 你将看到警告和缓存数据无法写入的未捕获异常。

创建博客数据库

下一步,让我们建立博客的数据库。如果还没有做这些,就为本教程创建一个空的数据库,名字随便起。现在我们要创建一个表来存储我们的文章,然后再添加几篇文章作测试用。在数据库里面执行下面的 SQL 语句:

  1. /* 首先,创建我们的日志表: */
  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. /* 然后,插入一些测试用的文章记录: */
  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());

表和列的名字并不是随意取的。如果你遵循 CakePHP 的数据库命名约定,以及类的命名约定(二者都在 CakePHP 的约定 做了介绍),你将可以利用许多现成的功能并免去配置的麻烦。CakePHP 足够灵活,可以适应即使最糟糕的旧式(legacy)数据库结构,不过遵循约定可以节省时间。

请查看 CakePHP 的约定 以获得更多的信息,但我只想说,命名数据库表为'posts',将会自动把它连接到模型 Post,并且 CakePHP 将自动管理表的'modified'和'created'字段。

CakePHP 数据库配置

接下来,让我们告诉 CakePHP 我们的数据库放在那里以及如何连接。对于许多人来说,这将是第一次也是最后一次进行任何配置。

/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' => 'utf8'
  12. );

一旦你已经保存了新的 database.php 文件, 你应该能够打开你的浏览器并看到CakePHP 的欢迎页面。它应当告诉你,数据库连接文件已经找到,CakePHP 已经成功连接到数据库了。

注解

记住如果你需要使用 PDO,你需要在 php.ini 中启用 pdo_mysql 模块。

可选的配置

这里还有一些其他的选项可以设置。大多数开发者都会完成这些设置,不过它们在本教程中并不是必须的。一是定义一个定制字符串(或者叫"salt",译者注:salt 是密码保护中用于生成密码哈希的一个随机字符串)用于安全哈希,二是定义一个定制数(或者叫"seed")用于加密。

安全字符串(security salt)用于生成哈希。在 /app/Config/core.php 中改变Security.salt 的值。新的值应该足够长,难于猜测,并尽可能的随机:

  1. /**
  2. * 一个随机的字符串,用于安全哈希方法。
  3. */
  4. Configure::write('Security.salt', 'pl345e-P45s_7h3*S@l7!');

密码种子(cipher seed)用来加密/解密字符串。在 /app/Config/core.php 中改变缺省的 Security.cipherSeed 的值。新的值应当是一个随机大整数:

  1. /**
  2. * 一个随机数字字符串 (只含有数字) ,用于加密和解密字符串。
  3. */
  4. Configure::write('Security.cipherSeed', '7485712659625147843639846751');

关于 mod_rewrite 的说明

偶尔新用户会遇到 mod_rewrite 的问题。例如,如果 CakePHP 的欢迎页面看起来有点儿奇怪(不显示图片,或者没有 CSS 样式),这也许是因为你系统中的 mod_rewrite 没起作用。请参阅下面与你的 web 服务器相应的关于 URL 重写的章节,来解决这些问题:

接下来进入 博客教程——添加一个层,开始建立你的第一个CakePHP 应用程序.

博客教程——添加一个层

创建文章(Post)模型

模型类是 CakePHP 应用程序的基础。通过创建一个能够和数据库交互的 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 而不是 Post.php),CakePHP 将无法识别你的任何错误命名的模型类对象,而使用自动创建的模型对象代替。

关于模型的更多信息,比如表的前缀、回调和验证,请查看手册中的 模型 一章。

创建文章(Post)控制器

接下来,为我们的文章(post)创建一个控制器。这个控制器是所有文章的商业逻辑起作用的地方。总之,这里是你操纵模型,并完成有关文章的事情的地方。我们将把这个新的控制器保存在 /app/Controller 目录下的 PostsController.php 文件中。这是控制器的基本内容:

  1. class PostsController extends AppController {
  2. public $helpers = array('Html', 'Form');
  3. }

现在,让我们为控制器添加一个动作。动作通常代表应用中单个函数或者接口。例如,当用户请求 www.example.com/posts/index (等同于 www.example.com/posts/),他们将会期望看到一个文章列表。这个动作的代码会是这样:

  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/foobar 来访问。

警告

你也许会忍不住以某种方式来命名控制器和动作去得到一个特定的网址。请抵制住这种诱惑。请遵循 CakePHP 的规范(首字母大写,复数名词,等等),创建易读和易于理解的动作名称。你可以使用"路由(routes)"将网址与你的代码映射起来,这个后面会讲到。

在该动作中唯一的语句使用 set() 方法从控制器中把数据传递到视图(view)中(我们会在下一步创建视图)。该行代码设置名为'posts'的视图变量为 Post 模型的find('all') 方法的返回值。我们的 Post 模型自动可以通过 $this->Post 来访问,是因为我们遵循了 CakePHP 的命名规范。

想了解更多的关于 CakePHP 控制器的信息,请查看 控制器 一章。

创建文章(Post)视图

现在,我们的数据已经流向模型,应用程序的逻辑和流程也在控制器中定义了,让我们为之前的 index 动作创建一个视图吧。

CakePHP 的视图仅仅是嵌入应用程序的布局中的展示层片段。对大多数应用程序而言,他们是嵌入 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. )

CakePHP 的视图保存在 /app/View 目录中,在一个与相应的控制器对应的目录中。(在这里我们需要创建目录 'Posts'。)为了把文章(post)的数据显示在一个美观的表格中,我们的视图代码会象下面这样。

  1. <!-- File: /app/View/Posts/index.ctp -->
  2.  
  3. <h1>Blog posts</h1>
  4. <table>
  5. <tr>
  6. <th>Id</th>
  7. <th>Title</th>
  8. <th>Created</th>
  9. </tr>
  10.  
  11. <!-- Here is where we loop through our $posts array, printing out post info -->
  12.  
  13. <?php foreach ($posts as $post): ?>
  14. <tr>
  15. <td><?php echo $post['Post']['id']; ?></td>
  16. <td>
  17. <?php echo $this->Html->link($post['Post']['title'],
  18. array('controller' => 'posts', 'action' => 'view', $post['Post']['id'])); ?>
  19. </td>
  20. <td><?php echo $post['Post']['created']; ?></td>
  21. </tr>
  22. <?php endforeach; ?>
  23. <?php unset($post); ?>
  24. </table>

你也许已经注意到,我们使用了 $this->Html 这个对象。这是 CakePHP 的HtmlHelper 类的一个实例。CakePHP 提供了一组视图助件(view helper),从而使得链接、表单输出、JavaScript 和 AJAX 这些事情易如反掌。你可以在助件 一章了解到如何使用它们,但在这里值得注意的是,link() 方法会产生一个带有标题(第一个参数)和网址(第二个参数)的 HTML 链接。

在 CakePHP 中指定网址时,推荐使用数组格式。在路由(Routes)一节中我们会详细解释这些。使用数组格式来表示网址让你可以利用 CakePHP 的反向路由功能。你也可以定义相对于应用程序根目录的路径,像 /controller/action/param1/param2 这样。

现在,你可以在浏览器中输入地址 http://www.example.com/posts/index。你应该可以看到你的视图正确地显示,带有标题,以及表格中的文章列表。

如果你在点击了我们在这个视图中创建的链接(用文章标题指向网址 /posts/view/some_id的链接),CakePHP 将会告诉你这个动作尚未定义。如果你没有看到这个错误,那就是什么地方出错了,或者你实际上已经定义了,那你可够贼的。如果还没有,现在就让我们在PostsController 中创建这个动作吧:

  1. // File: /app/Controller/PostsController.php
  2. class PostsController extends AppController {
  3. public $helpers = array('Html', 'Form');
  4.  
  5. public function index() {
  6. $this->set('posts', $this->Post->find('all'));
  7. }
  8.  
  9. public function view($id = null) {
  10. if (!$id) {
  11. throw new NotFoundException(__('Invalid post'));
  12. }
  13.  
  14. $post = $this->Post->findById($id);
  15. if (!$post) {
  16. throw new NotFoundException(__('Invalid post'));
  17. }
  18. $this->set('post', $post);
  19. }
  20. }

你对 set() 方法应该已经很熟悉了。请注意我们使用 findById() 方法,而不是find('all') 方法,因为我们只想要一篇文章的数据。

注意到我们的视图动作接受一个参数,我们要查看的文章的 ID。这个参数是通过请求的网址来传递给动作的。如果用户请求 /posts/view/3,那么数据 '3' 就会作为 $id 传入。

我们也做了些错误检查来确保用户确实是要访问一条记录。如果用户请求/posts/view ,我们就抛出一个 NotFoundException 异常,让 CakePHP 的ErrorHandler 来处理。我们也作了同样的检查来确保用户访问的记录是存在的。

现在让我们创建我们的新动作 'view' 的视图,并保存为 /app/View/Posts/view.ctp

  1. <!-- File: /app/View/Posts/view.ctp -->
  2.  
  3. <h1><?php echo h($post['Post']['title']); ?></h1>
  4.  
  5. <p><small>Created: <?php echo $post['Post']['created']; ?></small></p>
  6.  
  7. <p><?php echo h($post['Post']['body']); ?></p>

为了验证这是正确的,请打开浏览器访问 /posts/index 页面中的链接,或者手工输入查看一篇文章的请求 /posts/view/1

添加文章(Post)

从数据库中读出并显示文章是一个好的开始,不过让我们允许添加新的文章。

首先,从在 PostsController 中创建 add() 动作开始:

  1. class PostsController extends AppController {
  2. public $helpers = array('Html', 'Form', 'Flash');
  3. public $components = array('Flash');
  4.  
  5. public function index() {
  6. $this->set('posts', $this->Post->find('all'));
  7. }
  8.  
  9. public function view($id) {
  10. if (!$id) {
  11. throw new NotFoundException(__('Invalid post'));
  12. }
  13.  
  14. $post = $this->Post->findById($id);
  15. if (!$post) {
  16. throw new NotFoundException(__('Invalid post'));
  17. }
  18. $this->set('post', $post);
  19. }
  20.  
  21. public function add() {
  22. if ($this->request->is('post')) {
  23. $this->Post->create();
  24. if ($this->Post->save($this->request->data)) {
  25. $this->Flash->success(__('Your post has been saved.'));
  26. return $this->redirect(array('action' => 'index'));
  27. }
  28. $this->Flash->error(__('Unable to add your post.'));
  29. }
  30. }
  31. }

注解

$this->request->is() 方法接受一个参数,可以是请求方法(getputpostdelete)或者请求标识(ajax)。这 是检查特定提交数据(posted data)的方法。比如,如果提交了书(book)的数据,$this->request->is('book') 不会返回 true。

注解

在会用到 FlashComponent 以及 FlashHelper 的控制器中,你要引入它们。如果必要的话,在你的 AppController 中引入。

这是 add() 动作所做的:如果这个请求的 HTTP 方法是 POST,将试图使用 Post (文章)模型保存数据。如果因为某些原因没有保存,就渲染视图。这让我们能够给用户显示验证错误或者其他警告。

每个 CakePHP 请求包括一个 CakeRequest 对象,可以通过 $this->request 来访问。该请求对象包含了刚收到的请求的有用信息,并且能够用来控制应用程序的流程。在这里,我们使用 CakeRequest::is() 方法来检查这个请求是否是一个 HTTP POST请求。

当用户在应用程序中使用一个表单提交(POST)数据时,该数据可以通过$this->request->data 访问。如果你想看到这些数据,你可以使用 pr()debug() 函数显示出来。

我们使用 FlashComponent 的 FlashComponent::setFlash() 方法在一个会话(session)变量中设置一条信息,在重定向后在页面中显示该信息。在布局中我们用FlashHelper::render() 方法来显示这条信息并清空相应的会话变量。控制器的Controller::redirect 方法重定向页面到另一个网址。参数array('action' => 'index') 就是网址 /posts (即 posts 控制器的 index 动作)。你可以参阅在 API 中的 Router::url() 方法,来了解可用来为 CakePHP 函数指定网址的各种格式。

调用 save() 方法将会检查错误验证,如果有任何错误即中断保存。我们将会在接下来的小节里讨论如何处理这些错误。

我们首先调用 create() 方法,来重置模型的状态,以保存新的数据。这不会真的在数据库中创建一条记录,而是清空 Model::$id 并根据数据库字段的缺省值来设置Model::$data。

数据验证

CakePHP 经过长期的努力来摆脱验证表单输入的千篇一律。每个人都痛恨编写没完没了的表单及其验证。CakePHP 使这些工作更容易、更快。

要利用验证功能,你将需要在视图中使用 CakePHP 的 FormHelper 助件。缺省情况下,FormHelper 在所有视图中都可以通过 $this->Form 来访问。

这是我们的 add 视图:

  1. <!-- File: /app/View/Posts/add.ctp -->
  2.  
  3. <h1>Add Post</h1>
  4. <?php
  5. echo $this->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. <form id="PostAddForm" method="post" action="/posts/add">

如果调用 create() 方法时不带参数,那么就认为你要创建一个表单,用 POST 方法来提交到当前控制器的 add() 动作(或者当表单数据中包含 id 时,提交到edit() 动作)。

$this->Form->input() 方法用于创建同名的(即 input)表单元素。第一个参数告诉CakePHP 关联到哪个字段,第二个参数让你定义一系列选项——在这里,我们定义 textarea的行数。在这里有一点自省和自动魔法(introspection and automagic): input() 方法将会根据指定的模型字段输出不同的表单元素。

$this->Form->end() 方法的调用生成一个提交按钮并结束表单。如果 end() 方法的第一个参数传入一个字符串,那么 FormHelper 输出的提交按钮将以该字符串为提交按钮上的文字,并输出表单的结束标签。再次,关于助件(helper)的更多信息请参阅助件

现在让我们回去并更新我们的 /app/View/Posts/index.ctp 视图,添加 "Add Post" 链接。在 <table> 之前添加如下代码:

  1. <?php echo $this->Html->link(
  2. 'Add Post',
  3. array('controller' => 'posts', 'action' => 'add')
  4. ); ?>

你也许会问:怎么告诉 CakePHP 我的验证要求呢?验证规则是在模型中定义的。让我们回去看一下 Post 模型,并做一些调整:

  1. class Post extends AppModel {
  2. public $validate = array(
  3. 'title' => array(
  4. 'rule' => 'notBlank'
  5. ),
  6. 'body' => array(
  7. 'rule' => 'notBlank'
  8. )
  9. );
  10. }

$validate 数组告诉 CakePHP,当 save() 方法被调用时如何去验证你的数据。这里,我定义了 body 和 title 字段都不能为空。CakePHP 的验证引擎很强大,有许多内置的验证规则(信用卡、电子邮件,等等),并且灵活,便于你增加自己的验证规则。更多信息请查看 数据验证

现在你已经完成了验证规则,使用应用程序来尝试添加一篇文章,空着 title 或者 body,看看验证规则如何起作用。因为我们已经使用了 FormHelper 的FormHelper::input() 方法来创建我们的表单元素,我们的验证错误信息将会自动显示出来。

编辑文章(Post)

让我们开始编辑文章吧。你现在已经是个 CakePHP 专家了,所以你现在应该已经习惯于这种模式。建立动作,然后添加视图。控制器 PostsController 中的 edit() 动作会是这样

  1. public function edit($id = null) {
  2. if (!$id) {
  3. throw new NotFoundException(__('Invalid post'));
  4. }
  5.  
  6. $post = $this->Post->findById($id);
  7. if (!$post) {
  8. throw new NotFoundException(__('Invalid post'));
  9. }
  10.  
  11. if ($this->request->is(array('post', 'put'))) {
  12. $this->Post->id = $id;
  13. if ($this->Post->save($this->request->data)) {
  14. $this->Flash->success(__('Your post has been updated.'));
  15. return $this->redirect(array('action' => 'index'));
  16. }
  17. $this->Flash->error(__('Unable to update your post.'));
  18. }
  19.  
  20. if (!$this->request->data) {
  21. $this->request->data = $post;
  22. }
  23. }

这个动作首先确保用户访问的是一条现存的记录。如果没有传入 $id 参数,或者该文章(post)不存在,就抛出 NotFoundException 异常,让 CakePHP 的 ErrorHandler 来处理。

接着,检查这个请求是否是 POST 请求或者 PUT 请求。如果是,我们就使用提交(POST)的数据来更新文章(Post)记录,否则就退回并给用户显示验证错误。

如果 $this->request->data 中没有数据,我们就简单地把它设置为之前面读取的文章(post)。

edit 视图会是这样:

  1. <!-- File: /app/View/Posts/edit.ctp -->
  2.  
  3. <h1>Edit Post</h1>
  4. <?php
  5. echo $this->Form->create('Post');
  6. echo $this->Form->input('title');
  7. echo $this->Form->input('body', array('rows' => '3'));
  8. echo $this->Form->input('id', array('type' => 'hidden'));
  9. echo $this->Form->end('Save Post');
  10. ?>

这个视图输出编辑表单(填入了一些值),以及一些必要的验证错误信息。

在这里需要注意的是:如果数据数组中有 'id' 字段,CakePHP 将认为你在编辑一个模型。如果其中没有 'id' 字段(可以回去看一下 add 视图),当调用 save() 时,CakePHP 将认为你正在插入一个新的模型。

现在可以更新你的 index 视图,并添加编辑文章(post)的链接了:

  1. <!-- File: /app/View/Posts/index.ctp (edit links added) -->
  2.  
  3. <h1>Blog posts</h1>
  4. <p><?php echo $this->Html->link("Add Post", array('action' => 'add')); ?></p>
  5. <table>
  6. <tr>
  7. <th>Id</th>
  8. <th>Title</th>
  9. <th>Action</th>
  10. <th>Created</th>
  11. </tr>
  12.  
  13. <!-- Here's where we loop through our $posts array, printing out post info -->
  14.  
  15. <?php foreach ($posts as $post): ?>
  16. <tr>
  17. <td><?php echo $post['Post']['id']; ?></td>
  18. <td>
  19. <?php
  20. echo $this->Html->link(
  21. $post['Post']['title'],
  22. array('action' => 'view', $post['Post']['id'])
  23. );
  24. ?>
  25. </td>
  26. <td>
  27. <?php
  28. echo $this->Html->link(
  29. 'Edit',
  30. array('action' => 'edit', $post['Post']['id'])
  31. );
  32. ?>
  33. </td>
  34. <td>
  35. <?php echo $post['Post']['created']; ?>
  36. </td>
  37. </tr>
  38. <?php endforeach; ?>
  39.  
  40. </table>

删除文章(Post)

接下来,让我们为用户增加删除文章(post)的功能。先在 PostsController 中添加delete() 动作:

  1. public function delete($id) {
  2. if ($this->request->is('get')) {
  3. throw new MethodNotAllowedException();
  4. }
  5.  
  6. if ($this->Post->delete($id)) {
  7. $this->Flash->success(
  8. __('The post with id: %s has been deleted.', h($id))
  9. );
  10. } else {
  11. $this->Flash->error(
  12. __('The post with id: %s could not be deleted.', h($id))
  13. );
  14. }
  15.  
  16. return $this->redirect(array('action' => 'index'));
  17. }

这个逻辑删除 $id 指定的文章(post),然后使用 $this->Flash->success(),在重定向到 /posts 后,给用户显示确认信息。如果用户尝试通过 GET 请求删除文章(post),我们就抛出异常。未捕获的异常将被 CakePHP 的异常处理捕获,并显示漂亮的错误页面。有许多内置的 异常,可以用来表示应用程序需要生成的各种 HTTP 错误。

因为我们仅仅是执行一些逻辑和重定向,所以这个动作没有视图。不过,你可能想要修改index 视图,添加让用户删除文章(post)的链接:

  1. <!-- File: /app/View/Posts/index.ctp -->
  2.  
  3. <h1>Blog posts</h1>
  4. <p><?php echo $this->Html->link('Add Post', array('action' => 'add')); ?></p>
  5. <table>
  6. <tr>
  7. <th>Id</th>
  8. <th>Title</th>
  9. <th>Actions</th>
  10. <th>Created</th>
  11. </tr>
  12.  
  13. <!-- Here's where we loop through our $posts array, printing out post info -->
  14.  
  15. <?php foreach ($posts as $post): ?>
  16. <tr>
  17. <td><?php echo $post['Post']['id']; ?></td>
  18. <td>
  19. <?php
  20. echo $this->Html->link(
  21. $post['Post']['title'],
  22. array('action' => 'view', $post['Post']['id'])
  23. );
  24. ?>
  25. </td>
  26. <td>
  27. <?php
  28. echo $this->Form->postLink(
  29. 'Delete',
  30. array('action' => 'delete', $post['Post']['id']),
  31. array('confirm' => 'Are you sure?')
  32. );
  33. ?>
  34. <?php
  35. echo $this->Html->link(
  36. 'Edit', array('action' => 'edit', $post['Post']['id'])
  37. );
  38. ?>
  39. </td>
  40. <td>
  41. <?php echo $post['Post']['created']; ?>
  42. </td>
  43. </tr>
  44. <?php endforeach; ?>
  45.  
  46. </table>

使用 postLink(),会创建一个链接,该链接使用 Javascrip 来提交一个删除文章(post)的 POST 请求。允许使用 GET 请求来删除内容是危险的,因为这让网络爬虫有可能意外删除你网站的所有内容.

注解

这个视图的代码也使用了 FormHelper,当用户试图删除一篇文章(post)时,显示一个JavaScript 确认对话框供用户确认。

路由(Route)

对一些人来说,CakePHP 缺省的路由已经足够了。而对用户友好性和通用搜索引擎兼容性敏感的开发者,会喜欢 CakePHP 把网址(URL)映射到特定动作(action)的方式。所以,让我们在这个教程中对路由做一个小小的改动吧。

关于高级路由技术的更多信息,请参阅 路由的配置

缺省情况下,CakePHP 对于网站根目录的请求(例如 http://www.example.com),使用PagesController 来响应,并渲染 "home" 视图。这里,我们会增加一条路由规则,将其替换为我们的 PostsController。

CakePHP 的路由设置在 /app/Config/routes.php 文件中。你应当注释掉或者删除掉缺省的根目录路由。该代码如下:

  1. Router::connect(
  2. '/',
  3. array('controller' => 'pages', 'action' => 'display', 'home')
  4. );

这一行连接网址 '/' 到 CakePHP 的缺省首页。我们想要把它连接到我们自己的控制器,所以把该行代码替换为:

  1. Router::connect('/', array('controller' => 'posts', 'action' => 'index'));

这样就把用户对 '/' 的请求导向 PostsController 的 index() 动作。

注解

CakePHP 也支持'反向路由'。基于上面定义的路由,如果你给一个接受数组的函数传入array('controller' => 'posts','action' => 'index') ,得到的网址就会是'/'。所以,最好总是使用数组来表示网址,这样就表示你的路由定义了网址指向哪里,而且也确保链接指向相同的地方。

结论

用这种方法来创建应用程序会为你赢得甚至超出你最疯狂的幻想的平静、荣誉、爱和金钱。简单吧?记住,这个教程仅仅是基础。CakePHP 还提供了 更多 的功能,并且很灵活,碍于篇幅无法在这里详述。本手册余下的部分,可以指导你创建更加功能丰富的应用程序。

既然你已经创建了一个基本的 CakePHP 应用程序,那么你已经可以开始真的做点儿东西了。启动你自己的项目吧,别忘记阅读 Cookbook 的其余部分,以及API

如果需要,有很多方法可以获得你需要的帮助——请查看获取帮助 页面。欢迎加入 CakePHP!

延伸阅读的建议

这些是学习 CakePHP 的人们接下来通常想去学习的常见任务:

延伸阅读