关链字： CakePHP CakePHP开发Blog CakePHP开发案例 CakePHP实例

注意！本指南针对cake0.9.1dev 发布版不是SVN的版本。请不要把指南的代码改成于SVN一样。

Cake 指南：建立一个简单的Blog     

     这是一个还在不断变化的一个应用框架的指南。文章中的东西可能可以运行，但是如果有些东西无法运行，请您先仔细阅读 API 文档。错误报告对我们很有价值，所以，请报告任何影响您使用的地方。

     注意：命名方法的约定已经从下划线_风格变成了骆驼回归法则。所以，在我们目前的发布版中link_to()已经变成linkTo()。

     转载注明：http://bbs.phpres.com
                    [PHP开发资源网论坛]

     本贴申请加入精华，谢谢版主。

[ 本帖最后由 jiu.stong 于 2007-6-14 19:22 编辑 ]

默认Cake目录结构一览      

      在本篇指南中，我们将一起使用Cake来创建一个简单的Blog应用。我假设你对PHP十分了解，可以在你的系统中游刃有余（包括从命令行中运行程序），同时已经有一个配置好的开发服务器环境，例如运行PHP的 XAMPP。下载

     下载最新的Cake 包并解压缩到你的Web服务器的DOCUMENT_ROOT下（因为本文是指南的缘故，我假设他可以从http://localhost/cake/ 下访问）。你可以看到基本的目录结构。

创建数据库

创建一个用来存放Blog帖子的表格，并且初始化一些数据。以下是SQL语句：

CREATE TABLE posts (
    id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(50),
    body TEXT,
    created DATETIME DEFAULT NULL,
    updated DATETIME DEFAULT NULL
);

INSERT INTO posts (title,body,created)
    VALUES ('The title', 'This is the post body.', NOW());
INSERT INTO posts (title,body,created)
    VALUES ('A title once again', 'And the post body follows.', NOW());
INSERT INTO posts (title,body,created)
    VALUES ('Title strikes back', 'This is really exciting! Not.', NOW());
注意表名称是复数形式, 这是Cake使用的所有表格的默认形式。还有，id、created、updated字段是有特殊含义的，等一会儿你就会发现。也就是说现在你不应该更改他们的名字。

配置Cake的数据库设置


若要配置数据库访问，我们编辑 config/database.php.default (他应该是自己包含说明的), 并将它保存为config/database.php. 如果config/database.php 不存在，Cake仍会运行，并且不使用数据库访问。创建一个模型类 (MVC中的Model)

现在给帖子表格posts创建一个模型类，新建 app/models/post.php包含以下内容 :

app/models/post.php

<?php

class Post extends AppModel
{
}

?>
这已经足以使Cake来关注这个模型了，载入、并把它和数据库表格连接在一起。注意：模型类的类名是单数形式。坚持命名约定十分重要，因为如果不这样，Cake就不会自动运行。默认情况下，模型类和数据库表使用同一个单词而前者以单数形式，后者是复数形式。

建立一个控制器助手类


新建一个控制器助手类。把下面的内容放在app/helpers/posts_helper.php中:

app/helpers/posts_helper.php

<?php

class PostsHelper extends AppController
{
}

?>

创建一个控制器类 (Controller)

新建一个控制器类. 把下面的内容放在app/controllers/posts_controller.php中:

app/controllers/posts_controller.php

<?php

class PostsController extends PostsHelper
{
}

?>
控制器已经准备好了，这是我们需要在他里面添上行为（Action）来对存储的数据进行操作。添加一个方法到 PostsController 类中 :

app/controllers/posts_controller.php

<?php

class PostsController extends PostsHelper
{
        function index()
        {
        }
}

?>
PostsController::index() 不需要其他内容了，除了需要一个模版（在Cake中称之为视图“View”）。

建立一个视图 (View)



把下面的代码放入app/views/posts/index.thtml:

<h1>Blog posts</h1>
<table>
        <tr>
                <th>Id</th>
                <th>Title</th>
                <th>Created</th>
        </tr>
        <?php foreach ($this->models['post']->findAll() as $post): ?>
        <tr>
               <td><?php echo $post['id']?></td>
               <td>
                       <?php echo $html->linkTo($post['title'], "/posts/view/{$post['id']}")?>
               </td>
               <td><?php echo $post['created']?></td>
        </tr>
        <?php endforeach; ?>
</table>
这应该可以正确运行，我们来测试一下。我假设你可以通过浏览http://localhost/cake/ 来得到Cake目录，这样测试一下我们的新控制器，它指向http://localhost/cake/posts/index 。你会（希望如此）看到类似于下面的一些东西：

Blog posts

ID          Title                          Created
1         The title                 2005-07-03 10:52:21
2         A title once again         2005-07-03 10:52:34
3         Title strikes back         2005-07-03 10:52:43

为什么我没看到呢？


如果你遇到了一个页面，上面说“not Found: The requested URL /posts/index was not found on this server,”你可能要使用 http://localhost/cake/index.php?url=posts 来访问 . 很明显，这很不美观。如果你遇到了一个页面上说“Fatal error: Call to a member function on a non-object ...”那么你可能要检查一下你的配置内容，有没有把config/database.php.default 改名为config/database.php. 参见 Blog指南中的故障及解决方法。

我们现在做了些什么？

让我们回顾一下。我们创建了数据库表posts，一个模型类Post，一个控制器PostsController 和他的index()方法，还有一个视图文件app/views/posts/index.thtml。我觉得他一点也不困难。让我们继续吧。

帖子标题是连接到/cake/posts/view/[post_id]的. 让我们点击它。

Missing action

You are seeing this error because the action is not defined in controller Posts
Notice: this error is being rendered by the app/views/errors/missing_action.thtml view file,
a user-customizable error page for handling invalid action dispatches.
Error: Unable to execute action on Posts
噢~，对了，我们忘记添加PostsController::view()行为了。让我们现在完成它：

app/controllers/posts_controller.php

<?php

class PostsController extends PostsHelper
{
        function index()
        {
        }

        function view($id)
        {
               $this->models['post']->setId($id);
               $this->set('data', $this->models['post']->read());
        }
}

?>
还有视图文件：

app/views/posts/view.thtml

<h1><?php echo $data['title']?></h1>
<p><small>Created: <?php echo $data['created']?></small></p>
<p><?php echo $data['body']?></p>
回到浏览器，刷新，看到：

The title

Created: 2005-07-04 03:31:47

This is the post body.
成功了！

添加功能

在指南的第一部分之后，我们有了一个帖子的列表，同时我们可以查看帖子了。当我们完成了第二部分，我们可以：

添加一个新的帖子。
删除不要的帖子。
编辑存在的帖子。