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

AquarTutorial 第一期
-CakePHP自学笔记

（一）：利用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

AquarTutorial 第一期
-CakePHP自学笔记

（一）：利用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时（比如验证密码等）需要用到的，为了安全一定要设置一个不容易猜到的字符串。