·您现在的位置: 云翼网络 >> 文章中心 >> 网站建设 >> 网站建设开发 >> php网站开发 >> Yii的学习(5)--Active Record的关联

Yii的学习(5)--Active Record的关联

作者:佚名      php网站开发编辑:admin      更新时间:2022-07-23
Yii的学习(5)--Active Record的关联

官网原文:http://www.yiiframework.com/doc/guide/1.1/zh_cn/database.arr

官网中后半段为英文,而且中文的内容比英文少一些,先放到这里,之后有时间再翻译。

我们已经了解了怎样使用 Active Record (AR) 从单个数据表中获取数据。 在本节中,我们讲解怎样使用 AR 连接多个相关数据表并取回关联(join)后的数据集。

为了使用关系型 AR,我们建议在需要关联的表中定义主键-外键约束。这些约束可以帮助保证相关数据的一致性和完整性。

为简单起见,我们使用如下所示的实体-关系(ER)图中的数据结构演示此节中的例子。

信息:对外键约束的支持在不同的 DBMS 中是不一样的。 SQLite < 3.6.19 不支持外键约束,但你依然可以在建表时声明约束。

1. 声明关系

在我们使用 AR 执行关联查询之前,我们需要让 AR 知道一个 AR 类是怎样关联到另一个的。

两个 AR 类之间的关系直接通过 AR 类所代表的数据表之间的关系相关联。 从数据库的角度来说,表 A 和 B 之间有三种关系:一对多(one-to-many,例如tbl_usertbl_post),一对一( one-to-one 例如tbl_usertbl_PRofile)和 多对多(many-to-many 例如tbl_categorytbl_post)。 在 AR 中,有四种关系:

  • BELONGS_TO(属于): 如果表 A 和 B 之间的关系是一对多,则 表 B 属于 表 A (例如Post属于User);

  • HAS_MANY(有多个): 如果表 A 和 B 之间的关系是一对多,则 A 有多个 B (例如User有多个Post);

  • HAS_ONE(有一个): 这是HAS_MANY的一个特例,A 最多有一个 B (例如User最多有一个Profile);

  • MANY_MANY: 这个对应于数据库中的 多对多 关系。 由于多数 DBMS 不直接支持 多对多 关系,因此需要有一个关联表将 多对多 关系分割为 一对多 关系。 在我们的示例数据结构中,tbl_post_category就是用于此目的的。在 AR 术语中,我们可以解释MANY_MANYBELONGS_TOHAS_MANY的组合。 例如,Post属于多个(belongs to many)CategoryCategory有多个(has many)Post.

AR 中定义关系需要覆盖CActiveRecord中的relations()方法。此方法返回一个关系配置数组。每个数组元素通过如下格式表示一个单一的关系。

'VarName'=>array('RelationType', 'ClassName', 'ForeignKey', ...additional options)

其中VarName是关系的名字;RelationType指定关系类型,可以是一下四个常量之一:self::BELONGS_TO,self::HAS_ONE,self::HAS_MANYandself::MANY_MANYClassName是此 AR 类所关联的 AR 类的名字;ForeignKey指定关系中使用的外键(一个或多个)。额外的选项可以在每个关系的最后指定(稍后详述)。

以下代码演示了怎样定义UserPost类的关系:

class Post extends CActiveRecord{    ......     public function relations()    {        return array(            'author'=>array(self::BELONGS_TO, 'User', 'author_id'),            'categories'=>array(self::MANY_MANY, 'Category',                'tbl_post_category(post_id, category_id)'),        );    }} class User extends CActiveRecord{    ......     public function relations()    {        return array(            'posts'=>array(self::HAS_MANY, 'Post', 'author_id'),            'profile'=>array(self::HAS_ONE, 'Profile', 'owner_id'),        );    }}

信息:外键可能是复合的,包含两个或更多个列。 这种情况下,我们应该将这些外键名字链接,中间用空格或逗号分割。对于MANY_MANY关系类型, 关联表的名字必须也必须在外键中指定。例如,Post中的categories关系由外键tbl_post_category(post_id, category_id)指定。

AR 类中的关系定义为每个关系向类中隐式添加了一个属性。在一个关联查询执行后,相应的属性将将被以关联的 AR 实例填充。 例如,如果$author代表一个UserAR 实例, 我们可以使用$author->posts访问其关联的Post实例。

2. 执行关联查询

执行关联查询最简单的方法是读取一个 AR 实例中的关联属性。如果此属性以前没有被访问过,则一个关联查询将被初始化,它将两个表关联并使用当前 AR 实例的主键过滤。 查询结果将以所关联 AR 类的实例的方式保存到属性中。这就是传说中的懒惰式加载(lazy loading,也可译为 迟加载)方式,例如,关联查询只在关联的对象首次被访问时执行。 下面的例子演示了怎样使用这种方式:

// 获取 ID 为 10 的帖子$post=Post::model()->findByPk(10);// 获取帖子的作者(author): 此处将执行一个关联查询。$author=$post->author;

信息:如果关系中没有相关的实例,则相应的属性将为 null 或一个空数组。BELONGS_TOHAS_ONE关系的结果是 null,HAS_MANYMANY_MANY的结果是一个空数组。 注意,HAS_MANYMANY_MANY关系返回对象数组,你需要在访问任何属性之前先遍历这些结果。 否则,你可能会收到 "Trying to get property of non-object(尝试访问非对象的属性)" 错误。

懒惰式加载用起来很方便,但在某些情况下并不高效。如果我们想获取N个帖子的作者,使用这种懒惰式加载将会导致执行N个关联查询。 这种情况下,我们应该改为使用渴求式加载(eager loading)方式。

渴求式加载方式会在获取主 AR 实例的同时获取关联的 AR 实例。 这是通过在使用 AR 中的find或findAll方法时配合使用 with 方法完成的。例如:

$posts=Post::model()->with('author')->findAll();

上述代码将返回一个Post实例的数组。与懒惰式加载方式不同,在我们访问每个Post实例中的author属性之前,它就已经被关联的User实例填充了。 渴求式加载通过一个关联查询返回所有帖子及其作者,而不是对每个帖子执行一次关联查询。

我们可以在with()方法中指定多个关系名字,渴求式加载将一次性全部取回他们。例如,如下代码会将帖子连同其作者和分类一并取回。

$posts=Post::model()->with('author','categories')->findAll();

我们也可以实现嵌套的渴求式加载。像下面这样, 我们传递一个分等级的关系名表达式到with()方法,而不是一个关系名列表:

$posts=Post::model()->with(    'author.profile',    'author.posts',    'categories')->findAll();

上述示例将取回所有帖子及其作者和所属分类。它还同时取回每个作者的简介(author.profile)和帖子(author.posts)。

从版本 1.1.0 开始,渴求式加载也可以通过指定CDbCriteria::with的属性执行,就像下面这样:

$criteria=new CDbCriteria;$criteria->with=array(    'author.profile',    'author.posts',    'categories',);$posts=Post::model()->findAll($criteria);

或者

$posts=Post::model()->findAll(array(    'with'=>array(        'author.profile',        'author.posts',        'categories',    ));
3. 关系型查询选项

我们提到在关系声明时可以指定附加的选项。这些 名-值 对形式的选项用于自定义关系型查询。概括如下:

  • select: 关联的 AR 类中要选择(select)的列的列表。 默认为 '*',即选择所有列。此选项中的列名应该是已经消除歧义的。

  • condition: 即WHERE条件。默认为空。此选项中的列名应该是已经消除歧义的。

  • params: 要绑定到所生成的 SQL 语句的参数。应该以 名-值 对数组的形式赋值。此选项从 1.0.3 版起有效。

  • on: 即ON语句。此处指定的条件将会通过AND操作符附加到 join 条件中。此选项中的列名应该是已经消除歧义的。 此选项不会应用到MANY_MANY关系中。此选项从 1.0.2 版起有效。

  • order: 即ORDER BY语句。默认为空。 此选项中的列名应该是已经消除歧义的。

  • with: a list of child related objects that should be loaded together with this object. Be aware that using this option inappropriately may form an infinite relation loop.

  • joinType: type of join for this relationship. It defaults toLEFT OUTER JOIN.

  • alias: the alias for the table associated with this relationship. It defaults to null, meaning the table alias is the same as the relation name.

  • together: whether the table associated with this relationship should be forced to join together with the primary table and other tables. This option is only meaningful forHAS_MANYandMANY_MANYrelations. If this option is set false, the table associated with theHAS_MANYorMANY_MANYrelation will be joined with the primary table in a separate SQL query, which may improve the overall query performance since less duplicated data is returned. If this option is set true, the associated table will always be joined with the primary table in a single SQL query, even if the primary table is paginated. If this option is not set, the associated table will be joined with the primary table in a single SQL query only when the primary table is not paginated. For more details, see the section "Relational Query Performance".

  • join: the extraJOINclause. It defaults to empty. This option has been available since version 1.1.3.

  • group: theGROUP BYclause. It defaults to empty. Column names referenced in this option should be disambiguated.

  • having: theHAVINGclause. It defaults to empty. Column names referenced in this option should be disambiguated.

  • index: the name of the column whose values should be used as keys of the array that stores related objects. Without setting this option, an related object array would use zero-based integer index. This option can only be set forHAS_MANYandMANY_MANYrelations.

  • scopes: scopes to apply. In case of a single scope can be used like'scopes'=>'scopeName', in case of multiple scopes can be used like'scopes'=>array('scopeName1','scopeName2'). This option has been available since version 1.1.9.

In addition, the following options are available for certain relationships during lazy loading: