模型注释

2026-07-01 12:42:48 +08:00 · 2017-01-23 13:46:17 +08:00
parent 8311a4e39b
commit 6078d0ea39
11 changed files with 402 additions and 340 deletions
--- a/library/think/Model.php
+++ b/library/think/Model.php
@@ -27,18 +27,7 @@ use think\model\relation\MorphTo;
 /**
 * Class Model
 * @package think
- * @method static Paginator paginate(integer $listRows = 15, boolean $simple = false, array $config = []) 分页查询
- * @method static mixed value($field, $default = null) 得到某个字段的值
- * @method static array column($field, $key = '') 得到某个列的数组
- * @method static integer count($field = '*') COUNT查询
- * @method static integer sum($field = '*') SUM查询
- * @method static integer min($field = '*') MIN查询
- * @method static integer max($field = '*') MAX查询
- * @method static integer avg($field = '*') AVG查询
- * @method static setField($field, $value = '')
- * @method static Query where($field, $op = null, $condition = null) 指定AND查询条件
- * @method static static findOrFail($data = null) 查找单条记录 如果不存在则抛出异常
- *
+ * @mixin Query
 */
 abstract class Model implements \JsonSerializable, \ArrayAccess
 {
@@ -200,7 +189,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
        }
        // 全局作用域
        if ($baseQuery && method_exists($this, 'base')) {
-            call_user_func_array([$this, 'base'], [ & self::$links[$model]]);
+            call_user_func_array([$this, 'base'], [& self::$links[$model]]);
        }
        // 返回当前模型的数据库查询对象
        return self::$links[$model];
@@ -226,12 +215,13 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
     * @return void
     */
    protected static function init()
-    {}
+    {
+    }

    /**
     * 设置数据对象值
     * @access public
-     * @param mixed $data 数据或者属性名
+     * @param mixed $data  数据或者属性名
     * @param mixed $value 值
     * @return $this
     */
@@ -278,9 +268,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 修改器 设置数据对象值
     * @access public
-     * @param string    $name 属性名
-     * @param mixed     $value 属性值
-     * @param array     $data 数据
+     * @param string $name  属性名
+     * @param mixed  $value 属性值
+     * @param array  $data  数据
     * @return $this
     */
    public function setAttr($name, $value, $data = [])
@@ -313,7 +303,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 自动写入时间戳
     * @access public
-     * @param string         $name 时间戳字段
+     * @param string $name 时间戳字段
     * @return mixed
     */
    protected function autoWriteTimestamp($name)
@@ -335,7 +325,12 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
                    $value = $_SERVER['REQUEST_TIME'];
                    break;
            }
-        } elseif (is_string($this->autoWriteTimestamp) && in_array(strtolower($this->autoWriteTimestamp), ['datetime', 'date', 'timestamp'])) {
+        } elseif (is_string($this->autoWriteTimestamp) && in_array(strtolower($this->autoWriteTimestamp), [
+                'datetime',
+                'date',
+                'timestamp'
+            ])
+        ) {
            $value = $this->formatDateTime($_SERVER['REQUEST_TIME'], $this->dateFormat);
        } else {
            $value = $this->formatDateTime($_SERVER['REQUEST_TIME'], $this->dateFormat, true);
@@ -346,9 +341,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 时间日期字段格式化处理
     * @access public
-     * @param mixed  $time 时间日期表达式
-     * @param mixed  $format 日期格式
-     * @param bool   $timestamp 是否进行时间戳转换
+     * @param mixed $time      时间日期表达式
+     * @param mixed $format    日期格式
+     * @param bool  $timestamp 是否进行时间戳转换
     * @return mixed
     */
    protected function formatDateTime($time, $format, $timestamp = false)
@@ -364,8 +359,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 数据写入 类型转换
     * @access public
-     * @param mixed         $value 值
-     * @param string|array  $type 要转换的类型
+     * @param mixed        $value 值
+     * @param string|array $type  要转换的类型
     * @return mixed
     */
    protected function writeTransform($value, $type)
@@ -443,7 +438,12 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
            // 类型转换
            $value = $this->readTransform($value, $this->type[$name]);
        } elseif (in_array($name, [$this->createTime, $this->updateTime])) {
-            if (is_string($this->autoWriteTimestamp) && in_array(strtolower($this->autoWriteTimestamp), ['datetime', 'date', 'timestamp'])) {
+            if (is_string($this->autoWriteTimestamp) && in_array(strtolower($this->autoWriteTimestamp), [
+                    'datetime',
+                    'date',
+                    'timestamp'
+                ])
+            ) {
                $value = $this->formatDateTime(strtotime($value), $this->dateFormat);
            } else {
                $value = $this->formatDateTime($value, $this->dateFormat);
@@ -467,8 +467,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 数据读取 类型转换
     * @access public
-     * @param mixed         $value 值
-     * @param string|array  $type 要转换的类型
+     * @param mixed        $value 值
+     * @param string|array $type  要转换的类型
     * @return mixed
     */
    protected function readTransform($value, $type)
@@ -528,8 +528,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 设置需要追加的输出属性
     * @access public
-     * @param array $append 属性列表
-     * @param bool  $override  是否覆盖
+     * @param array $append   属性列表
+     * @param bool  $override 是否覆盖
     * @return $this
     */
    public function append($append = [], $override = false)
@@ -541,9 +541,10 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 设置附加关联对象的属性
     * @access public
-     * @param string        $relation 关联方法
-     * @param string|array  $append  追加属性名
+     * @param string       $relation 关联方法
+     * @param string|array $append   追加属性名
     * @return $this
+     * @throws Exception
     */
    public function appendRelationAttr($relation, $append)
    {
@@ -567,8 +568,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 设置需要隐藏的输出属性
     * @access public
-     * @param array $hidden 属性列表
-     * @param bool  $override  是否覆盖
+     * @param array $hidden   属性列表
+     * @param bool  $override 是否覆盖
     * @return $this
     */
    public function hidden($hidden = [], $override = false)
@@ -581,7 +582,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
     * 设置需要输出的属性
     * @access public
     * @param array $visible
-     * @param bool  $override  是否覆盖
+     * @param bool  $override 是否覆盖
     * @return $this
     */
    public function visible($visible = [], $override = false)
@@ -624,9 +625,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
     * 转换子模型对象
     * @access protected
     * @param Model|Collection $model
-     * @param $visible
-     * @param $hidden
-     * @param $key
+     * @param                  $visible
+     * @param                  $hidden
+     * @param                  $key
     * @return array
     */
    protected function subToArray($model, $visible, $hidden, $key)
@@ -700,7 +701,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 转换当前模型对象为JSON字符串
     * @access public
-     * @param integer   $options json参数
+     * @param integer $options json参数
     * @return string
     */
    public function toJson($options = JSON_UNESCAPED_UNICODE)
@@ -711,7 +712,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 转换当前模型数据集为数据集对象
     * @access public
-     * @param array|Collection   $collection 数据集
+     * @param array|Collection $collection 数据集
     * @return Collection
     */
    public function toCollection($collection)
@@ -730,7 +731,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 关联数据一起更新
     * @access public
-     * @param mixed   $relation 关联
+     * @param mixed $relation 关联
     * @return $this
     */
    public function together($relation)
@@ -779,9 +780,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 保存当前数据对象
     * @access public
-     * @param array     $data 数据
-     * @param array     $where 更新条件
-     * @param string    $sequence     自增序列名
+     * @param array  $data     数据
+     * @param array  $where    更新条件
+     * @param string $sequence 自增序列名
     * @return integer|false
     */
    public function save($data = [], $where = [], $sequence = null)
@@ -962,9 +963,10 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 保存多个数据到当前数据对象
     * @access public
-     * @param array     $dataSet 数据
-     * @param boolean   $replace 是否自动识别更新和写入
+     * @param array   $dataSet 数据
+     * @param boolean $replace 是否自动识别更新和写入
     * @return array|false
+     * @throws \Exception
     */
    public function saveAll($dataSet, $replace = true)
    {
@@ -1105,8 +1107,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 设置字段验证
     * @access public
-     * @param array|string|bool $rule 验证规则 true表示自动读取验证器类
-     * @param array             $msg 提示信息
+     * @param array|string|bool $rule  验证规则 true表示自动读取验证器类
+     * @param array             $msg   提示信息
     * @param bool              $batch 批量验证
     * @return $this
     */
@@ -1139,8 +1141,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 自动验证数据
     * @access protected
-     * @param array $data 验证数据
-     * @param mixed $rule 验证规则
+     * @param array $data  验证数据
+     * @param mixed $rule  验证规则
     * @param bool  $batch 批量验证
     * @return bool
     */
@@ -1191,9 +1193,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 注册回调方法
     * @access public
-     * @param string        $event 事件名
-     * @param callable      $callback 回调方法
-     * @param bool          $override 是否覆盖
+     * @param string   $event    事件名
+     * @param callable $callback 回调方法
+     * @param bool     $override 是否覆盖
     * @return void
     */
    public static function event($event, $callback, $override = false)
@@ -1208,8 +1210,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 触发事件
     * @access protected
-     * @param string    $event 事件名
-     * @param mixed     $params 传入参数（引用）
+     * @param string $event  事件名
+     * @param mixed  $params 传入参数（引用）
     * @return bool
     */
    protected function trigger($event, &$params)
@@ -1217,7 +1219,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
        if (isset(self::$event[$this->class][$event])) {
            foreach (self::$event[$this->class][$event] as $callback) {
                if (is_callable($callback)) {
-                    $result = call_user_func_array($callback, [ & $params]);
+                    $result = call_user_func_array($callback, [& $params]);
                    if (false === $result) {
                        return false;
                    }
@@ -1230,8 +1232,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 写入数据
     * @access public
-     * @param array         $data 数据数组
-     * @param array|true    $field 允许字段
+     * @param array      $data  数据数组
+     * @param array|true $field 允许字段
     * @return $this
     */
    public static function create($data = [], $field = null)
@@ -1247,9 +1249,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 更新数据
     * @access public
-     * @param array         $data 数据数组
-     * @param array         $where 更新条件
-     * @param array|true    $field 允许字段
+     * @param array      $data  数据数组
+     * @param array      $where 更新条件
+     * @param array|true $field 允许字段
     * @return $this
     */
    public static function update($data = [], $where = [], $field = null)
@@ -1295,9 +1297,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 分析查询表达式
     * @access public
-     * @param mixed         $data 主键列表或者查询条件（闭包）
-     * @param string        $with 关联预查询
-     * @param bool          $cache 是否缓存
+     * @param mixed  $data  主键列表或者查询条件（闭包）
+     * @param string $with  关联预查询
+     * @param bool   $cache 是否缓存
     * @return Query
     */
    protected static function parseQuery(&$data, $with, $cache)
@@ -1307,7 +1309,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
            $result = $result->where($data);
            $data   = null;
        } elseif ($data instanceof \Closure) {
-            call_user_func_array($data, [ & $result]);
+            call_user_func_array($data, [& $result]);
            $data = null;
        } elseif ($data instanceof Query) {
            $result = $data->with($with)->cache($cache);
@@ -1330,7 +1332,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
            $query->where($data);
            $data = null;
        } elseif ($data instanceof \Closure) {
-            call_user_func_array($data, [ & $query]);
+            call_user_func_array($data, [& $query]);
            $data = null;
        } elseif (is_null($data)) {
            return 0;
@@ -1349,9 +1351,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 命名范围
     * @access public
-     * @param string|array|Closure  $name 命名范围名称 逗号分隔
-     * @param mixed                 ...$params 参数调用
-     * @return Model
+     * @param string|array|\Closure $name 命名范围名称 逗号分隔
+     * @internal  mixed                 ...$params 参数调用
+     * @return Model|Query
     */
    public static function scope($name)
    {
@@ -1379,7 +1381,7 @@ abstract class Model implements \JsonSerializable, \ArrayAccess

    /**
     * 设置是否使用全局查询范围
-     * @param bool  $use 是否启用全局查询范围
+     * @param bool $use 是否启用全局查询范围
     * @access public
     * @return Model
     */
@@ -1393,10 +1395,10 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 根据关联条件查询当前模型
     * @access public
-     * @param string    $relation 关联方法名
-     * @param mixed     $operator 比较操作符
-     * @param integer   $count 个数
-     * @param string    $id 关联表的统计字段
+     * @param string  $relation 关联方法名
+     * @param mixed   $operator 比较操作符
+     * @param integer $count    个数
+     * @param string  $id       关联表的统计字段
     * @return Model
     */
    public static function has($relation, $operator = '>=', $count = 1, $id = '*')
@@ -1411,8 +1413,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 根据关联条件查询当前模型
     * @access public
-     * @param string    $relation 关联方法名
-     * @param mixed     $where 查询条件（数组或者闭包）
+     * @param string $relation 关联方法名
+     * @param mixed  $where    查询条件（数组或者闭包）
     * @return Model
     */
    public static function hasWhere($relation, $where = [])
@@ -1470,8 +1472,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 预载入关联查询 返回数据集
     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 关联名
+     * @param array  $resultSet 数据集
+     * @param string $relation  关联名
     * @return array
     */
    public function eagerlyResultSet(&$resultSet, $relation)
@@ -1495,8 +1497,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 预载入关联查询 返回模型对象
     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 关联名
+     * @param Model  $result   数据对象
+     * @param string $relation 关联名
     * @return Model
     */
    public function eagerlyResult(&$result, $relation)
@@ -1521,8 +1523,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 关联统计
     * @access public
-     * @param Model             $result 数据对象
-     * @param string|array      $relation 关联名
+     * @param Model        $result   数据对象
+     * @param string|array $relation 关联名
     * @return void
     */
    public function relationCount(&$result, $relation)
@@ -1558,11 +1560,11 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * HAS ONE 关联定义
     * @access public
-     * @param string $model 模型名
+     * @param string $model      模型名
     * @param string $foreignKey 关联外键
-     * @param string $localKey 关联主键
-     * @param array  $alias 别名定义（已经废弃）
-     * @param string $joinType JOIN类型
+     * @param string $localKey   关联主键
+     * @param array  $alias      别名定义（已经废弃）
+     * @param string $joinType   JOIN类型
     * @return HasOne
     */
    public function hasOne($model, $foreignKey = '', $localKey = '', $alias = [], $joinType = 'INNER')
@@ -1577,11 +1579,11 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * BELONGS TO 关联定义
     * @access public
-     * @param string $model 模型名
+     * @param string $model      模型名
     * @param string $foreignKey 关联外键
-     * @param string $localKey 关联主键
-     * @param array  $alias 别名定义（已经废弃）
-     * @param string $joinType JOIN类型
+     * @param string $localKey   关联主键
+     * @param array  $alias      别名定义（已经废弃）
+     * @param string $joinType   JOIN类型
     * @return BelongsTo
     */
    public function belongsTo($model, $foreignKey = '', $localKey = '', $alias = [], $joinType = 'INNER')
@@ -1596,9 +1598,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * HAS MANY 关联定义
     * @access public
-     * @param string $model 模型名
+     * @param string $model      模型名
     * @param string $foreignKey 关联外键
-     * @param string $localKey 关联主键
+     * @param string $localKey   关联主键
     * @return HasMany
     */
    public function hasMany($model, $foreignKey = '', $localKey = '')
@@ -1613,11 +1615,11 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * HAS MANY 远程关联定义
     * @access public
-     * @param string $model 模型名
-     * @param string $through 中间模型名
+     * @param string $model      模型名
+     * @param string $through    中间模型名
     * @param string $foreignKey 关联外键
     * @param string $throughKey 关联外键
-     * @param string $localKey 关联主键
+     * @param string $localKey   关联主键
     * @return HasManyThrough
     */
    public function hasManyThrough($model, $through, $foreignKey = '', $throughKey = '', $localKey = '')
@@ -1634,10 +1636,10 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * BELONGS TO MANY 关联定义
     * @access public
-     * @param string $model 模型名
-     * @param string $table 中间表名
+     * @param string $model      模型名
+     * @param string $table      中间表名
     * @param string $foreignKey 关联外键
-     * @param string $localKey 当前模型关联键
+     * @param string $localKey   当前模型关联键
     * @return BelongsToMany
     */
    public function belongsToMany($model, $table = '', $foreignKey = '', $localKey = '')
@@ -1654,9 +1656,9 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * MORPH  MANY 关联定义
     * @access public
-     * @param string        $model 模型名
-     * @param string|array  $morph 多态字段信息
-     * @param string        $type 多态类型
+     * @param string       $model 模型名
+     * @param string|array $morph 多态字段信息
+     * @param string       $type  多态类型
     * @return MorphMany
     */
    public function morphMany($model, $morph = null, $type = '')
@@ -1680,8 +1682,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * MORPH TO 关联定义
     * @access public
-     * @param string|array  $morph 多态字段信息
-     * @param array         $alias 多态别名定义
+     * @param string|array $morph 多态字段信息
+     * @param array        $alias 多态别名定义
     * @return MorphTo
     */
    public function morphTo($morph = null, $alias = [])
@@ -1735,8 +1737,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess
    /**
     * 修改器 设置数据对象的值
     * @access public
-     * @param string    $name 名称
-     * @param mixed     $value 值
+     * @param string $name  名称
+     * @param mixed  $value 值
     * @return void
     */
    public function __set($name, $value)
@@ -1829,6 +1831,8 @@ abstract class Model implements \JsonSerializable, \ArrayAccess

    /**
     * 模型事件快捷方法
+     * @param      $callback
+     * @param bool $override
     */
    protected static function beforeInsert($callback, $override = false)
    {
--- a/library/think/model/Merge.php
+++ b/library/think/model/Merge.php
@@ -11,7 +11,6 @@

 namespace think\model;

-use think\Db;
 use think\db\Query;
 use think\Model;

@@ -40,9 +39,9 @@ class Merge extends Model
    /**
     * 查找单条记录
     * @access public
-     * @param mixed     $data 主键值或者查询条件（闭包）
-     * @param string    $with 关联预查询
-     * @param bool      $cache 是否缓存
+     * @param mixed        $data  主键值或者查询条件（闭包）
+     * @param string|array $with  关联预查询
+     * @param bool         $cache 是否缓存
     * @return \think\Model
     */
    public static function get($data = null, $with = [], $cache = false)
@@ -78,11 +77,11 @@ class Merge extends Model
    /**
     * 获取关联模型的字段 并解决混淆
     * @access protected
-     * @param \think\db\Query   $query 查询对象
-     * @param string            $name 模型名称
-     * @param string            $table 关联表名称
-     * @param array             $map 字段映射
-     * @param array             $fields 查询字段
+     * @param \think\db\Query $query  查询对象
+     * @param string          $name   模型名称
+     * @param string          $table  关联表名称
+     * @param array           $map    字段映射
+     * @param array           $fields 查询字段
     * @return array
     */
    protected static function getModelField($query, $name, $table = '', $map = [], $fields = [])
@@ -104,8 +103,9 @@ class Merge extends Model
    /**
     * 查找所有记录
     * @access public
-     * @param mixed     $data 主键列表或者查询条件（闭包）
-     * @param string    $with 关联预查询
+     * @param mixed        $data 主键列表或者查询条件（闭包）
+     * @param array|string $with 关联预查询
+     * @param bool         $cache
     * @return array|false|string
     */
    public static function all($data = null, $with = [], $cache = false)
@@ -118,10 +118,10 @@ class Merge extends Model
    /**
     * 处理写入的模型数据
     * @access public
-     * @param string    $model 模型名称
-     * @param array     $data 数据
-     * @param bool      $insert 是否新增
-     * @return void
+     * @param string $model  模型名称
+     * @param array  $data   数据
+     * @param bool   $insert 是否新增
+     * @return array
     */
    protected function parseData($model, $data, $insert = false)
    {
@@ -144,10 +144,11 @@ class Merge extends Model
    /**
     * 保存模型数据 以及关联数据
     * @access public
-     * @param mixed     $data 数据
-     * @param array     $where 更新条件
-     * @param string    $sequence     自增序列名
-     * @return integer|false
+     * @param mixed  $data     数据
+     * @param array  $where    更新条件
+     * @param string $sequence 自增序列名
+     * @return false|int
+     * @throws \Exception
     */
    public function save($data = [], $where = [], $sequence = null)
    {
@@ -278,7 +279,8 @@ class Merge extends Model
    /**
     * 删除当前的记录 并删除关联数据
     * @access public
-     * @return integer
+     * @return int
+     * @throws \Exception
     */
    public function delete()
    {
--- a/library/think/model/Relation.php
+++ b/library/think/model/Relation.php
@@ -15,13 +15,19 @@ use think\db\Query;
 use think\Exception;
 use think\Model;

+/**
+ * Class Relation
+ * @package think\model
+ *
+ * @mixin Query
+ */
 abstract class Relation
 {
    // 父模型对象
    protected $parent;
    /** @var  Model 当前关联的模型类 */
    protected $model;
-    // 关联模型查询对象
+    /** @var Query 关联模型查询对象 */
    protected $query;
    // 关联表外键
    protected $foreignKey;
@@ -65,7 +71,7 @@ abstract class Relation
    /**
     * 封装关联数据集
     * @access public
-     * @param array     $resultSet 数据集
+     * @param array $resultSet 数据集
     * @return mixed
     */
    protected function resultSetBuild($resultSet)
@@ -84,6 +90,13 @@ abstract class Relation
        return $this;
    }

+    /**
+     * 执行基础查询（进执行一次）
+     * @access protected
+     * @return void
+     */
+    abstract protected function baseQuery();
+
    public function __call($method, $args)
    {
        if ($this->query) {
--- a/library/think/model/relation/BelongsTo.php
+++ b/library/think/model/relation/BelongsTo.php
@@ -37,9 +37,10 @@ class BelongsTo extends OneToOne

    /**
     * 延迟获取关联数据
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包查询条件
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包查询条件
     * @access public
+     * @return array|false|\PDOStatement|string|Model
     */
    public function getRelation($subRelation = '', $closure = null)
    {
--- a/library/think/model/relation/BelongsToMany.php
+++ b/library/think/model/relation/BelongsToMany.php
@@ -11,7 +11,6 @@

 namespace think\model\relation;

-use think\Db;
 use think\db\Query;
 use think\Exception;
 use think\Loader;
@@ -27,11 +26,11 @@ class BelongsToMany extends Relation
    /**
     * 架构函数
     * @access public
-     * @param Model  $parent 上级模型对象
-     * @param string $model 模型名
-     * @param string $table 中间表名
+     * @param Model  $parent     上级模型对象
+     * @param string $model      模型名
+     * @param string $table      中间表名
     * @param string $foreignKey 关联模型外键
-     * @param string $localKey 当前模型关联键
+     * @param string $localKey   当前模型关联键
     */
    public function __construct(Model $parent, $model, $table, $foreignKey, $localKey)
    {
@@ -45,9 +44,9 @@ class BelongsToMany extends Relation

    /**
     * 延迟获取关联数据
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包查询条件
-     * @access public
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包查询条件
+     * @return false|\PDOStatement|string|\think\Collection
     */
    public function getRelation($subRelation = '', $closure = null)
    {
@@ -55,7 +54,7 @@ class BelongsToMany extends Relation
        $localKey   = $this->localKey;
        $middle     = $this->middle;
        if ($closure) {
-            call_user_func_array($closure, [ & $this->query]);
+            call_user_func_array($closure, [& $this->query]);
        }
        // 关联查询
        $pk                              = $this->parent->getPk();
@@ -80,10 +79,10 @@ class BelongsToMany extends Relation
    /**
     * 预载入关联查询（数据集）
     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param array    $resultSet   数据集
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResultSet(&$resultSet, $relation, $subRelation, $closure)
@@ -124,10 +123,10 @@ class BelongsToMany extends Relation
    /**
     * 预载入关联查询（单个数据）
     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param Model    $result      数据对象
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResult(&$result, $relation, $subRelation, $closure)
@@ -149,8 +148,8 @@ class BelongsToMany extends Relation
    /**
     * 关联统计
     * @access public
-     * @param Model     $result 数据对象
-     * @param \Closure  $closure 闭包
+     * @param Model    $result  数据对象
+     * @param \Closure $closure 闭包
     * @return integer
     */
    public function relationCount($result, $closure)
@@ -167,20 +166,25 @@ class BelongsToMany extends Relation
    /**
     * 获取关联统计子查询
     * @access public
-     * @param \Closure  $closure 闭包
+     * @param \Closure $closure 闭包
     * @return string
     */
    public function getRelationCountQuery($closure)
    {
-        return $this->belongsToManyQuery($this->middle, $this->foreignKey, $this->localKey, ['pivot.' . $this->localKey => ['exp', '=' . $this->parent->getTable() . '.' . $this->parent->getPk()]])->fetchSql()->count();
+        return $this->belongsToManyQuery($this->middle, $this->foreignKey, $this->localKey, [
+            'pivot.' . $this->localKey => [
+                'exp',
+                '=' . $this->parent->getTable() . '.' . $this->parent->getPk()
+            ]
+        ])->fetchSql()->count();
    }

    /**
     * 多对多 关联模型预查询
     * @access public
-     * @param array     $where 关联预查询条件
-     * @param string    $relation 关联名
-     * @param string    $subRelation 子关联
+     * @param array  $where       关联预查询条件
+     * @param string $relation    关联名
+     * @param string $subRelation 子关联
     * @return array
     */
    protected function eagerlyManyToMany($where, $relation, $subRelation = '')
@@ -210,10 +214,10 @@ class BelongsToMany extends Relation
    /**
     * BELONGS TO MANY 关联查询
     * @access public
-     * @param string    $table 中间表名
-     * @param string    $foreignKey 关联模型关联键
-     * @param string    $localKey 当前模型关联键
-     * @param array     $condition 关联查询条件
+     * @param string $table      中间表名
+     * @param string $foreignKey 关联模型关联键
+     * @param string $localKey   当前模型关联键
+     * @param array  $condition  关联查询条件
     * @return Query
     */
    protected function belongsToManyQuery($table, $foreignKey, $localKey, $condition = [])
@@ -230,8 +234,8 @@ class BelongsToMany extends Relation
    /**
     * 保存（新增）当前关联数据对象
     * @access public
-     * @param mixed     $data 数据 可以使用数组 关联模型对象 和 关联对象的主键
-     * @param array     $pivot 中间表额外数据
+     * @param mixed $data  数据 可以使用数组 关联模型对象 和 关联对象的主键
+     * @param array $pivot 中间表额外数据
     * @return integer
     */
    public function save($data, array $pivot = [])
@@ -243,9 +247,9 @@ class BelongsToMany extends Relation
    /**
     * 批量保存当前关联数据对象
     * @access public
-     * @param array     $dataSet 数据集
-     * @param array     $pivot 中间表额外数据
-     * @param bool      $samePivot 额外数据是否相同
+     * @param array $dataSet   数据集
+     * @param array $pivot     中间表额外数据
+     * @param bool  $samePivot 额外数据是否相同
     * @return integer
     */
    public function saveAll(array $dataSet, array $pivot = [], $samePivot = false)
@@ -265,9 +269,10 @@ class BelongsToMany extends Relation
    /**
     * 附加关联的一个中间表数据
     * @access public
-     * @param mixed     $data 数据 可以使用数组、关联模型对象 或者 关联对象的主键
-     * @param array     $pivot 中间表额外数据
-     * @return integer
+     * @param mixed $data  数据 可以使用数组、关联模型对象 或者 关联对象的主键
+     * @param array $pivot 中间表额外数据
+     * @return int
+     * @throws Exception
     */
    public function attach($data, $pivot = [])
    {
@@ -307,8 +312,8 @@ class BelongsToMany extends Relation
    /**
     * 解除关联的一个中间表数据
     * @access public
-     * @param integer|array     $data 数据 可以使用关联对象的主键
-     * @param bool              $relationDel 是否同时删除关联表数据
+     * @param integer|array $data        数据 可以使用关联对象的主键
+     * @param bool          $relationDel 是否同时删除关联表数据
     * @return integer
     */
    public function detach($data = null, $relationDel = false)
--- a/library/think/model/relation/HasMany.php
+++ b/library/think/model/relation/HasMany.php
@@ -22,10 +22,10 @@ class HasMany extends Relation
    /**
     * 架构函数
     * @access public
-     * @param Model  $parent 上级模型对象
-     * @param string $model 模型名
+     * @param Model  $parent     上级模型对象
+     * @param string $model      模型名
     * @param string $foreignKey 关联外键
-     * @param string $localKey 关联主键
+     * @param string $localKey   关联主键
     */
    public function __construct(Model $parent, $model, $foreignKey, $localKey)
    {
@@ -38,26 +38,25 @@ class HasMany extends Relation

    /**
     * 延迟获取关联数据
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包查询条件
-     * @access public
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包查询条件
+     * @return false|\PDOStatement|string|\think\Collection
     */
    public function getRelation($subRelation = '', $closure = null)
    {
        if ($closure) {
-            call_user_func_array($closure, [ & $this->query]);
+            call_user_func_array($closure, [& $this->query]);
        }
        return $this->relation($subRelation)->select();
    }

    /**
     * 预载入关联查询
-     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
-     * @param string    $class 数据集对象名 为空表示数组
+     * @access   public
+     * @param array    $resultSet   数据集
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResultSet(&$resultSet, $relation, $subRelation, $closure)
@@ -92,12 +91,11 @@ class HasMany extends Relation

    /**
     * 预载入关联查询
-     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
-     * @param string    $class 数据集对象名 为空表示数组
+     * @access   public
+     * @param Model    $result      数据对象
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResult(&$result, $relation, $subRelation, $closure)
@@ -117,8 +115,8 @@ class HasMany extends Relation
    /**
     * 关联统计
     * @access public
-     * @param Model     $result 数据对象
-     * @param \Closure  $closure 闭包
+     * @param Model    $result  数据对象
+     * @param \Closure $closure 闭包
     * @return integer
     */
    public function relationCount($result, $closure)
@@ -127,7 +125,7 @@ class HasMany extends Relation
        $count    = 0;
        if (isset($result->$localKey)) {
            if ($closure) {
-                call_user_func_array($closure, [ & $this->query]);
+                call_user_func_array($closure, [& $this->query]);
            }
            $count = $this->query->where([$this->foreignKey => $result->$localKey])->count();
        }
@@ -137,26 +135,31 @@ class HasMany extends Relation
    /**
     * 创建关联统计子查询
     * @access public
-     * @param \Closure  $closure 闭包
+     * @param \Closure $closure 闭包
     * @return string
     */
    public function getRelationCountQuery($closure)
    {
        if ($closure) {
-            call_user_func_array($closure, [ & $this->query]);
+            call_user_func_array($closure, [& $this->query]);
        }

-        return $this->query->where([$this->foreignKey => ['exp', '=' . $this->parent->getTable() . '.' . $this->parent->getPk()]])->fetchSql()->count();
+        return $this->query->where([
+            $this->foreignKey => [
+                'exp',
+                '=' . $this->parent->getTable() . '.' . $this->parent->getPk()
+            ]
+        ])->fetchSql()->count();
    }

    /**
     * 一对多 关联模型预查询
     * @access public
-     * @param object    $model 关联模型对象
-     * @param array     $where 关联预查询条件
-     * @param string    $relation 关联名
-     * @param string    $subRelation 子关联
-     * @param bool      $closure
+     * @param object $model       关联模型对象
+     * @param array  $where       关联预查询条件
+     * @param string $relation    关联名
+     * @param string $subRelation 子关联
+     * @param bool   $closure
     * @return array
     */
    protected function eagerlyOneToMany($model, $where, $relation, $subRelation = '', $closure = false)
@@ -164,7 +167,7 @@ class HasMany extends Relation
        $foreignKey = $this->foreignKey;
        // 预载入关联查询 支持嵌套预载入
        if ($closure) {
-            call_user_func_array($closure, [ & $model]);
+            call_user_func_array($closure, [& $model]);
        }
        $list = $model->where($where)->with($subRelation)->select();

@@ -179,7 +182,7 @@ class HasMany extends Relation
    /**
     * 保存（新增）当前关联数据对象
     * @access public
-     * @param mixed     $data 数据 可以使用数组 关联模型对象 和 关联对象的主键
+     * @param mixed $data 数据 可以使用数组 关联模型对象 和 关联对象的主键
     * @return integer
     */
    public function save($data)
@@ -196,7 +199,7 @@ class HasMany extends Relation
    /**
     * 批量保存当前关联数据对象
     * @access public
-     * @param array     $dataSet 数据集
+     * @param array $dataSet 数据集
     * @return integer
     */
    public function saveAll(array $dataSet)
@@ -211,9 +214,9 @@ class HasMany extends Relation
    /**
     * 根据关联条件查询当前模型
     * @access public
-     * @param string    $operator 比较操作符
-     * @param integer   $count 个数
-     * @param string    $id 关联表的统计字段
+     * @param string  $operator 比较操作符
+     * @param integer $count    个数
+     * @param string  $id       关联表的统计字段
     * @return Query
     */
    public function has($operator = '>=', $count = 1, $id = '*')
@@ -228,7 +231,7 @@ class HasMany extends Relation
    /**
     * 根据关联条件查询当前模型
     * @access public
-     * @param mixed    $where 查询条件（数组或者闭包）
+     * @param mixed $where 查询条件（数组或者闭包）
     * @return Query
     */
    public function hasWhere($where = [])
--- a/library/think/model/relation/HasManyThrough.php
+++ b/library/think/model/relation/HasManyThrough.php
@@ -26,13 +26,13 @@ class HasManyThrough extends Relation

    /**
     * 架构函数
-     * @access public
-     * @param Model  $parent 上级模型对象
-     * @param string $model 模型名
-     * @param string $through 中间模型名
-     * @param string $firstkey 关联外键
-     * @param string $secondKey 关联外键
-     * @param string $localKey 关联主键
+     * @access   public
+     * @param Model  $parent     上级模型对象
+     * @param string $model      模型名
+     * @param string $through    中间模型名
+     * @param string $foreignKey 关联外键
+     * @param string $throughKey 关联外键
+     * @param string $localKey   关联主键
     */
    public function __construct(Model $parent, $model, $through, $foreignKey, $throughKey, $localKey)
    {
@@ -47,14 +47,14 @@ class HasManyThrough extends Relation

    /**
     * 延迟获取关联数据
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包查询条件
-     * @access public
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包查询条件
+     * @return false|\PDOStatement|string|\think\Collection
     */
    public function getRelation($subRelation = '', $closure = null)
    {
        if ($closure) {
-            call_user_func_array($closure, [ & $this->query]);
+            call_user_func_array($closure, [& $this->query]);
        }
        return $this->relation($subRelation)->select();
    }
@@ -62,38 +62,41 @@ class HasManyThrough extends Relation
    /**
     * 预载入关联查询
     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
-     * @param string    $class 数据集对象名 为空表示数组
+     * @param array    $resultSet   数据集
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
+     * @param string   $class       数据集对象名 为空表示数组
     * @return void
     */
    public function eagerlyResultSet(&$resultSet, $relation, $subRelation, $closure, $class)
-    {}
+    {
+    }

    /**
     * 预载入关联查询 返回模型对象
     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
-     * @param string    $class 数据集对象名 为空表示数组
+     * @param Model    $result      数据对象
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
+     * @param string   $class       数据集对象名 为空表示数组
     * @return void
     */
    public function eagerlyResult(&$result, $relation, $subRelation, $closure, $class)
-    {}
+    {
+    }

    /**
     * 关联统计
     * @access public
-     * @param Model     $result 数据对象
-     * @param \Closure  $closure 闭包
+     * @param Model    $result  数据对象
+     * @param \Closure $closure 闭包
     * @return integer
     */
    public function relationCount($result, $closure)
-    {}
+    {
+    }

    /**
     * 执行基础查询（进执行一次）
--- a/library/think/model/relation/HasOne.php
+++ b/library/think/model/relation/HasOne.php
@@ -11,6 +11,7 @@

 namespace think\model\relation;

+use think\db\Query;
 use think\Loader;
 use think\Model;

@@ -19,11 +20,11 @@ class HasOne extends OneToOne
    /**
     * 架构函数
     * @access public
-     * @param Model $parent 上级模型对象
-     * @param string $model 模型名
+     * @param Model  $parent     上级模型对象
+     * @param string $model      模型名
     * @param string $foreignKey 关联外键
-     * @param string $localKey 关联主键
-     * @param string $joinType JOIN类型
+     * @param string $localKey   关联主键
+     * @param string $joinType   JOIN类型
     */
    public function __construct(Model $parent, $model, $foreignKey, $localKey, $joinType = 'INNER')
    {
@@ -37,16 +38,16 @@ class HasOne extends OneToOne

    /**
     * 延迟获取关联数据
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包查询条件
-     * @access public
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包查询条件
+     * @return array|false|\PDOStatement|string|Model
     */
    public function getRelation($subRelation = '', $closure = null)
    {
        // 执行关联定义方法
        $localKey = $this->localKey;
        if ($closure) {
-            call_user_func_array($closure, [ & $this->query]);
+            call_user_func_array($closure, [& $this->query]);
        }
        // 判断关联类型执行查询
        return $this->query->where($this->foreignKey, $this->parent->$localKey)->relation($subRelation)->find();
@@ -55,7 +56,7 @@ class HasOne extends OneToOne
    /**
     * 根据关联条件查询当前模型
     * @access public
-     * @param mixed    $where 查询条件（数组或者闭包）
+     * @param mixed $where 查询条件（数组或者闭包）
     * @return Query
     */
    public function hasWhere($where = [])
@@ -80,10 +81,10 @@ class HasOne extends OneToOne
    /**
     * 预载入关联查询（数据集）
     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param array    $resultSet   数据集
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    protected function eagerlySet(&$resultSet, $relation, $subRelation, $closure)
@@ -129,10 +130,10 @@ class HasOne extends OneToOne
    /**
     * 预载入关联查询（数据）
     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param Model    $result      数据对象
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    protected function eagerlyOne(&$result, $relation, $subRelation, $closure)
--- a/library/think/model/relation/MorphMany.php
+++ b/library/think/model/relation/MorphMany.php
@@ -28,11 +28,11 @@ class MorphMany extends Relation
    /**
     * 架构函数
     * @access public
-     * @param Model  $parent 上级模型对象
-     * @param string $model 模型名
-     * @param string $morphKey 关联外键
+     * @param Model  $parent    上级模型对象
+     * @param string $model     模型名
+     * @param string $morphKey  关联外键
     * @param string $morphType 多态字段名
-     * @param string $type 多态类型
+     * @param string $type      多态类型
     */
    public function __construct(Model $parent, $model, $morphKey, $morphType, $type)
    {
@@ -46,14 +46,14 @@ class MorphMany extends Relation

    /**
     * 延迟获取关联数据
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包查询条件
-     * @access public
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包查询条件
+     * @return false|\PDOStatement|string|\think\Collection
     */
    public function getRelation($subRelation = '', $closure = null)
    {
        if ($closure) {
-            call_user_func_array($closure, [ & $this->query]);
+            call_user_func_array($closure, [& $this->query]);
        }
        return $this->relation($subRelation)->select();
    }
@@ -61,10 +61,10 @@ class MorphMany extends Relation
    /**
     * 预载入关联查询
     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param array    $resultSet   数据集
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResultSet(&$resultSet, $relation, $subRelation, $closure)
@@ -101,17 +101,20 @@ class MorphMany extends Relation
    /**
     * 预载入关联查询
     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param Model    $result      数据对象
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResult(&$result, $relation, $subRelation, $closure)
    {
        $pk = $result->getPk();
        if (isset($result->$pk)) {
-            $data = $this->eagerlyMorphToMany([$this->morphKey => $result->$pk, $this->morphType => $this->type], $relation, $subRelation, $closure);
+            $data = $this->eagerlyMorphToMany([
+                $this->morphKey  => $result->$pk,
+                $this->morphType => $this->type
+            ], $relation, $subRelation, $closure);
            $result->setAttr(Loader::parseName($relation), $this->resultSetBuild($data[$result->$pk]));
        }
    }
@@ -119,8 +122,8 @@ class MorphMany extends Relation
    /**
     * 关联统计
     * @access public
-     * @param Model     $result 数据对象
-     * @param \Closure  $closure 闭包
+     * @param Model    $result  数据对象
+     * @param \Closure $closure 闭包
     * @return integer
     */
    public function relationCount($result, $closure)
@@ -129,7 +132,7 @@ class MorphMany extends Relation
        $count = 0;
        if (isset($result->$pk)) {
            if ($closure) {
-                call_user_func_array($closure, [ & $this->query]);
+                call_user_func_array($closure, [& $this->query]);
            }
            $count = $this->query->where([$this->morphKey => $result->$pk, $this->morphType => $this->type])->count();
        }
@@ -139,33 +142,38 @@ class MorphMany extends Relation
    /**
     * 获取关联统计子查询
     * @access public
-     * @param \Closure  $closure 闭包
+     * @param \Closure $closure 闭包
     * @return string
     */
    public function getRelationCountQuery($closure)
    {
        if ($closure) {
-            call_user_func_array($closure, [ & $this->query]);
+            call_user_func_array($closure, [& $this->query]);
        }

-        return $this->query->where([$this->morphKey => ['exp', '=' . $this->parent->getTable() . '.' . $this->parent->getPk()], $this->morphType => $this->type])->fetchSql()->count();
+        return $this->query->where([
+            $this->morphKey  => [
+                'exp',
+                '=' . $this->parent->getTable() . '.' . $this->parent->getPk()
+            ],
+            $this->morphType => $this->type
+        ])->fetchSql()->count();
    }

    /**
     * 多态一对多 关联模型预查询
-     * @access public
-     * @param object    $model 关联模型对象
-     * @param array     $where 关联预查询条件
-     * @param string    $relation 关联名
-     * @param string    $subRelation 子关联
-     * @param \Closure  $closure 闭包
+     * @access   public
+     * @param array         $where       关联预查询条件
+     * @param string        $relation    关联名
+     * @param string        $subRelation 子关联
+     * @param bool|\Closure $closure     闭包
     * @return array
     */
    protected function eagerlyMorphToMany($where, $relation, $subRelation = '', $closure = false)
    {
        // 预载入关联查询 支持嵌套预载入
        if ($closure) {
-            call_user_func_array($closure, [ & $this]);
+            call_user_func_array($closure, [& $this]);
        }
        $list     = $this->query->where($where)->with($subRelation)->select();
        $morphKey = $this->morphKey;
@@ -180,7 +188,7 @@ class MorphMany extends Relation
    /**
     * 保存（新增）当前关联数据对象
     * @access public
-     * @param mixed     $data 数据 可以使用数组 关联模型对象 和 关联对象的主键
+     * @param mixed $data 数据 可以使用数组 关联模型对象 和 关联对象的主键
     * @return integer
     */
    public function save($data)
@@ -200,7 +208,7 @@ class MorphMany extends Relation
    /**
     * 批量保存当前关联数据对象
     * @access public
-     * @param array     $dataSet 数据集
+     * @param array $dataSet 数据集
     * @return integer
     */
    public function saveAll(array $dataSet)
--- a/library/think/model/relation/MorphTo.php
+++ b/library/think/model/relation/MorphTo.php
@@ -27,10 +27,10 @@ class MorphTo extends Relation
    /**
     * 架构函数
     * @access public
-     * @param Model  $parent 上级模型对象
+     * @param Model  $parent    上级模型对象
     * @param string $morphType 多态字段名
-     * @param string $morphKey 外键名
-     * @param array  $alias 多态别名定义
+     * @param string $morphKey  外键名
+     * @param array  $alias     多态别名定义
     */
    public function __construct(Model $parent, $morphType, $morphKey, $alias = [])
    {
@@ -42,9 +42,9 @@ class MorphTo extends Relation

    /**
     * 延迟获取关联数据
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包查询条件
-     * @access public
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包查询条件
+     * @return mixed
     */
    public function getRelation($subRelation = '', $closure = null)
    {
@@ -80,7 +80,7 @@ class MorphTo extends Relation
    /**
     * 设置多态别名
     * @access public
-     * @param array  $alias 别名定义
+     * @param array $alias 别名定义
     * @return $this
     */
    public function setAlias($alias)
@@ -92,11 +92,12 @@ class MorphTo extends Relation
    /**
     * 预载入关联查询
     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param array    $resultSet   数据集
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
+     * @throws Exception
     */
    public function eagerlyResultSet(&$resultSet, $relation, $subRelation, $closure)
    {
@@ -140,10 +141,10 @@ class MorphTo extends Relation
    /**
     * 预载入关联查询
     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param Model    $result      数据对象
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResult(&$result, $relation, $subRelation, $closure)
@@ -158,20 +159,21 @@ class MorphTo extends Relation
    /**
     * 关联统计
     * @access public
-     * @param Model     $result 数据对象
-     * @param \Closure  $closure 闭包
+     * @param Model    $result  数据对象
+     * @param \Closure $closure 闭包
     * @return integer
     */
    public function relationCount($result, $closure)
-    {}
+    {
+    }

    /**
     * 多态MorphTo 关联模型预查询
-     * @access public
-     * @param object    $model 关联模型对象
-     * @param array     $where 关联预查询条件
-     * @param string    $relation 关联名
-     * @param string    $subRelation 子关联
+     * @access   public
+     * @param object $model       关联模型对象
+     * @param string $relation    关联名
+     * @param        $result
+     * @param string $subRelation 子关联
     * @return void
     */
    protected function eagerlyMorphToOne($model, $relation, &$result, $subRelation = '')
--- a/library/think/model/relation/OneToOne.php
+++ b/library/think/model/relation/OneToOne.php
@@ -20,8 +20,6 @@ use think\model\Relation;
 /**
 * Class OneToOne
 * @package think\model\relation
- * @method void eagerlySet(array $resultSet, string $relation, string $subRelation, \Closure $closure) 预载入关联查询（数据集）
- * @method void eagerlyOne(Model $result, string $relation, string $subRelation, \Closure $closure) 预载入关联查询（数据）
 *
 */
 abstract class OneToOne extends Relation
@@ -36,7 +34,7 @@ abstract class OneToOne extends Relation
    /**
     * 设置join类型
     * @access public
-     * @param string  $type JOIN类型
+     * @param string $type JOIN类型
     * @return $this
     */
    public function joinType($type)
@@ -48,11 +46,11 @@ abstract class OneToOne extends Relation
    /**
     * 预载入关联查询（JOIN方式）
     * @access public
-     * @param Query     $query 查询对象
-     * @param string    $relation 关联名
-     * @param string    $subRelation 子关联
-     * @param \Closure  $closure 闭包条件
-     * @param bool      $first
+     * @param Query    $query       查询对象
+     * @param string   $relation    关联名
+     * @param string   $subRelation 子关联
+     * @param \Closure $closure     闭包条件
+     * @param bool     $first
     * @return void
     */
    public function eagerly(Query $query, $relation, $subRelation, $closure, $first)
@@ -85,7 +83,7 @@ abstract class OneToOne extends Relation

        if ($closure) {
            // 执行闭包查询
-            call_user_func_array($closure, [ & $query]);
+            call_user_func_array($closure, [& $query]);
            // 使用withField指定获取关联的字段，如
            // $query->where(['id'=>1])->withField('id,name');
            if ($query->getOptions('with_field')) {
@@ -100,13 +98,33 @@ abstract class OneToOne extends Relation
        $query->field($field, false, $joinTable, $joinAlias, $relation . '__');
    }

+    /**
+     *  预载入关联查询（数据集）
+     * @param array    $resultSet
+     * @param string   $relation
+     * @param string   $subRelation
+     * @param \Closure $closure
+     * @return mixed
+     */
+    abstract protected function eagerlySet(&$resultSet, $relation, $subRelation, $closure);
+
+    /**
+     * 预载入关联查询（数据）
+     * @param Model    $result
+     * @param string   $relation
+     * @param string   $subRelation
+     * @param \Closure $closure
+     * @return mixed
+     */
+    abstract protected function eagerlyOne(&$result, $relation, $subRelation, $closure);
+
    /**
     * 预载入关联查询（数据集）
     * @access public
-     * @param array     $resultSet 数据集
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param array    $resultSet   数据集
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResultSet(&$resultSet, $relation, $subRelation, $closure)
@@ -125,10 +143,10 @@ abstract class OneToOne extends Relation
    /**
     * 预载入关联查询（数据）
     * @access public
-     * @param Model     $result 数据对象
-     * @param string    $relation 当前关联名
-     * @param string    $subRelation 子关联名
-     * @param \Closure  $closure 闭包
+     * @param Model    $result      数据对象
+     * @param string   $relation    当前关联名
+     * @param string   $subRelation 子关联名
+     * @param \Closure $closure     闭包
     * @return void
     */
    public function eagerlyResult(&$result, $relation, $subRelation, $closure)
@@ -145,7 +163,7 @@ abstract class OneToOne extends Relation
    /**
     * 保存（新增）当前关联数据对象
     * @access public
-     * @param mixed     $data 数据 可以使用数组 关联模型对象 和 关联对象的主键
+     * @param mixed $data 数据 可以使用数组 关联模型对象 和 关联对象的主键
     * @return integer
     */
    public function save($data)
@@ -162,8 +180,8 @@ abstract class OneToOne extends Relation
    /**
     * 设置预载入方式
     * @access public
-     * @param integer     $type 预载入方式 0 JOIN查询 1 IN查询
-     * @return this
+     * @param integer $type 预载入方式 0 JOIN查询 1 IN查询
+     * @return $this
     */
    public function setEagerlyType($type)
    {
@@ -185,8 +203,8 @@ abstract class OneToOne extends Relation
    /**
     * 绑定关联表的属性到父模型属性
     * @access public
-     * @param mixed    $attr 要绑定的属性列表
-     * @return this
+     * @param mixed $attr 要绑定的属性列表
+     * @return $this
     */
    public function bind($attr)
    {
@@ -200,19 +218,20 @@ abstract class OneToOne extends Relation
    /**
     * 关联统计
     * @access public
-     * @param Model     $result 数据对象
-     * @param \Closure  $closure 闭包
+     * @param Model    $result  数据对象
+     * @param \Closure $closure 闭包
     * @return integer
     */
    public function relationCount($result, $closure)
-    {}
+    {
+    }

    /**
     * 一对一 关联模型预查询拼装
     * @access public
-     * @param string    $model 模型名称
-     * @param string    $relation 关联名
-     * @param Model     $result 模型对象实例
+     * @param string $model    模型名称
+     * @param string $relation 关联名
+     * @param Model  $result   模型对象实例
     * @return void
     */
    protected function match($model, $relation, &$result)
@@ -239,10 +258,11 @@ abstract class OneToOne extends Relation
    /**
     * 绑定关联属性到父模型
     * @access protected
-     * @param Model    $model 关联模型对象
-     * @param Model    $result 父模型对象
-     * @param array    $bindAttr 绑定属性
+     * @param Model $model    关联模型对象
+     * @param Model $result   父模型对象
+     * @param array $bindAttr 绑定属性
     * @return void
+     * @throws Exception
     */
    protected function bindAttr($model, &$result, $bindAttr)
    {
@@ -259,19 +279,19 @@ abstract class OneToOne extends Relation
    /**
     * 一对一 关联模型预查询（IN方式）
     * @access public
-     * @param object    $model 关联模型对象
-     * @param array     $where 关联预查询条件
-     * @param string    $key 关联键名
-     * @param string    $relation 关联名
-     * @param string    $subRelation 子关联
-     * @param bool      $closure
+     * @param object        $model       关联模型对象
+     * @param array         $where       关联预查询条件
+     * @param string        $key         关联键名
+     * @param string        $relation    关联名
+     * @param string        $subRelation 子关联
+     * @param bool|\Closure $closure
     * @return array
     */
    protected function eagerlyWhere($model, $where, $key, $relation, $subRelation = '', $closure = false)
    {
        // 预载入关联查询 支持嵌套预载入
        if ($closure) {
-            call_user_func_array($closure, [ & $model]);
+            call_user_func_array($closure, [& $model]);
            if ($field = $model->getOptions('with_field')) {
                $model->field($field)->removeOption('with_field');
            }