（一）：利用Ubuntu搭建开发环境
（二）：数据库配置与连接
（三）：MVC开发模式简介
（四）：CakePHP的命名规范
（五）：Cake中的MVC开发
>>（六）：模型的构建和关联

<-<-<-<-<-<-<-<-<-<-<-<-<-

“重构”的代价

直到想起来有这玩意才发现自己有多笨。。。所以郁闷了好几天没看，alpha版本里面也没有用到模型的关联，今天实在无聊的要命，就读了一下，然后改了DarkBook的代码，重新组织了数据的结构，麻烦不说，我还是搞不明白为什么都声明了'foreignKey' => 'owner'了，Cake还是返回没有User模型没有id的错误。God Damn It！！看来Cake习惯了每个模型都有个id当主键。>_<||。。。

所以刚才从数据库改起，模型、控制器、视图全有改动，幸亏DarkBook只有两个控制器，要不我肯定疯掉了——这就是不读完教程就乱写的后果。。。

四种关联

CakePHP提供了四种类型的关联：hasOne、hasMany、belongsTo和hasAndBelongsToMany。四者分别对应模型中一个同名的变量。

声明了模型之间的关联之后，我们（在一般情况下）就不需要在控制器中引入$uses变量来接收其他模型的数据了。比如在模型中我们可以用 $this->SomeOtherModel->someFunction() 来控制其他模型，或者在控制器中用 $this->SomeModel->SomeOtherModel->someFunction() 来控制其他模型。

hasOne

hasOne即“有一个”，比如一个User应该有一个Profile。那么我们就简单地这样声明：

<?php
class User extends AppModel {
    var $name = 'User';
    var $hasOne = 'Profile';
}
?>

注意，Cake需要外键（foreign key）来实现关联（跟我的方法差不多么。。。），hasOne需要在对应的模型（本例中的Profile）中包含外键，Cake默认的外键名称是原模型小写外加“_id”，本例中就是user_id。当然了，我们可以更改这个外键的值 ，hasOne还有其他的一些参数可以修改，列举如下：

• className 即关联到当前模型的模型类名。本例中就是Profile。
• foreignKey 在被关联模型中外键的名称，默认值就是当前模型类名小写后加“_id”。
• conditions 一条SQL语句用以过滤返回的关联模型。最好在语句中加上类名，比如"Profile.approved = 1"总是比"approved = 1"好的多。
• fields 获取关联模型数据时返回的字段列表。默认情况下返回全部。
• order 一条SQL语句用以定义返回的关联数据的排序。
• dependent 当这个值设置为true的时候，一旦对当前模型的某个记录调用了delete()函数并且参数cascade也设置成true，那么关联的模型记录也会被删除。本例中就是删除一个User也会删除关联给他的Profile。

可以用如下形式来设置这些参数的值（其他关联都类似）：

<?php
class User extends AppModel {
    var $name = 'User';          
    var $hasOne = array(
        'Profile' => array(
            'className'    => 'Profile',
            'conditions'   => array('Profile.published' => '1'),
            'dependent'    => true
        )
    );    
}
?>

在控制器中用类似 $this->set('data', $this->User->find('all')) 之类的函数传递数据给视图后，我们在视图中就可以十分方便的调用各个模型了。
返回的结果类似这样：

//Sample results from a $this->User->find() call.
 
Array
(
    [User] => Array
        (
            [id] => 121
            [name] => Gwoo the Kungwoo
            [created] => 2007-05-01 10:31:01
        )
    [Profile] => Array
        (
            [id] => 12
            [user_id] => 121
            [skill] => Baking Cakes
            [created] => 2007-05-01 10:31:01
        )
)

那么我们在视图中要用User的name字段的值，就可以 $data['User']['name']，要引用Profile的skill字段的值，就可以 $data['Profile']['skill']。

belongsTo

用hasOne我们已经可以从User的模型和控制器中获取Profile的数据了，相反地，我们可以设置belongsTo从Profile中获取所属User的数据。如下声明：

<?php
class Profile extends AppModel {
    var $name = 'Profile';
    var $belongsTo = 'User';
}
?>

与hasOne不同的是，belongsTo要求在当前模型中有外键。这个外键默认是belongsTo关联的模型的类名小写再加“_id”的后缀。这个关联与hasOne有很多相同的参数，包括className、foreignKey、conditions、fields和order，此外还有一下两个参数：

• counterCache 把这个参数设为true会导致关联模型的一个计数字段自动更改。这个计数字段的默认名是当前模型的类名小写加上“_count”后缀，在调用save()或者delete()时这个计数值就会变化。如果在这里添一个字符串，那么就把它作为计数字段的名称。
• counterScope 可选的条件用于确认计数字段的更新。

同hasOne类似，控制器传递给视图的数组类似下面：

//Sample results from a $this->Profile->find() call.
 
Array
(
   [Profile] => Array
        (
            [id] => 12
            [user_id] => 121
            [skill] => Baking Cakes
            [created] => 2007-05-01 10:31:01
        )    
    [User] => Array
        (
            [id] => 121
            [name] => Gwoo the Kungwoo
            [created] => 2007-05-01 10:31:01
        )
)

hasMany

下面来定义一个User有很多Comment的关联，用hasMany就可以做到在获取User数据的同时得到这个用户所写的评论。同hasOne类似的是外键要放在相关联的模型中。声明hasMany的方法不再赘述。

hasMany在hasOne的基础上还多了如下这些参数：

• limit 用这个设置返回的记录的最大数量。
• offset 获取关联数据前（在给定的conditions和order下）跳过的记录数量。
• exclusive 当这个值设置为true的时候，模型的递归删除会调用deleteAll()函数而不是一个一个删除。这样能极大提升效率，但并不一定适合所有情况。
• finderQuery 一条完整的SQL语句，CakePHP用来获取关联的数据。只在需要自己定义完全不同的功能时才需要。

控制器传递的数组像这样：

//Sample results from a $this->User->find() call.
 
Array
(  
    [User] => Array
        (
            [id] => 121
            [name] => Gwoo the Kungwoo
            [created] => 2007-05-01 10:31:01
        )
    [Comment] => Array
        (
            [0] => Array
                (
                    [id] => 123
                    [user_id] => 121
                    [title] => On Gwoo the Kungwoo
                    [body] => The Kungwooness is not so Gwooish
                    [created] => 2006-05-01 10:31:01
                )
            [1] => Array
                (
                    [id] => 124
                    [user_id] => 121
                    [title] => More on Gwoo
                    [body] => But what of the ‘Nut?
                    [created] => 2006-05-01 10:41:01
                )
        )
)

所以引用Comment时要注意用 $data['Comment'][1]等等，也可以 foreach $data['Comment'] as $single_comment 之类的。

hasAndBelongsToMany

最后这个有点不同，比如一个Post就“有并且属于很多”Tag，而HABTM和hasMany（用上面那个做例子）的区别就在于每个Comment被一个User拥有了之后，就不能再被别的User拥有了，而一个Tag属于一个Post之后还可以给其他的Post添加。

HABTM也不仅仅需要在当前模型或关联模型中的外键，它需要一个单独的包括两个模型名字的数据表，这个例子中相应的表就应该是posts_tags，一般需要3个字段——id、post_id、tags_id（哎，在Cake里写程序就记得每个表都来个id当主键，再设置成自动增长省的闹心。。。），HABTM有很多参数：

• className 关联的模型类名。
• joinTable 可以用这个参数设置关联表的名字。
• with 这里添的是关联表对应的模型名称。默认情况下CakePHP会自动创建一个模型。本例中默认的就叫做PostsTag。这个关联表也可以像普通的模型一样使用。
• foreignKey 当前模型中的外键值。在定义多个HABTM关联时会用到。默认值是当前模型类名小写加“_id”后缀。
• associationForeignKey 关联模型中的外键值。在定义多个HABTM关联时会用到。默认值是关联模型的类名小写加“_id”后缀。
• unique 如果设置为true（默认值），Cake会在添加新关联时删除已有的关联。（暂时不能理解透彻）
• conditions fields order limit offset 和hasMany一样。
• finderQuery deleteQuery insertQuery 分别可以添一条完整的SQL语句在获取、删除和添加关联的模型记录时使用。同样只在需要自定义的时候使用。

还是看看怎么声明HABTM关联：

<?php
 
class Post extends AppModel {
    var $name = 'Post';   
    var $hasAndBelongsToMany = array(
        'Tag' =>
            array(
                'className'              => 'Tag',
                'joinTable'              => 'recipes_tags',
                'foreignKey'             => 'recipe_id',
                'associationForeignKey'  => 'tag_id',
                'unique'                 => true,
                'conditions'             => '',
                'fields'                 => '',
                'order'                  => '',
                'limit'                  => '',
                'offset'                 => '',
                'finderQuery'            => '',
                'deleteQuery'            => '',
                'insertQuery'            => ''
            )
    );
}
?>

控制器传递给视图的数组同hasMany类似，不再赘述。

点此下载。

安装指南参考CakePHP的官方手册。如果按dev模式安装的话直接解压就好了，然后在phpMyAdmin中导入压缩包中的darkbook.sql，然后向数据库中添加拥有全部权限的用户并更改app/config/database.php中相关的内容。

（一）：利用Ubuntu搭建开发环境
（二）：数据库配置与连接
（三）：MVC开发模式简介
（四）：CakePHP的命名规范
>>（五）：Cake中的MVC开发

<-<-<-<-<-<-<-<-<-<-<-<-<-

行为、组件、助手

或许你已经听过很多遍那句经典的“不要重复发明轮子”了，同样，为了提高代码重用，Cake提供了Behavior（行为）、Component（组件）、Helper（助手），分别作为Model（模型）、Controller（控制器）、View（视图）的“扩展”。说白了，就跟C的标准库一样，想使用行为、组件或助手的功能，只要声明一下就OK了。

我目前比较常用的核心组件是Auth（认证系统），助手有Form（表格）、Session（会话控制）、html（快速创建html标签）等。

使用扩展

前面说过，要使用扩展，只要在模型、控制器中声明就可以了（核心助手不用声明）。示例代码：

<?php
class ExampleController extends AppController {
	var $components = array('Auth');
} 
?>

在模型中使用行为与此类似。

有时候，像Auth认证系统这样的组件是整站都需要的，我们可以在app/app_controller.php文件中向AppController类中引入Auth，这样所有继承自AppController的控制器也都有Auth了。也就是：

<?php
class AppController extends Controller {
	var $components = array('Auth');
} 
?>

回调函数

这个名词具体是什么意思我还不很明白。跟某陈小讨论了一下，他给我两个网址（CN、EN）我还没仔细看，不过wiki上那个图片是让我懂了它为什么叫这个名字，回调的意思就是主程序调用一个库函数（级别不同），而此库函数调用了一个和主程序同样级别的函数，也即“回调”。总之呢，我现在也只用一个Callback Function就是beforeFilter()。

回调函数可以用来设置一些配置选项，或者在页面跳转之前执行某些动作。

比如我用beforeFilter来设置Auth的一些参数：

function beforeFilter() {
    $this->Auth->allow('login', 'add', 'view', 'index');
    $this->Auth->loginRedirect = array('action' => 'home');
}

这里beforeFilter是控制器的回调函数，它在任何函数被执行前执行。

P.S.CakePHP加速后的开发确实速度惊人。。。

DarkBook这个名字来源于燕仰的那句“感谢上帝给我书籍和黑夜”。

我在这个完全用于内测的版本中实现了：

• 用户注册、登录和登出。
• 个人图书馆管理页面。
• 添加图书。
• 查看他人图书馆。
• 列出全部用户的页面。

为了达到alpha版本，还需要努力改进的地方有：

• 网页的布局、CSS等。
• 图书的阅读状态。
• 编写安装手册。
• 本地化与国际化。
• 用Git或SVN发布。

有新点子了也会及时加入到这个系统中。

DarkBook: Thank God for giving me Darkness and Book.

-from Felix Ding

（一）：利用Ubuntu搭建开发环境
（二）：数据库配置与连接
（三）：MVC开发模式简介
>>（四）：CakePHP的命名规范

<-<-<-<-<-<-<-<-<-<-<-<-<-

基本的命名规则

上篇笔记中我们刚刚对MVC开发模式有了一个简单的认识，在进行开发之前，我们首先要熟悉CakePHP的一些命名规范，所谓命名规范也就是数据表、模型文件、模型、控制器文件、控制器、视图文件等的命名的一些规范，注意这是规范不是规定，即并不是必须的，但遵循默认的命名规范能大大加快开发速度，并减少不必要的麻烦。

比如你要给程序添加一系列关于物品(item)的功能，比如查看、购买等等，你最好：

1. 用items命名数据表；
2. 用item.php命名模型文件，放在app/models目录下，用Item命名我们的模型（见下文）；
3. 用items_controller.php命名控制器文件，放在app/controllers目录下，用Items命名我们的控制器
4. 在app/views目录下建立items子目录

注意有几处单复数的差别。

示范代码

终于到动手写写代码的时候了，首先打开app/models/item.php添加如下代码：

<?php
class Item extends AppModel{
	var $name = 'Item';
}
?>

然后继续修改app/controllers/items_controller.php。

<?php
class ItemsController extends AppController {
    var $name = 'Items';
?>

这样就完成了最基本的模型和控制器，我们所写的模型都继承AppModel类，而AppModel类又继承Model类，同样，程序中的控制器都继承AppController类，后者又继承Controller类，此处Model类和Controller类都由CakePHP的内核提供。我们可以更改AppController类，比如增加Auth组件，这样程序的所有控制器都会默认加载这个组件。

注意我们并没有为模型指明具体的数据表，也没有为控制器指明要使用的模型，这就是CakePHP命名规范的作用：默认情况下，单数命名的模型会自动调用复数命名的数据表（比如Item这个模型就会默认与items这个数据表交互），复数命名的控制器会自动调用单数命名的模型（所以ItemsController会默认调用Item这个模型），最后视图会自动接受控制器的相应函数返回的数据，马上就来实现一个视图。

函数和视图

一个控制器可能有很多函数，而每个函数都有相对应的视图，所以我们要在控制器对应的视图目录下以函数名添加视图。这里插一句CakePHP构造链接的方法，比如这个items控制器有个buy函数来实现购买功能，这时如果CakePHP的程序所在的目录是http://www.example.com/cake，那么这个buy函数对应的视图渲染的页面就是http://www.example.com/cake/items/buy，而如果我们访问http://www.example.com/cake/items，即直接访问这个控制器，Cake会默认返回index函数及其视图。

下面我们为Items这个控制器添加index函数，简单地返回所有items数据表中的条目。修改app/controllers/items_controller.php。

<?php
class ItemsController extends AppController {
    var $name = 'Items';
    function index() {
        $this->set('items',$this->Item->find('all'));
    }
?>

这里set函数就是用来从控制器向视图传递数据的，它会以数组的形式传递数据。具体可以看这个页面。

然后我们创建app/views/items/index.ctp文件并添加如下内容：

<h1>Show Items</h1>
 
<table>
	<tr>
		<th>Id</th>
		<th>Name</th>
	</tr>
 
	<?php foreach ($items as $item): ?>
	<tr>
		<td><?php echo $item['Item']['id']; ?></td>
		<td><?php echo $item['Item']['name']; ?></td>
	</tr>
	<?php endforeach; ?>
 
</table>

在数据表中添加一些数据（此处我们假定只展示数据表中id和name两项），然后访问http://localhost/caketest/items就能看到一个展示items数据的表格。

P.S.对于多词组的名字，命名规范如下：

• 数据表名：user_profiles；
• 模型名：UserProfile，模型文件名：user_profile.php；
• 控制器名：UserProfilesController，控制器文件名：user_profiles_controller.php
• 视图文件目录：user_profiles

（一）：利用Ubuntu搭建开发环境
（二）：数据库配置与连接
>>（三）：MVC开发模式简介

<-<-<-<-<-<-<-<-<-<-<-<-<-

关于MVC

CakePHP遵循MVC开发模式，所谓MVC也就是Model-View-Controller的首字母缩写，MVC开发模式把应用程序开发分成三个部分，Model即模型用于管理数据，View即视图用来制作用户界面，而Controller即控制器管理应用程序的逻辑。下图演示采用MVC开发的程序如何响应用户的请求：

MVC请求演示

MVC的优点在于添加或移除系统组件很方便，可以说是一种迭代式开发，这样做成的系统扩展性很强，组件的重用性也很好。引述CakePHP手册:

为什么要用 MVC模式 呢? 因为它是一个经过考验的真正的软件设计模型，它可以使程序成为可维护的、模块化的和快速开发的包。使用分离的模型(Model)、视图(View)和控制器(Controller)组织的程序是轻便的。新的特性很容易就被加入，旧的程序换上新的外观也是一下子的功夫。模块化和分离的设计使得开发者和设计者能够同时工作，这包括了快速 原型的能力。分离的设计令开发者可以修改应用的一部分而不会影响到其他部分。

如果你从来没有用过这种方法建立应用，适应它需要一些努力，但是我们相信一旦你使用CakePHP建立了你的第一个应用，你不会再想用其他方法建立你的应用了。

MVC下的快速开发

一般来说，要给CakePHP程序添加新的功能需要如下几步：

1. 在数据库中新建一个数据表；
2. 在app/models目录下新建一个Model文件；
3. 在app/controllers目录下新建一个Controller文件；
4. 在app/views目录下新建一个目录，在该目录中针对Controller中的每个函数新建一个View文件。

这样就已经把全新的功能添加到了CakePHP中，当然，你可能还需要修改其他的MVC以便整合。

接下来说说CakePHP的一些命名规范，之后再用MVC给这个网站添加一个功能。

（一）：利用Ubuntu搭建开发环境
>>（二）：数据库配置与连接

<-<-<-<-<-<-<-<-<-<-<-<-<-

建立数据库、数据表

我们用phpMyAdmin管理数据库，用浏览器打开 http://localhost/phpmyadmin 用户名输入root，密码就是安装phpMyAdmin时设置的密码。

登录后，新建一个数据库，比如cakedb，同时注意选择字符集。建立数据库后，默认会赋予root用户全部权限。

打开cakedb数据库，你可以很方便地添加数据表，字段等等。

连接到数据库

然后我们要让Cake和刚刚建立的数据库连接起来，这项工作只需要我们更改app/config里面的一个配置文件，进入/var/www/caketest目录，你可以把这个目录添加到自己的书签里方便以后访问，在app/config/目录中新建database.php文件并用gedit打开，我们只要修改从81行（要查看行号，可以在编辑->首选项里面打开“显示行号”）开始的几行配置：

81
82
83
84
85
86
87
88
89
90

	var $default = array(
		'driver' => 'mysql',
		'persistent' => false,
		'host' => 'localhost',
		'login' => 'root',
		'password' => 'somepassword',
		'database' => 'cakedb',
                'encoding' => 'utf8',
		'prefix' => '',
	);

其中，login和password分别添有数据库全部权限的用户的用户名和密码，database添数据库的名称，encoding是需要手动写上去的，强制用utf8编码。改好后保存，刷新 http://localhost/caketest 页面，应该是下面这样：

Database Connected

P.S.注意这个页面中有提示
Notice (1024): Please change the value of 'Security.salt' in app/config/core.php to a salt value specific to your application [CORE/cake/libs/debugger.php, line 549]
这是要你去改app/config/core.php中的'Security.salt'值（在第151行），这个值是Cake用来算Hash时（比如验证密码等）需要用到的，为了安全一定要设置一个不容易猜到的字符串。

>>（一）：利用Ubuntu搭建开发环境

<-<-<-<-<-<-<-<-<-<-<-<-<-

安装Ubuntu系统

首先，到Ubuntu官方网站下载最新版的Ubuntu Desktop LiveCD，如果速度慢也可以到网易或者搜狐的开源镜像站点去下载。然后把镜像刻录到一张空的CD盘上面。

[Choice 1]你可以直接在Windows里面安装一个Ubuntu系统，优点：安装卸载方便，缺点：速度稍慢。推荐没用过Linux的同学用这种方法装。
[Choice 2]重启电脑，从光驱引导，安装Ubuntu系统，优点：完全释放系统资源，缺点：不适合新手。

安装完系统后，可以调整一些设置，详细的教程以后再写。

安装LAMP服务器

所谓LAMP Server也就是Linux操作系统+Apache服务器+MySQL数据库+PHP（以前也指Perl，现在貌似都是PHP了），在Ubuntu中安装LAMP简单至极，这也是选择Ubuntu进行开发的一个原因。

首先，你需要打开一个终端，即应用程序->附件->终端（英文系统里是Application->Accessories->Terminal），也就是所谓的壳（Shell）。然后输入下面的命令：

sudo -i

然后输入你登录时的密码，按回车应该出现root@的字样就说明你已经获得了根用户（root）的权限，在这种模式下你可以安装软件、更新系统、调整系统级的配置等等，下面我们开始安装LAMP服务器，执行：

tasksel

会出现一个蓝色的页面，用上下箭头改变高亮条的位置，调整到LAMP Server的选项上面按空格，然后按Tab键切换到OK按钮上按回车，这样Ubuntu系统就会自动安装包括Apache，MySQL和PHP等一系列程序，安装时MySQL会让你设置管理员（也叫root）密码，还有一次是确认密码，这个密码要记牢，管理数据库时要用到。

此时我们的服务器已经安装完成。你可以用任意浏览器访问 http://localhost 这个网址如果出现一个It works!样子的网站就说明一切OK了。附图演示：

Apache Works

接下来，我们安装phpMyAdmin这个MySQL数据库管理软件，有了它你就可以很方便地管理数据库，继续在终端里执行：

apt-get install phpmyadmin

安装时会有配置选项，用空格选择apache2然后按Tab点OK，装完后会询问是否允许建立数据库，选Yes并输入数据库管理员的密码，随后会设置phpMyAdmin的密码，这个也要记住。

最后，我们需要修改Apache的一些配置以便让Cake能正常运行，继续执行（每次一行，第二条命令中可以使用Tab键自动补齐功能）：

a2enmod rewrite
gedit /etc/apache2/sites-enabled/000-default

会打开一个文字编辑器，把和里面的AllowOverride 后面的None改成All。保存并关闭gedit。

重启Apache服务器，加载新配置：

/etc/init.d/apache2 restart

P.S.不要退出终端

部署CakePHP的开发环境

首先到Cake的官方网站下载其代码，这份笔记基于1.2.6版本，写这份笔记的时候下载地址是这个。

下载后解压到桌面，重命名一下，下面以caketest为例继续，回到我们的终端，执行：

cp -R /home/你的用户名/Desktop/caketest /var/www
chmod 777 -R /var/www

这样我们已经完成了CakePHP开发模式的部署，注意不要改动caketest目录下cake里面的文件，那里是CakePHP的核心文件。我们的第一个Cake程序将在app子目录下面开始。

用浏览器打开 http://localhost/caketest 或者你起的随便什么名字（比如diablo）。应该看到下面这样的网页。

CakePHP Develop Environment Done

现在你可以用两次exit命令退出终端了。

像这里一条Comment就抵过整页教程了。。。

1 - on ubuntu gutsy/hardy

i used this command to enable mod_rewrite

$sudo a2enmod rewrite

then i modified this file

vi /etc/apache2/sites-enabled/000-default

and modified to be AllowOverride All on /var/www dir