\thinkModel

getPk()

getPk() : string|array

获取模型对象的主键

Returns

getKey()

getKey() : integer

获取模型对象的主键值

Returns

allowField()

allowField(array|string|true  $field) : $this

设置允许写入的字段

Parameters

Returns

readonly()

readonly(array|string  $field) : $this

设置只读字段

Parameters

Returns

data()

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

设置数据对象值

Parameters

Returns

appendData()

appendData(mixed  $data, boolean  $set = false) : $this

批量设置数据对象值

Parameters

Returns

getOrigin()

getOrigin(string  $name = null) : mixed

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

Parameters

Returns

getData()

getData(string  $name = null) : mixed

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

Parameters

Throws

\InvalidArgumentException

Returns

getChangedData()

getChangedData() : array

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

Returns

setAttr()

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

修改器 设置数据对象值

Parameters

isAutoWriteTimestamp()

isAutoWriteTimestamp(boolean  $auto) : $this

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

Parameters

Returns

getAttr()

getAttr(string  $name, array  $item = null) : mixed

获取器 获取数据对象的值

Parameters

Throws

\InvalidArgumentException

Returns

withAttribute()

withAttribute(string|array  $name, callable  $callback = null) : $this

设置数据字段获取器

Parameters

Returns

setParent()

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

设置父关联对象

Parameters

Returns

getParent()

getParent() : \think\Model

获取父关联对象

Returns

getRelation()

getRelation(string  $name = null) : mixed

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

Parameters

Returns

setRelation()

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

设置关联数据对象值

Parameters

Returns

together()

together(array|string  $relation) : $this

关联数据写入

Parameters

Returns

has()

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

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

Parameters

Returns

hasWhere()

hasWhere(string  $relation, mixed  $where = array(), mixed  $fields = '*') : \think\db\Query

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

Parameters

Returns

relationQuery()

relationQuery(string|array  $relations, array  $withRelationAttr = array()) : $this

查询当前模型的关联数据

Parameters

Returns

eagerlyResultSet()

eagerlyResultSet(array  $resultSet, string  $relation, array  $withRelationAttr = array(), boolean  $join = false) : array

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

Parameters

Returns

eagerlyResult()

eagerlyResult(\think\Model  $result, string  $relation, array  $withRelationAttr = array(), boolean  $join = false) : \think\Model

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

Parameters

Returns

relationCount()

relationCount(\think\Model  $result, array  $relations, string  $aggregate = 'sum', string  $field = '*') : void

关联统计

Parameters

hasOne()

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

HAS ONE 关联定义

Parameters

Returns

belongsTo()

belongsTo(string  $model, string  $foreignKey = '', string  $localKey = '') : \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

morphOne()

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

MORPH One 关联定义

Parameters

Returns

morphMany()

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

MORPH MANY 关联定义

Parameters

Returns

morphTo()

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

MORPH TO 关联定义

Parameters

Returns

event()

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

注册回调方法

Parameters

flushEvent()

flushEvent() : void

清除回调方法

observe()

observe(object|string  $class) : void

注册一个模型观察者

Parameters

withEvent()

withEvent(boolean  $event) : $this

当前操作的事件响应

Parameters

Returns

append()

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

设置需要附加的输出属性

Parameters

Returns

appendRelationAttr()

appendRelationAttr(string  $attr, 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

__toString()

__toString() 

jsonSerialize()

jsonSerialize() 

toCollection()

toCollection(array|\think\Collection  $collection, string  $resultSetType = null) : \think\Collection

转换数据集为数据集对象

Parameters

Returns

__construct()

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

架构函数

Parameters

getName()

getName() : string

获取当前模型名称

Returns

readMaster()

readMaster(boolean  $all = false) : $this

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

Parameters

Returns

newInstance()

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

创建新的模型实例

Parameters

Returns

setQuery()

setQuery(\think\db\Query  $query) : $this

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

Parameters

Returns

db()

db(boolean|array  $useBaseQuery = true) : \think\db\Query

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

Parameters

Returns

force()

force(boolean  $force = true) : $this

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

Parameters

Returns

isForce()

isForce() : boolean

判断force

Returns

replace()

replace(boolean  $replace = true) : $this

新增数据是否使用Replace

Parameters

Returns

exists()

exists(boolean  $exists) : $this

设置数据是否存在

Parameters

Returns

isExists()

isExists() : boolean

判断数据是否存在数据库

Returns

isEmpty()

isEmpty() : boolean

判断模型是否为空

Returns

save()

save(array  $data = array(), array  $where = array(), string  $sequence = null) : boolean

保存当前数据对象

Parameters

Returns

setInc()

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

字段值(延迟)增长

Parameters

Throws

\think\Exception

Returns

setDec()

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

字段值(延迟)减少

Parameters

Throws

\think\Exception

Returns

saveAll()

saveAll(array  $dataSet, boolean  $replace = true) : \think\Collection

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

Parameters

Throws

\Exception

Returns

isUpdate()

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

是否为更新数据

Parameters

Returns

delete()

delete() : boolean

删除当前的记录

Returns

auto()

auto(array  $fields) : $this

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

Parameters

Returns

create()

create(array  $data = array(), array|true  $field = null, boolean  $replace = false) : static

写入数据

Parameters

Returns

update()

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

更新数据

Parameters

Returns

destroy()

destroy(mixed  $data) : boolean

删除记录

Parameters

Returns

getError()

getError() : mixed

获取错误信息

Returns

__wakeup()

__wakeup() 

解序列化后处理

__debugInfo()

__debugInfo() 

__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

offsetSet()

offsetSet(  $name,   $value) 

Parameters

offsetExists()

offsetExists(  $name) 

Parameters

offsetUnset()

offsetUnset(  $name) 

Parameters

offsetGet()

offsetGet(  $name) 

Parameters

useGlobalScope()

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

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

Parameters

Returns

__call()

__call(  $method,   $args) 

Parameters

__callStatic()

__callStatic(  $method,   $args) 

Parameters

where()

where(mixed  $field, string  $op = null, mixed  $condition = null) : \think\db\Query

static 查询条件

Parameters

Returns

whereRaw()

whereRaw(string  $where, array  $bind = []) : \think\db\Query

static 表达式查询

Parameters

Returns

whereExp()

whereExp(string  $field, string  $condition, array  $bind = []) : \think\db\Query

static 字段表达式查询

Parameters

Returns

when()

when(mixed  $condition, mixed  $query, mixed  $otherwise = null) : \think\db\Query

static 条件查询

Parameters

Returns

join()

join(mixed  $join, mixed  $condition = null, string  $type = 'INNER') : \think\db\Query

static JOIN查询

Parameters

Returns

view()

view(mixed  $join, mixed  $field = null, mixed  $on = null, string  $type = 'INNER') : \think\db\Query

static 视图查询

Parameters

Returns

with()

with(mixed  $with) : \think\db\Query

static 关联预载入

Parameters

Returns

count()

count(string  $field) : \think\db\Query

static Count统计查询

Parameters

Returns

min()

min(string  $field) : \think\db\Query

static Min统计查询

Parameters

Returns

max()

max(string  $field) : \think\db\Query

static Max统计查询

Parameters

Returns

sum()

sum(string  $field) : \think\db\Query

static SUM统计查询

Parameters

Returns

avg()

avg(string  $field) : \think\db\Query

static Avg统计查询

Parameters

Returns

field()

field(mixed  $field, boolean  $except = false) : \think\db\Query

static 指定查询字段

Parameters

Returns

fieldRaw()

fieldRaw(string  $field, array  $bind = []) : \think\db\Query

static 指定查询字段

Parameters

Returns

union()

union(mixed  $union, boolean  $all = false) : \think\db\Query

static UNION查询

Parameters

Returns

limit()

limit(mixed  $offset, integer  $length = null) : \think\db\Query

static 查询LIMIT

Parameters

Returns

order()

order(mixed  $field, string  $order = null) : \think\db\Query

static 查询ORDER

Parameters

Returns

orderRaw()

orderRaw(string  $field, array  $bind = []) : \think\db\Query

static 查询ORDER

Parameters

Returns

cache()

cache(mixed  $key = null, integer  $expire = null) : \think\db\Query

static 设置查询缓存

Parameters

Returns

value()

value(string  $field) : mixed

static 获取某个字段的值

Parameters

Returns

column()

column(string  $field, string  $key = '') : array

static 获取某个列的值

Parameters

Returns

find()

find(mixed  $data = null) : mixed

static 查询单个记录

Parameters

Returns

select()

select(mixed  $data = null) : mixed

static 查询多个记录

Parameters

Returns

get()

get(mixed  $data = null, mixed  $with, boolean  $cache=) : mixed

static 查询单个记录 支持关联预载入

Parameters

Returns

getOrFail()

getOrFail(mixed  $data = null, mixed  $with, boolean  $cache=) : mixed

static 查询单个记录 不存在则抛出异常

Parameters

Returns

findOrEmpty()

findOrEmpty(mixed  $data = null, mixed  $with, boolean  $cache=) : mixed

static 查询单个记录 不存在则返回空模型

Parameters

Returns

all()

all(mixed  $data = null, mixed  $with, boolean  $cache=) : mixed

static 查询多个记录 支持关联预载入

Parameters

Returns

withAttr()

withAttr(array  $name, \Closure  $closure) : \think\Model

动态定义获取器

Parameters

Returns

isPk()

isPk(string  $key) : boolean

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

Parameters

Returns

autoWriteTimestamp()

autoWriteTimestamp(string  $name) : mixed

自动写入时间戳

Parameters

Returns

writeTransform()

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

数据写入 类型转换

Parameters

Returns

getRelationAttribute()

getRelationAttribute(string  $name, array  $item) : mixed

获取关联属性值

Parameters

Returns

readTransform()

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

数据读取 类型转换

Parameters

Returns

parseModel()

parseModel(string  $model) : string

解析模型的完整命名空间

Parameters

Returns

getForeignKey()

getForeignKey(string  $name) : string

获取模型的默认外键名

Parameters

Returns

isRelationAttr()

isRelationAttr(string  $attr) : string|false

检查属性是否为关联属性 如果是则返回关联方法名

Parameters

Returns

getRelationData()

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

智能获取关联模型数据

Parameters

Returns

checkAutoRelationWrite()

checkAutoRelationWrite() : void

关联数据自动写入检查

autoRelationUpdate()

autoRelationUpdate() : void

自动关联数据更新（针对一对一关联）

autoRelationInsert()

autoRelationInsert() : void

自动关联数据写入（针对一对一关联）

autoRelationDelete()

autoRelationDelete() : void

自动关联数据删除（支持一对一及一对多关联）

trigger()

trigger(string  $event) : boolean

触发事件

Parameters

Returns

beforeInsert()

beforeInsert(callable  $callback, boolean  $override = false) 

模型before_insert事件快捷方法

Parameters

afterInsert()

afterInsert(callable  $callback, boolean  $override = false) 

模型after_insert事件快捷方法

Parameters

beforeUpdate()

beforeUpdate(callable  $callback, boolean  $override = false) 

模型before_update事件快捷方法

Parameters

afterUpdate()

afterUpdate(callable  $callback, boolean  $override = false) 

模型after_update事件快捷方法

Parameters

beforeWrite()

beforeWrite(callable  $callback, boolean  $override = false) 

模型before_write事件快捷方法

Parameters

afterWrite()

afterWrite(callable  $callback, boolean  $override = false) 

模型after_write事件快捷方法

Parameters

beforeDelete()

beforeDelete(callable  $callback, boolean  $override = false) 

模型before_delete事件快捷方法

Parameters

afterDelete()

afterDelete(callable  $callback, boolean  $override = false) 

模型after_delete事件快捷方法

Parameters

beforeRestore()

beforeRestore(callable  $callback, boolean  $override = false) 

模型before_restore事件快捷方法

Parameters

afterRestore()

afterRestore(callable  $callback, boolean  $override = false) 

模型after_restore事件快捷方法

Parameters

formatDateTime()

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

时间日期字段格式化处理

Parameters

Returns

checkTimeStampWrite()

checkTimeStampWrite() : void

检查时间字段写入

buildQuery()

buildQuery() : \think\db\Query

创建模型的查询对象

Returns

initialize()

initialize() : void

初始化模型

init()

init() : void

初始化处理

autoCompleteData()

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

数据自动完成

Parameters

checkBeforeSave()

checkBeforeSave(array  $data, array  $where) : boolean

写入之前检查数据

Parameters

Returns

checkAllowFields()

checkAllowFields(array  $append = array()) : array

检查数据是否允许写入

Parameters

Returns

updateData()

updateData(mixed  $where) : boolean

更新写入数据

Parameters

Returns

insertData()

insertData(string  $sequence) : boolean

新增写入数据

Parameters

Returns

getWhere()

getWhere() : mixed

获取当前的更新条件

Returns