Put Down The Burden Of Love, Pay All My Life Passion Into Coding

AquarTutorial 第一期
-CakePHP自学笔记

（一）：利用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类似，不再赘述。

AquarTutorial 第一期
-CakePHP自学笔记

（一）：利用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是控制器的回调函数，它在任何函数被执行前执行。

从最简单版本开始
持续叠代（always beta）
Eat your own dog food

-from Felix Ding

AquarTutorial 第一期
-CakePHP自学笔记

（一）：利用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给这个网站添加一个功能。

AquarTutorial 第一期
-CakePHP自学笔记

>>（一）：利用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命令退出终端了。