CakePHP2.xCookBook中文版第三章入门

获得 Cake

首先让我们取得一份新鲜的 Cake 代码的拷贝。

要得到新鲜的下载，访问 Github 上的 CakePHP 项目： http://github.com/cakephp/cakephp/downloads 并且下载 2.0 的最新版本。

也可以使用 git 克隆代码仓库： git。

1 git clone git://github.com/cakephp/cakephp.git

/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());

更多的信息参见 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 );

可选的配置

另外还有三项配置。许多开发人员完成了长长的列表项，但是它们不包含在本教程中。一是定义一个自定义字符串（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!');

1 /** 2  * A random numeric string (digits only) used to encrypt/decrypt strings. 3 */ 4 Configure::write('Security.cipherSeed', '7485712659625147843639846751');

1 $ chown -R www-data app/tmp

mod_rewrite 说明

偶尔有用户会遇到 mod_rewrite 方面的问题，所以我们在这做个简要说明。如果 CakePHP 欢迎页面有点儿可笑（没有图片或 CSS 样式），意味着系统中缺少 mod_rewrite 功能。有一些对正确运行有帮助的提示： :

确定 .htaccess 覆盖是被允许的：在 httpd.conf 中每个目录有一个节定义这条规则。确认是在正确的目录中把AllowOverride 设置 All。出于安全和执行方面的原因，不要在  /> 中把 AllowOverride 设置为All。替代方案是寻找指向所用 web 站点目录的  块。

1. 确定 .htaccess 覆盖是被允许的：在 httpd.conf 中每个目录有一个节定义这条规则。确认是在正确的目录中把AllowOverride 设置 All。出于安全和执行方面的原因，不要在  /> 中把 AllowOverride 设置为All。替代方案是寻找指向所用 web 站点目录的  块。

2. 确认编辑了正确的 httpd.conf，而不是某个用户或特别站点的 httpd.conf。

3. 有些情况下，可能拿到的是一个不带 .htaccess 文件的 CakePHP 副本。出现这种情况的原因是由于一些操作系统隐藏（不显示）以 . 开头的文件，以致拷贝时没有拷贝这个文件。确保 CakePHP 的副本来自下载一节的站点或 git 仓库。

4. 确认 Apache 正确的加载了 mod_rewrite。应该可以在 httpd.conf 中看到如下的内容：:

   1 LoadModule rewrite_module             libexec/httpd/mod_rewrite.so

   或者（在 Apache 1.3）中

   1 AddModule             mod_rewrite.c

    

1 Configure::write('App.baseUrl', env('SCRIPT_NAME'));

/.htaccess /app/.htaccess /app/webroot/.htaccess

如果 CakePHP 安装在 Apache 以外的 web 服务器上，可以在 高级安装 一节找到工作在 URL 重写机制下的介绍。

接下来的 博客课程 —— 加入一个层，将开始第一个 CakePHP 应用程序。

建立 Post 模型

模型（model）类是 CakePHP 应用程序的面包和奶油。通过建立与数据库结合的模型类，我们就有了随后放置所需的显示、添加、编辑和删除操作的基础。

CakePHP 的模型类放在 /app/Model 文件夹，我们建立的文件将被存为 /app/Model/Post.php。完整的文件类似于：

1 class Post extends AppModel { 2 }

关于模型的更多信息，诸如表前缀、回调和数据校验，请参阅手册中 模型 一章。

建立 Posts 控制器

接着我们为贴子建立一个控制器。这个控制器是发生贴子交互的地方。简单地说，它就是完成运行模型和获得贴子相关工作的地方。我们将在 /app/Controller 目录的 PostsController.php 文件中放置一个控制器类。类的基本内容类似于：

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

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 }

上例中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 )

 1   2  3 Blog posts  4  5 6 7 8 910111213foreach ($postsas$post): ?> 141516202122endforeach; ?> 23unset($post); ?> 24
  
  
Id
  
Title
  
Created
  
         
  
echo $post['Post']['id']; ?>
  
 17 echo $this->Html->link($post['Post']['title'], 18 array('controller' => 'posts', 'action' => 'view', $post['Post']['id'])); ?> 19 
  
echo $post['Post']['created']; ?>
  
    

你可能已经注意到例子中所用的那个调用 $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 }

还要注意，我们的视图 action 获取了一个参数: 我们希望看到的帖子的 ID。 这个参数是通过 URL 请求传递给 action 的。 如果用户请求 /posts/view/3，那么值 ‘3’ 就被传递给 $id。

现在让我们建立一个新的 ‘view’ action 放在 /app/View/Posts/view.ctp 文件中。

1  2 3 echo h($post['Post']['title']); ?> 4 5 
Created: echo $post['Post']['created']; ?>
 6 7 
echo h($post['Post']['body']); ?>

添加帖子

虽然从数据库中读出贴子并展示给我们是个不错的开始，但是我们还需要可以添加贴子。

首先，从在 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 }

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 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 ?>

1 

$this->Form->input() 方法用来生成同名的表单元素，这个方法的第一个参数告诉 CakePHP 前后台通讯的是哪个域，第二个参数允许指定选项：本例中，是 textarea 域的行数。这里有一点自动完成的：input() 方法将基于 model 指定的域生成不同的表单元素。

$this->Form->end() 调用生成一个 submit 元素并结束表单。如果提供给 end() 方法的第一个参数是字符串，FormHelper 生成一个相应名称的 submit 域并关闭表单标签。再说一次， 助手 一节有更多的助手信息。

现在我们返回并更新 /app/View/Posts/index.ctp 视图使其包含一个新的 “Add Post” 链接。在 

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

 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 }

现在已经有了校验规则，试着输入空的 title 和 body，看看它们是如何工作的。当我们使用 FormHelper 的FormHelper::input() 方法创建表单，校验的错误信息会自动显示。

农村小姑娘0

这个家伙很懒，什么也没留下！

Tags | 热门标签

• command
• timestamp
• solr
• emoji
• vba
• object
• httpclient
• less
• bytecode
• typescript
• chat
• settings
• text
• byte
• python2
• install
• include
• match
• plugins
• frameworks
• php8
• web3
• const
• ip
• loops
• utf-8
• blob
• shell
• header
• sum

RankList | 热门文章

• 1开发笔记:MySQL 有关锁的简单介绍
• 2针对Web应用的【攻击模式篇】
• 3开发笔记:为什么程序员都不写文档？
• 4shell写的俄罗斯方块游戏
• 5使用CloudFlare来做301跳转
• 6eclipse无法运行 ，报错：the selection cannot be launched
• 7d我想要动态模板虚
• 8Detecting chip type... Unsupported detection protocol, switching and trying
• 9如何在Yii Framework中使用PHPExcel组件【备忘】
• 10看电影买票下载什么软件最好（公认最好的4个抢票app）
• 11BIEE dashboard的文件夹内容左右联动
• 12JavaScript和OOP
• 13打印 N 阶上赫森伯格矩阵
• 14SQL Server 2005 Express 远程访问设置方法 (转)
• 15HTTP和HTTPS的区别，你知道吗？

PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有