定义从属关联

1、外键放置在主表中；
2、保存时不会自动更新关联表的记录；
3、删除时也不会更新关联表的记录。

示例：
多个文章都属于某一个栏目。

格式一：

* class Articles
* {
* var $belongsTo = array(
* array(
* ’tableClass’ => ‘Columns’,
* ’foreignKey’ => ‘column_id’,
* ’mappingName’ => ‘column’
* ),
* );
* }

在上面的格式中，foreignKey 表示在当前表中用什么字段存储对关联表的主键引用。
mappingName 表示在主表的返回结果中，以什么名字保存关联表的数据。
如果不提供 mappingName 参数，则假定使用 tableClass。

格式二：

* class Articles
* {
* var $belongsTo = ‘Columns’;
* }

格式二是一种简化写法。foreignKey 字段名将和关联表的主键字段名相同。

============================

$hasMany

定义一对多关联

1、外键保存在关联表中；
2、保存时自动更新关联表的记录；
3、删除主表记录时自动删除关联记录。

示例：
每个用户（user）有多张订单 order。

格式一：

* class Users
* {
* var $hasMany = array(
* array(
* ’tableClass’ => ‘Orders’,
* ’foreignKey’ => ‘user_id’,
* ’mappingName’ => ‘orders’,
* ),
* );
* }

在一对多关系中，当前表并不包含对关联表的主键引用。
而是在关联表中保存对当前表的主键引用。
在上面的格式中，foreignKey 指示在关联表中用什么字段存储对当前表的主键引用。
mappingName 表示在主表的返回结果中，以什么名字保存关联表的数据。
如果不提供 mappingName 参数，则假定使用 tableClass。

格式二：

* class Users
* {
* var $hasMany = ‘Orders’;
* }

简化写法中，foreignKey 字段名将和当前表的主键字段名相同。

============================

$hasOne

定义一对一关联
1、外键放置在关联表中；
2、保存时如果有关联对象，则自动创建或更新关联表的记录；
3、删除主表记录时自动删除关联记录。

示例：
当前表为 users，用于存储用户账户。而每个用户账户有且只有一个对应的个人信息（profile）记录。

格式一：

* class Users
* {
* var $hasOne = array(
* array(
* ’tableClass’ => ‘Profiles’,
* ’foreignKey’ => ‘profile_id’,
* ’mappingName’ => ‘profile’,
* ),
* );
* }

在上面的格式中，foreignKey 表示在关联表中用什么字段存储对主表的主键引用。 mappingName 表示在主表的返回结果中，以什么名字保存关联表的数据。 如果不提供 mappingName 参数，则假定使用 tableClass。

格式二：

* class Users
* {
* var $hasOne = ‘Profiles’;
* }

格式二是一种简化写法。foreignKey 字段名将和主表的主键字段名名相同。

============================

$manyToMany

定义多对多关联

1、外键保存在中间表里面；
2、保存时自动更新中间表；
3、删除主表记录时自动删除中间表的相关记录。

示例：
每个成员（member）可以拥有多个角色（role），而每个角色也可以指定给多个成员。

格式一：

* class Members
* {
* var $manyToMany = array(
* array(
* ’tableClass’ => ‘Roles’,
* ’joinTable’ => ‘member_roles’,
* ’foreignKey’ => ‘member_id’,
* ’assocforeignKey’ => ‘role_id’,
* ’mappingName’ => ‘roles’,
* ),
* );
* }

在多对多关系中，当前表并不包含对关联表的主键引用。
而是在一个中间表里面保存对当前表和关联表的主键引用。
在上面的格式中，joinTable 表示中间表的名字。foreignKey 和
assocforeignKey 分别表示在中间表里面用什么字段存储对主表和
关联表主键字段的引用。

mappingName 表示在主表的返回结果中，以什么名字保存关联表的数据。
如果不提供 mappingName 参数，则假定使用 tableClass。

格式二：

* class Members
* {
* var $manyToMany = ‘Roles’;
* }

简化写法中，foreignKey 字段名将和当前表的主键字段名相同。
assocforeignKey字段名称则和关联数据表的主键字段名相同。
而中间表名称将用FLEA_Db_TableDataGateway::getMidtableName() 方法计算。

hasOne 是一对多关联，表示一条主表记录有一条对应的关联记录。
而 belongsTo 是从属关联，表示一条主表记录属于另一条关联记录。

hasOne 和 belongsTo 正好是相反的关系。

例如 “一个用户”有一个“个人空间”。那么一个“个人空间”就属于“一个用户”。

由于 hasOne 实际上是 hasMany （一对多）关联的一种特例，所以 belongsTo 和 hasMany 也是相反的关系。

HAS_ONE： 当前表的每一条记录都拥有最多一条（0–1）关联记录
HAS_MANY： 当前表的每一条记录都拥有多条（0-n）关联记录
MANY_TO_MANY： 当前表的每一条记录都和其他表的多条（0-n）记录关联
BELONGS_TO： 当前表的每一条记录都属于另一个表的某条记录

关联中必须设置的属性为：
‘name’, // 关联的名字（如：hasOne、hasMany）
‘tableClass’, // 关联的表数据入口对象名
‘mappingName’, // 字段映射名

可选属性：
‘foreignKey’, //外键字段名
’sort’, //对关联表进行查询时使用的排序参数
‘conditions’, //对关联表进行查询时使用的条件参数
‘fields’, //对关联表进行查询时要获取的关联表字段
‘limit’, //对关联表进行查询时限制查出的记录数
‘enabled’, //是否处理关联，设置为falses时，不处理该表入口的任何关联。enabled 的优先级高于 linkRead、linkCreate、linkUpdate 和 linkRemove。
‘countOnly’, //指示在查询关联表时是否仅仅统计记录数，而不实际查询数据
‘counterCache’, //将关联记录总数缓存到指定的字段,数据表中要建立相应的字段
‘linkRead’, //指示是否在主表读取记录时也读取该关联对应的关联表的记录,默认ture
‘linkCreate’, //指示是否在主表创建记录时也创建该关联对应的关联表的记录,默认ture
‘linkUpdate’, //指示是否在主表更新记录时也更新该关联对应的关联表的记录,默认ture
‘linkRemove’, //指示是否在主表删除记录时也删除该关联对应的关联表的记录,默认ture
‘linkRemoveFillValue’, //当删除主表记录而不删除关联表记录时，用什么值填充关联表记录的外键字段,默认0
’saveAssocMethod’, //指示当保存关联数据时，采用何种方法，默认为 save，可以设置为 create、update 或 replacevar $belongsTo = array(
‘tableClass’ => ‘Table_Users’,
‘mappingName’ => ‘author’,
‘foreignKey’ => ‘user_id’
);

var $hasOne = array(
‘tableClass’ => ‘Table_Profiles’,
‘mappingName’ => ‘profiles’,
‘foreignKey’ => ‘user_id’,
’saveAssocMethod’=> ’save’
);

var $hasMany = array(
‘tableClass’ => ‘Table_Profiles’,
‘mappingName’ => ‘profiles’,
‘foreignKey’ => ‘user_id’,
’saveAssocMethod’=> ’save’
);

var $manyToMany=array(

);

一个表可以有多个关联
var $hasMany = array(
array(
‘tableClass’ => ‘Model_Permissions’,
‘foreignKey’ => ‘pclass_id’,
‘mappingName’ => ‘permissions’,
),
array(
‘tableClass’ => ‘Model_Products’,
‘foreignKey’ => ‘pclass_id’,
‘mappingName’ => ‘products’,
‘enabled’ => false,
),
[
array(
...
),
]
);
关联： 一个关联是一个关系，这个关系属于某一个数据表。例如 users 表可能就拥有一个或者多个关联。
主表： 对于一个关联，拥有该关联的数据表就是主表。例如 posts 表定义了一个 MANY_TO_MANY 关联。
那么在这里（指这个关联），posts 就是主表。

关联表： 在一个关联中，关联表就是除主表外的另一个表。
外键： 在数据库原理中，外键的含义很复杂。但在 FleaPHP 框架中的数据库关联功能中，
外键泛指一个记录中用于关联另一个记录的字段。例如 profile 表中的 user_id 字段就是用于关联 users 表的字段。
这个 user_id 字段就是一个外键。

中间表： 在 MANY_TO_MANY 关联中，除了主表和关联表，还需要另一个表来保存这两个表的记录之间的互相关联关系。
这个表称为中间表。
HAS_ONE 一对一关联
HAS_ONE 是一种非常简单的关联关系。表示一个记录拥有另一个记录。这两个记录分别位于两个数据表中。

示例
在一个信息管理系统中，users 表用于存储用户帐户的基本信息，例如用户名、密码等。
而 profiles 表则用于存储用户的个人信息，例如家庭住址、邮政编码等。

由于每一个用户（一条 users 表中的记录）都有一份对应的个人信息（一条 profiles 表中的记录）。
因此，我们就可以为 users 表定义一个 HAS_ONE 关联。

很明显，users 表的记录拥有一条 profiles 表的记录。因此，当 users 表中的一条记录被删除时，
被删除记录所拥有的 profiles 表中的关联记录也会被自动删除。

表定义
在 HAS_ONE 关联中，要求外键放置在关联表中

分别对应FLEA_Db_TableDataGateway表中的 $hasOne,$hasMany,$manyToMany,$belongsTo 属性

我们下面就用 老师，学生，学生档案，班级的例子说说这几个关系。

以下是SQL代码：

现在，建好表之后，我们还要写几个继承自FLEA_Db_TableDataGateway父类的类，以对应数据库中的Student，Teacher，Classes表（连接表不用了）如下：

以上的代码就建立好了关系了，现在只管使用就是了。
不过还提醒大家一点，在每个关系里，都有一个 ‘enabled’ 的属性，如果设置为 false的话，则是将该关系禁掉，所以查询出来的结果就没有该关系的相应数据，这样可以节省效率，按需要时才打开相应的关联，该属性默认为true 可以如下设置：

现在我们来测试一下数据。（事先自行插入几行数据用以测试）

FleaPHP的数据库查询条件$conditions 参数可以是整数、字符串和数组三种类型：

1.如果 $conditions 参数是一个整数，则假定该整数为主键字段值。
view plaincopy to clipboardprint?
// 查询主键字段值为1的记录
$user = $tableUsers->find(1);

2.如果 $conditions 参数是一个字符串，则该字符串将直接作为查询条件，这种方式可以支持最灵活的查询条件。 例如：
view plaincopy to clipboardprint?
$conditions = 'id < 3'
$user = $tableUsers->find($conditions);
//生成的where字句为“WHERE id < 3”

3.1.如果 $conditions 参数是一个数组，且指定了键名和值，则查询条件中字段名为键名，字段值等于键值。例如：

// 查询id字段值为3的记录
$conditions = array(
'id' => '1',
);
$user = $tableUsers->find($conditions);
//生成的where字句为“WHERE `id` = 1”

3.2.如果 $conditions 参数是一个数组，但其中的元素没有键名， 则假定键值为自定义查询条件，例如：

$conditions = array('id = 1');
// 生成的where字句为“WHERE `id` = 1”
$user = $tableUsers->find($conditions);

3.3.$conditions 为数组时，可以混用字符串和键值对两种风格：

$conditions = array(
'id < 3',
'sex' => 'male',
);
$user = $tableUsers->find($conditions);
// 生成的where字句为“id < 3 AND `sex` = 'male'”
$conditions = array( 'id < 3', 'sex' => 'male',);$user = $tableUsers->find($conditions);// 生成的where字句为“id < 3 AND `sex` = 'male'”
$conditions 为数组时，多个查询条件之间将使用 AND 布尔运算符进行连接。

3.4.“in()”查询在FleaPHP中的实现

我们有时候要用到in这样的操作,那么在condition里面怎么写呢?

// 假如主键名为“id”，需要查询id的值为1、2、3其中之一，则可以这样写：
$condition = array(
'in()' => array(1,2,3),
)

那么如果不是主键的话怎么写了呢? 也很简单，提供键值对即可。例如：
view plaincopy to clipboardprint?
$condition = array(
'in()' => array(
'username' => array('username1','username2')
)
)

3.5 or查询的实现

当 $conditions 包含多个元素时，每一个数组元素都是下列格式的数组：
array(字段名, 值, 比较操作, 连接下一个条件的操作, 是否是自定义命令)如果“是否是自定义命令”为 true，则“字段名”为自定义的查询条件，而“值”和“比较操作”两项将被忽略。
“比较操作”的默认值是“=”；
“连接下一个条件的操作”的默认值是“AND”；
“是否是自定义命令”的默认值是 false。

$conditions = array(
array('username', 'dualface', '=', 'OR'),
array('user_level', 'vip', '>='),
);

生成的 sql 如下

WHERE `username` = 'dualface' OR `user_level` >= 'vip'

实例代码:
$conditions =array(
array('Field1','Value1','LIKE','OR'),
array('Field2','Value2','=','OR'),
array('Field3','Value3','>'),
);

3.6.关联表限制条件

上面介绍的都是相对于主表而言的,那么我们如何来操作关联表的条件呢?我们来看下面
$conditions =array(
array('Field1','Value1','LIKE','OR'),
array('mappingName.Field',$this->primaryKey,'=','OR'), //这里的field是指关联表中的字段 ,mappingName就是定义关联时候那个影像别名
array('Field2','Value2','>'),
);

4.find(),findAll()函数中其它参数的含义和用法如下：
find ( $ conditions,
$ sort = null,
$ fields = '*',
$ queryLinks = true
)
findAll ( $ conditions = null,
$ sort = null,
$ limit = null,
$ fields = '*',
$ queryLinks = true
)

4.1.$sort 参数指定查询时的排序方式，类型只能为字符串
例如 'created ASC' 表示按照“created”字段进行从小到大的排序。

4.2.$fields 参数指定查询结果中要包含哪些字段，类型可以为字符串或数组
当数据表的字段很多时，通过指定 $fields 参数可以避免查询不需要的字段，从而提高性能。
$fields 参数即可是以“,”逗号分隔的字段名，也可以是包含多个字段名的数组，例如：

$fields = array('title', 'created');
//也可以写成下面的字符串形式，两种写法作用相同，区别在于自动生成的字段名两边将会添加上“`”符号，以防止出现字段名与SQL关键字冲突的情况出现。建议手写时也加上“`”字符
$fields = 'title, created';
$user = $tableUsers->find('id < 10',NULL,$fields);
$fields = array('title', 'created');//也可以写成下面的字符串形式，两种写法作用相同，区别在于自动生成的字段名两边将会添加上“`”符号，以防止出现字段名与SQL关键字冲突的情况出现。建议手写时也加上“`”字符$fields = 'title, created';$user = $tableUsers->find('id < 10',NULL,$fields);
推荐使用数组，这样表数据入口处理起来更快一些。

4.3.$queryLinks表示是否启用关联查询，默认是启用的，即默认会查询关联表（前提是关联设置属性enabled是开启状态）

下一篇文章将讨论一下FleaPHP的数据表关联设置

00662 function & initWebControls()
00663 {
00664 return FLEA::getSingleton(FLEA::getAppInf('webControlsClassName'));
00665 }

'webControlsClassName'默认是FLEA目录下的webControls类，该类封装了页面组件的实现，以及一些常用的页面控件，在找不到这些自带控件的时候就会去尝试搜索我们自定义的以_ctl开头的控件

/**
* 构造一个控件的 HTML 代码
*
* @param string $type
* @param string $name
* @param array $attribs
* @param boolean $return
*
* @return string
*/
function control($type, $name, $attribs = null, $return = false)
{
$type = strtolower($type);
$render = '_ctl' . ucfirst($type);
$attribs = (array)$attribs;

$__ctl_out = false;
if (method_exists($this, $render)) {
$__ctl_out = $this->{$render}($name, $attribs);
} else {
$extfilename = ucfirst($type) . '.php';
if (!isset($this->_extends[$type])) {
foreach ($this->_extendsDir as $dir) {
if (file_exists($dir . DS . $extfilename)) {
require($dir . DS . $extfilename);
$this->_extends[$type] = true;
break;
}
}
}

if (isset($this->_extends[$type])) {
$__ctl_out = call_user_func_array($render,
array('name' => $name, 'attribs' => $attribs));
}
}

if ($__ctl_out === false) {
$__ctl_out = "INVALID CONTROL TYPE \"{$type}\"";
}

if ($return) { return $__ctl_out; }
echo $__ctl_out;
return '';
}

实例化控件之后，在模版（也就是 .php）中：

如果使用smarty，调用方式就是:

{ webcontrol type='textbox' value=$textbox_value }
系统会自动去实例化控件对象

FLEA::setAppInf('dispatcherFailedCallback', 'onDispatcherFailed');

function onDispatcherFailed

{

redirect('404.html');

}

 

dispatcherFailedCallback的配置分2种情况，如果当前访问的控制器、动作不存：'dispatcherFailedCallback' => 'onDispatcherFailedCallback',
如果用户设置了RABC访问控制，访问无法访问的动作时：'dispatcherAuthFailedCallback' => 'onAuthFailedCallback',
上面onDispatcherFailedCallback、onAuthFailedCallback是出错的时候调用的函数，你可以在index.php种定义这2个函数就OK了。
例如：
function onAuthFailedCallback($controller,$action)
{

redirect(url('Login','Index')); // 这里是验证失败时，让用户去登录
}