Properties

$eagerlyType

$eagerlyType

$joinType

$joinType

$bindAttr

$bindAttr

$relation

$relation

$parent

$parent

$model

$model : \think\Model

Type

Model — 当前关联的模型类

$query

$query : \think\db\Query

Type

Query — 关联模型查询对象

$foreignKey

$foreignKey

$localKey

$localKey

$baseQuery

$baseQuery

$selfRelation

$selfRelation

Methods

joinType()

joinType(string  $type) : $this

设置join类型

Parameters

string $type

JOIN类型

Returns

$this —

eagerly()

eagerly(\think\db\Query  $query, string  $relation, mixed  $field, string  $joinType, \Closure  $closure, bool  $first) : void

预载入关联查询(JOIN方式)

Parameters

\think\db\Query $query

查询对象

string $relation

关联名

mixed $field

关联字段

string $joinType

JOIN方式

\Closure $closure

闭包条件

bool $first

eagerlyResultSet()

eagerlyResultSet(array  $resultSet, string  $relation, string  $subRelation, \Closure  $closure, bool  $join = false) : void

预载入关联查询(数据集)

Parameters

array $resultSet

数据集

string $relation

当前关联名

string $subRelation

子关联名

\Closure $closure

闭包

bool $join

是否为JOIN方式

eagerlyResult()

eagerlyResult(\think\Model  $result, string  $relation, string  $subRelation, \Closure  $closure, bool  $join = false) : void

预载入关联查询(数据)

Parameters

\think\Model $result

数据对象

string $relation

当前关联名

string $subRelation

子关联名

\Closure $closure

闭包

bool $join

是否为JOIN方式

save()

save(mixed  $data) : \think\Model|false

保存(新增)当前关联数据对象

Parameters

mixed $data

数据 可以使用数组 关联模型对象 和 关联对象的主键

Returns

\think\Model|false —

setEagerlyType()

setEagerlyType(int  $type) : $this

设置预载入方式

Parameters

int $type

预载入方式 0 JOIN查询 1 IN查询

Returns

$this —

getEagerlyType()

getEagerlyType() : int

获取预载入方式

Returns

int —

bind()

bind(mixed  $attr) : $this

绑定关联表的属性到父模型属性

Parameters

mixed $attr

要绑定的属性列表

Returns

$this —

getBindAttr()

getBindAttr() : array

获取绑定属性

Returns

array —

getParent()

getParent() : \think\Model

获取关联的所属模型

Returns

\think\Model —

getModel()

getModel() : \think\Model

获取当前的关联模型类的实例

Returns

\think\Model —

getQuery()

getQuery() : \think\db\Query

获取当前的关联模型类的实例

Returns

\think\db\Query —

selfRelation()

selfRelation(bool  $self = true) : $this

设置当前关联为自关联

Parameters

bool $self

是否自关联

Returns

$this —

isSelfRelation()

isSelfRelation() : bool

当前关联是否为自关联

Returns

bool —

update()

update(array  $data = []) : int|string

更新数据

Parameters

array $data

更新数据

Returns

int|string —

delete()

delete(mixed  $data = null) : int

删除记录

Parameters

mixed $data

表达式 true 表示强制删除

Throws

\think\Exception
\think\model\PDOException

Returns

int —

__call()

__call(mixed  $method, mixed  $args) : mixed

Parameters

mixed $method
mixed $args

Returns

mixed —

__construct()

__construct(\think\Model  $parent, string  $model, string  $foreignKey, string  $localKey, string  $relation = null) : mixed

架构函数

Parameters

\think\Model $parent

上级模型对象

string $model

模型名

string $foreignKey

关联外键

string $localKey

关联主键

string $relation

关联名

Returns

mixed —

getRelation()

getRelation(string  $subRelation = '', \Closure  $closure = null) : \think\Model

延迟获取关联数据

Parameters

string $subRelation

子关联名

\Closure $closure

闭包查询条件

Returns

\think\Model —

getRelationCountQuery()

getRelationCountQuery(\Closure  $closure, string  $aggregate = 'count', string  $field = '*', string  $aggregateAlias = '') : string

创建关联统计子查询

Parameters

\Closure $closure

闭包

string $aggregate

聚合查询方法

string $field

字段

string $aggregateAlias

聚合字段别名

Returns

string —

relationCount()

relationCount(\think\Model  $result, \Closure  $closure, string  $aggregate = 'count', string  $field = '*', string  $name = '') : int

关联统计

Parameters

\think\Model $result

数据对象

\Closure $closure

闭包

string $aggregate

聚合查询方法

string $field

字段

string $name

统计字段别名

Returns

int —

has()

has(string  $operator = '>=', int  $count = 1, string  $id = '*', string  $joinType = 'INNER') : \think\model\relation\Query

根据关联条件查询当前模型

Parameters

string $operator

比较操作符

int $count

个数

string $id

关联表的统计字段

string $joinType

JOIN类型

Returns

\think\model\relation\Query —

hasWhere()

hasWhere(mixed  $where = [], mixed  $fields = null) : \think\model\relation\Query

根据关联条件查询当前模型

Parameters

mixed $where

查询条件(数组或者闭包)

mixed $fields

字段

Returns

\think\model\relation\Query —

associate()

associate(\think\Model  $model) : \think\Model

添加关联数据

Parameters

\think\Model $model

关联模型对象

Returns

\think\Model —

dissociate()

dissociate() : \think\Model

注销关联数据

Returns

\think\Model —

eagerlySet()

eagerlySet(array  $resultSet, string  $relation, string  $subRelation, \Closure  $closure) : void

预载入关联查询(数据集)

Parameters

array $resultSet

数据集

string $relation

当前关联名

string $subRelation

子关联名

\Closure $closure

闭包

eagerlyOne()

eagerlyOne(\think\Model  $result, string  $relation, string  $subRelation, \Closure  $closure) : void

预载入关联查询(数据)

Parameters

\think\Model $result

数据对象

string $relation

当前关联名

string $subRelation

子关联名

\Closure $closure

闭包

match()

match(string  $model, string  $relation, \think\Model  $result) : void

一对一 关联模型预查询拼装

Parameters

string $model

模型名称

string $relation

关联名

\think\Model $result

模型对象实例

bindAttr()

bindAttr(\think\Model  $model, \think\Model  $result) : void

绑定关联属性到父模型

Parameters

\think\Model $model

父模型对象

\think\Model $result

关联模型对象

Throws

\think\Exception

eagerlyWhere()

eagerlyWhere(array  $where, string  $key, string  $relation, string  $subRelation = '', \Closure  $closure = null) : array

一对一 关联模型预查询(IN方式)

Parameters

array $where

关联预查询条件

string $key

关联键名

string $relation

关联名

string $subRelation

子关联

\Closure $closure

Returns

array —

resultSetBuild()

resultSetBuild(array  $resultSet) : mixed

封装关联数据集

Parameters

array $resultSet

数据集

Returns

mixed —

getQueryFields()

getQueryFields(mixed  $model) : mixed

Parameters

mixed $model

Returns

mixed —

getRelationQueryFields()

getRelationQueryFields(mixed  $fields, mixed  $model) : mixed

Parameters

mixed $fields
mixed $model

Returns

mixed —

getQueryWhere()

getQueryWhere(mixed  $where, mixed  $relation) : mixed

Parameters

mixed $where
mixed $relation

Returns

mixed —

baseQuery()

baseQuery() : void

执行基础查询(仅执行一次)