\think\modelMerge

__construct()

__construct(array|object  $data = array()) 

构造函数

Parameters

readMaster()

readMaster(boolean  $all = false) : $this

是否从主库读取数据（主从分布有效）

Parameters

Returns

newInstance()

newInstance(array|object  $data = array(), boolean  $isUpdate = false, mixed  $where = null) : \think\Model

创建新的模型实例

Parameters

Returns

getQuery()

getQuery(boolean  $buildNewQuery = false) : \think\db\Query

获取当前模型的查询对象

Parameters

Returns

db()

db(boolean  $useBaseQuery = true, boolean  $buildNewQuery = true) : \think\db\Query

获取当前模型的数据库查询对象

Parameters

Returns

setParent()

setParent(\think\Model  $model) : $this

设置父关联对象

Parameters

Returns

getParent()

getParent() : \think\Model

获取父关联对象

Returns

data()

data(mixed  $data, mixed  $value = null) : $this

设置数据对象值

Parameters

Returns

getData()

getData(string  $name = null) : mixed

获取对象原始数据 如果不存在指定字段返回false

Parameters

Throws

\InvalidArgumentException

Returns

isAutoWriteTimestamp()

isAutoWriteTimestamp(boolean  $auto) : $this

是否需要自动写入时间字段

Parameters

Returns

force()

force(boolean  $force = true) : $this

更新是否强制写入数据 而不做比较

Parameters

Returns

setAttr()

setAttr(string  $name, mixed  $value, array  $data = array()) : $this

修改器 设置数据对象值

Parameters

Returns

getRelation()

getRelation(string  $name = null) : mixed

获取当前模型的关联模型数据

Parameters

Returns

setRelation()

setRelation(string  $name, mixed  $value) : $this

设置关联数据对象值

Parameters

Returns

getAttr()

getAttr(string  $name) : mixed

获取器 获取数据对象的值

Parameters

Throws

\InvalidArgumentException

Returns

append()

append(array  $append = array(), boolean  $override = false) : $this

设置需要追加的输出属性

Parameters

Returns

appendRelationAttr()

appendRelationAttr(string  $relation, string|array  $append) : $this

设置附加关联对象的属性

Parameters

Throws

\think\Exception

Returns

hidden()

hidden(array  $hidden = array(), boolean  $override = false) : $this

设置需要隐藏的输出属性

Parameters

Returns

visible()

visible(array  $visible = array(), boolean  $override = false) : $this

设置需要输出的属性

Parameters

Returns

toArray()

toArray() : array

转换当前模型对象为数组

Returns

toJson()

toJson(integer  $options = JSON_UNESCAPED_UNICODE) : string

转换当前模型对象为JSON字符串

Parameters

Returns

removeRelation()

removeRelation() : $this

移除当前模型的关联属性

Returns

toCollection()

toCollection(array|\think\Collection  $collection) : \think\Collection

转换当前模型数据集为数据集对象

Parameters

Returns

together()

together(mixed  $relation) : $this

关联数据一起更新

Parameters

Returns

getPk()

getPk(string  $name = '') : mixed

获取模型对象的主键

Parameters

Returns

save()

save(mixed  $data = array(), array  $where = array(), string  $sequence = null) : false|integer

保存模型数据 以及关联数据

Parameters

Throws

\Exception

Returns

getChangedData()

getChangedData() : array

获取变化的数据 并排除只读数据

Returns

setInc()

setInc(string  $field, integer  $step = 1, integer  $lazyTime) : integer|true

字段值(延迟)增长

Parameters

Throws

\think\Exception

Returns

setDec()

setDec(string  $field, integer  $step = 1, integer  $lazyTime) : integer|true

字段值(延迟)增长

Parameters

Throws

\think\Exception

Returns

saveAll()

saveAll(array  $dataSet, boolean  $replace = true) : array|false

保存多个数据到当前数据对象

Parameters

Throws

\Exception

Returns

allowField()

allowField(string|array  $field) : $this

设置允许写入的字段

Parameters

Returns

except()

except(string|array  $field) : $this

设置排除写入的字段

Parameters

Returns

readonly()

readonly(mixed  $field) : $this

设置只读字段

Parameters

Returns

isUpdate()

isUpdate(boolean  $update = true, mixed  $where = null) : $this

是否为更新数据

Parameters

Returns

delete()

delete() : integer

删除当前的记录 并删除关联数据

Throws

\Exception

Returns

auto()

auto(array  $fields) : $this

设置自动完成的字段（ 规则通过修改器定义）

Parameters

Returns

validate()

validate(array|string|boolean  $rule = true, array  $msg = array(), boolean  $batch = false) : $this

设置字段验证

Parameters

Returns

validateFailException()

validateFailException(boolean  $fail = true) : $this

设置验证失败后是否抛出异常

Parameters

Returns

getError()

getError() : string|array

返回模型的错误信息

Returns

event()

event(string  $event, callable  $callback, boolean  $override = false) : void

注册回调方法

Parameters

create()

create(array  $data = array(), array|true  $field = null) : $this

写入数据

Parameters

Returns

update()

update(array  $data = array(), array  $where = array(), array|true  $field = null) : $this

更新数据

Parameters

Returns

get()

get(mixed  $data = null, string|array  $with = array(), boolean  $cache = false) : \think\Model

查找单条记录

Parameters

Returns

all()

all(mixed  $data = null, array|string  $with = array(), boolean  $cache = false) : array|false|string

查找所有记录

Parameters

Returns

destroy()

destroy(mixed  $data) : integer

删除记录

Parameters

Returns

成功删除的记录数

useGlobalScope()

useGlobalScope(boolean  $use) : \think\db\Query

设置是否使用全局查询范围

Parameters

Returns

has()

has(string  $relation, mixed  $operator = '>=', integer  $count = 1, string  $id = '*') : \think\model\Relation|\think\db\Query

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

Parameters

Returns

hasWhere()

hasWhere(string  $relation, mixed  $where = array(), mixed  $fields = null) : \think\model\Relation|\think\db\Query

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

Parameters

Returns

relationQuery()

relationQuery(string|array  $relations) : $this

查询当前模型的关联数据

Parameters

Returns

eagerlyResultSet()

eagerlyResultSet(array  $resultSet, string  $relation) : array

预载入关联查询 返回数据集

Parameters

Returns

eagerlyResult()

eagerlyResult(\think\Model  $result, string  $relation) : \think\Model

预载入关联查询 返回模型对象

Parameters

Returns

relationCount()

relationCount(\think\Model  $result, string|array  $relation) : void

关联统计

Parameters

hasOne()

hasOne(string  $model, string  $foreignKey = '', string  $localKey = '', array  $alias = array(), string  $joinType = 'INNER') : \think\model\relation\HasOne

HAS ONE 关联定义

Parameters

Returns

belongsTo()

belongsTo(string  $model, string  $foreignKey = '', string  $localKey = '', array  $alias = array(), string  $joinType = 'INNER') : \think\model\relation\BelongsTo

BELONGS TO 关联定义

Parameters

Returns

hasMany()

hasMany(string  $model, string  $foreignKey = '', string  $localKey = '') : \think\model\relation\HasMany

HAS MANY 关联定义

Parameters

Returns

hasManyThrough()

hasManyThrough(string  $model, string  $through, string  $foreignKey = '', string  $throughKey = '', string  $localKey = '') : \think\model\relation\HasManyThrough

HAS MANY 远程关联定义

Parameters

Returns

belongsToMany()

belongsToMany(string  $model, string  $table = '', string  $foreignKey = '', string  $localKey = '') : \think\model\relation\BelongsToMany

BELONGS TO MANY 关联定义

Parameters

Returns

morphMany()

morphMany(string  $model, string|array  $morph = null, string  $type = '') : \think\model\relation\MorphMany

MORPH MANY 关联定义

Parameters

Returns

morphOne()

morphOne(string  $model, string|array  $morph = null, string  $type = '') : \think\model\relation\MorphOne

MORPH One 关联定义

Parameters

Returns

morphTo()

morphTo(string|array  $morph = null, array  $alias = array()) : \think\model\relation\MorphTo

MORPH TO 关联定义

Parameters

Returns

__call()

__call(  $method,   $args) 

Parameters

__callStatic()

__callStatic(  $method,   $args) 

Parameters

__set()

__set(string  $name, mixed  $value) : void

修改器 设置数据对象的值

Parameters

__get()

__get(string  $name) : mixed

获取器 获取数据对象的值

Parameters

Returns

__isset()

__isset(string  $name) : boolean

检测数据对象的值

Parameters

Returns

__unset()

__unset(string  $name) : void

销毁数据对象的值

Parameters

__toString()

__toString() 

jsonSerialize()

jsonSerialize() 

offsetSet()

offsetSet(  $name,   $value) 

Parameters

offsetExists()

offsetExists(  $name) 

Parameters

offsetUnset()

offsetUnset(  $name) 

Parameters

offsetGet()

offsetGet(  $name) 

Parameters

__wakeup()

__wakeup() 

解序列化后处理

buildQuery()

buildQuery() : \think\db\Query

创建模型的查询对象

Returns

initialize()

initialize() : void

初始化模型

init()

init() : void

初始化处理

autoWriteTimestamp()

autoWriteTimestamp(string  $name) : mixed

自动写入时间戳

Parameters

Returns

formatDateTime()

formatDateTime(mixed  $time, mixed  $format, boolean  $timestamp = false) : mixed

时间日期字段格式化处理

Parameters

Returns

writeTransform()

writeTransform(mixed  $value, string|array  $type) : mixed

数据写入 类型转换

Parameters

Returns

getRelationData()

getRelationData(\think\model\Relation  $modelRelation) : mixed

获取关联模型数据

Parameters

Throws

\BadMethodCallException

Returns

readTransform()

readTransform(mixed  $value, string|array  $type) : mixed

数据读取 类型转换

Parameters

Returns

parseAttr()

parseAttr(array  $attrs, array  $result, boolean  $visible = true) : array

解析隐藏及显示属性

Parameters

Returns

subToArray()

subToArray(\think\Model|\think\model\Collection  $model,   $visible,   $hidden,   $key) : array

转换子模型对象

Parameters

Returns

isPk()

isPk(string  $key) : boolean

判断一个字段名是否为主键字段

Parameters

Returns

checkAllowField()

checkAllowField(  $auto = array()) 

Parameters

autoRelationUpdate()

autoRelationUpdate(  $relation) 

Parameters

getWhere()

getWhere() : mixed

获取更新条件

Returns

autoCompleteData()

autoCompleteData(array  $auto = array()) : void

数据自动完成

Parameters

validateData()

validateData(array  $data, mixed  $rule = null, boolean  $batch = null) : boolean

自动验证数据

Parameters

Returns

trigger()

trigger(string  $event, mixed  $params) : boolean

触发事件

Parameters

Returns

parseQuery()

parseQuery(mixed  $data, string  $with, boolean  $cache) : \think\db\Query

分析查询表达式

Parameters

Returns

parseModel()

parseModel(string  $model) : string

解析模型的完整命名空间

Parameters

Returns

getForeignKey()

getForeignKey(string  $name) : string

获取模型的默认外键名

Parameters

Returns

beforeInsert()

beforeInsert(  $callback, boolean  $override = false) 

模型事件快捷方法

Parameters

afterInsert()

afterInsert(  $callback,   $override = false) 

Parameters

beforeUpdate()

beforeUpdate(  $callback,   $override = false) 

Parameters

afterUpdate()

afterUpdate(  $callback,   $override = false) 

Parameters

beforeWrite()

beforeWrite(  $callback,   $override = false) 

Parameters

afterWrite()

afterWrite(  $callback,   $override = false) 

Parameters

beforeDelete()

beforeDelete(  $callback,   $override = false) 

Parameters

afterDelete()

afterDelete(  $callback,   $override = false) 

Parameters

attachQuery()

attachQuery(\think\db\Query  $query) : \think\db\Query

附加查询表达式

Parameters

Returns

getModelField()

getModelField(\think\db\Query  $query, string  $name, string  $table = '', array  $map = array(), array  $fields = array()) : array

获取关联模型的字段 并解决混淆

Parameters

Returns

parseData()

parseData(string  $model, array  $data) : array

处理写入的模型数据

Parameters

Returns