注释和参数类型完善

src/DbManager.php

@@ -264,7 +264,7 @@ protected function getConnectionConfig(string $name): array
     /**
      * 创建连接.
      *
-     * @param $name
+     * @param string $name
      *
      * @return ConnectionInterface
      */
@@ -295,7 +295,7 @@ protected function createConnection(string $name): ConnectionInterface
      * 使用表达式设置数据.
      *
      * @param string $value 表达式
-     *
+     * @param array  $bind  绑定参数
      * @return Raw
      */
     public function raw(string $value, array $bind = []): Raw

src/Model.php

@@ -598,8 +598,8 @@ public function dec(string $field, float $step = 1)
     /**
      * 保存当前数据对象
      *
-     * @param array|object  $data     数据
-     * @param string $sequence 自增序列名
+     * @param array|object $data     数据
+     * @param string|null  $sequence 自增序列名
      *
      * @return bool
      */
@@ -754,7 +754,7 @@ protected function updateData(): bool
     /**
      * 新增写入数据.
      *
-     * @param string $sequence 自增名
+     * @param string|null $sequence 自增名
      *
      * @return bool
      */
@@ -1115,7 +1115,7 @@ public function offsetGet(mixed $name): mixed
     /**
      * 设置不使用的全局查询范围.
      *
-     * @param array $scope 不启用的全局查询范围
+     * @param array|null $scope 不启用的全局查询范围
      *
      * @return Query
      */

src/Paginator.php

@@ -137,12 +137,12 @@ public function __construct($items, int $listRows, int $currentPage = 1, ?int $t
     }
 
     /**
-     * @param mixed $items
-     * @param int   $listRows
-     * @param int   $currentPage
-     * @param int   $total
-     * @param bool  $simple
-     * @param array $options
+     * @param mixed    $items
+     * @param int      $listRows
+     * @param int      $currentPage
+     * @param int|null $total
+     * @param bool     $simple
+     * @param array    $options
      *
      * @return Paginator
      */

src/db/BaseQuery.php

@@ -1445,8 +1445,8 @@ public function select(array $data = []): Collection
     /**
      * 查找单条记录.
      *
-     * @param mixed   $data 主键数据
-     * @param Closure $closure 闭包数据
+     * @param mixed        $data    主键数据
+     * @param Closure|null $closure 闭包数据
      *
      * @throws Exception
      * @throws ModelNotFoundException

src/db/CacheItem.php

@@ -47,7 +47,7 @@ class CacheItem
     /**
      * 缓存tag.
      *
-     * @var string
+     * @var string|array|null
      */
     protected $tag;
 
@@ -104,7 +104,7 @@ public function getExpire()
     /**
      * 获取缓存Tag.
      *
-     * @return string|array
+     * @return string|array|null
      */
     public function getTag()
     {
@@ -149,7 +149,7 @@ public function set($value)
     /**
      * 为此缓存项设置所属标签.
      *
-     * @param string|array $tag
+     * @param string|array|null $tag
      *
      * @return $this
      */

src/db/ConnectionInterface.php

@@ -217,8 +217,8 @@ public function getLastSql(): string;
     /**
      * 获取最近插入的ID.
      *
-     * @param BaseQuery $query    查询对象
-     * @param string    $sequence 自增序列名
+     * @param BaseQuery   $query    查询对象
+     * @param string|null $sequence 自增序列名
      *
      * @return mixed
      */

src/db/Fetch.php

@@ -193,8 +193,8 @@ public function save(array $data = [], bool $forceInsert = false): string
     /**
      * 批量插入记录.
      *
-     * @param array $dataSet 数据集
-     * @param int   $limit   每次写入数据限制
+     * @param array    $dataSet 数据集
+     * @param int|null $limit   每次写入数据限制
      *
      * @return string
      */

src/db/Mongo.php

@@ -34,10 +34,10 @@ class Mongo extends BaseQuery
     /**
      * 执行指令 返回数据集.
      *
-     * @param Command        $command        指令
-     * @param string         $dbName
-     * @param ReadPreference $readPreference readPreference
-     * @param string|array   $typeMap        指定返回的typeMap
+     * @param Command             $command        指令
+     * @param string              $dbName
+     * @param ReadPreference|null $readPreference readPreference
+     * @param string|array        $typeMap        指定返回的typeMap
      *
      * @throws AuthenticationException
      * @throws InvalidArgumentException
@@ -102,7 +102,7 @@ public function listCollections(string $db = '')
     /**
      * COUNT查询.
      *
-     * @param string $field 字段名
+     * @param string|null $field 字段名
      *
      * @return int
      */
@@ -457,8 +457,8 @@ public function slaveOk(bool $slaveOk)
     /**
      * 指定查询数量.
      *
-     * @param int $offset 起始位置
-     * @param int $length 查询数量
+     * @param int      $offset 起始位置
+     * @param int|null $length 查询数量
      *
      * @return $this
      */

src/db/PDOConnection.php

@@ -503,8 +503,8 @@ public function getTableFields($tableName): array
     /**
      * 获取数据表字段类型.
      *
-     * @param mixed  $tableName 数据表名
-     * @param string $field     字段名
+     * @param mixed       $tableName 数据表名
+     * @param string|null $field     字段名
      *
      * @return array|string
      */
@@ -705,7 +705,7 @@ public function execute(string $sql, array $bind = []): int
      *
      * @param BaseQuery $query  查询对象
      * @param mixed     $sql    sql指令
-     * @param bool      $master 主库读取
+     * @param bool|null $master 主库读取
      *
      * @throws DbException
      *
@@ -1733,8 +1733,8 @@ public function getLastSql(): string
     /**
      * 获取最近插入的ID.
      *
-     * @param BaseQuery $query    查询对象
-     * @param string    $sequence 自增序列名
+     * @param BaseQuery   $query    查询对象
+     * @param string|null $sequence 自增序列名
      *
      * @return mixed
      */

src/db/Query.php

@@ -104,7 +104,7 @@ public function exp(string $field, string $value)
     /**
      * 表达式方式指定当前操作的数据表.
      *
-     * @param mixed $table 表名
+     * @param string $table 表名
      *
      * @return $this
      */

src/db/concern/JoinAndViewQuery.php

@@ -24,10 +24,10 @@ trait JoinAndViewQuery
     /**
      * 查询SQL组装 join.
      *
-     * @param array|string|Raw   $join      关联的表名
-     * @param mixed  $condition 条件
-     * @param string $type      JOIN类型
-     * @param array  $bind      参数绑定
+     * @param array|string|Raw $join      关联的表名
+     * @param string|null      $condition 条件
+     * @param string           $type      JOIN类型
+     * @param array            $bind      参数绑定
      *
      * @return $this
      */
@@ -47,9 +47,9 @@ public function join(array | string | Raw $join, ?string $condition = null, stri
     /**
      * LEFT JOIN.
      *
-     * @param array|string|Raw  $join      关联的表名
-     * @param mixed $condition 条件
-     * @param array $bind      参数绑定
+     * @param array|string|Raw $join      关联的表名
+     * @param string|null      $condition 条件
+     * @param array            $bind      参数绑定
      *
      * @return $this
      */
@@ -61,9 +61,9 @@ public function leftJoin(array | string | Raw $join, ?string $condition = null,
     /**
      * RIGHT JOIN.
      *
-     * @param array|string|Raw  $join      关联的表名
-     * @param mixed $condition 条件
-     * @param array $bind      参数绑定
+     * @param array|string|Raw $join      关联的表名
+     * @param string|null      $condition 条件
+     * @param array            $bind      参数绑定
      *
      * @return $this
      */
@@ -75,9 +75,9 @@ public function rightJoin(array | string | Raw $join, ?string $condition = null,
     /**
      * FULL JOIN.
      *
-     * @param array|string|Raw  $join      关联的表名
-     * @param mixed $condition 条件
-     * @param array $bind      参数绑定
+     * @param array|string|Raw $join      关联的表名
+     * @param string|null      $condition 条件
+     * @param array            $bind      参数绑定
      *
      * @return $this
      */
@@ -90,8 +90,8 @@ public function fullJoin(array | string | Raw $join, ?string $condition = null,
      * 获取Join表名及别名 支持
      * ['prefix_table或者子查询'=>'alias'] 'table alias'.
      *
-     * @param array|string|Raw $join  JION表名
-     * @param string           $alias 别名
+     * @param array|string|Raw $join  JOIN表名
+     * @param string|null      $alias 别名
      *
      * @return string|array
      */
@@ -137,9 +137,9 @@ protected function getJoinTable(array | string | Raw $join, ?string &$alias = nu
      *
      * @param array|string|Raw  $join  数据表
      * @param string|array|bool $field 查询字段
-     * @param string       $on    JOIN条件
-     * @param string       $type  JOIN类型
-     * @param array        $bind  参数绑定
+     * @param string|null       $on    JOIN条件
+     * @param string            $type  JOIN类型
+     * @param array             $bind  参数绑定
      *
      * @return $this
      */

src/db/concern/ModelRelationQuery.php

@@ -303,8 +303,8 @@
     /**
      * 设置数据字段获取器.
      *
-     * @param string|array $name     字段名
-     * @param callable     $callback 闭包获取器
+     * @param string|array  $name     字段名
+     * @param callable|null $callback 闭包获取器
      *
      * @return $this
      */
@@ -334,7 +334,7 @@
     }
 
     /**
-     * 关联预载入 In方式.
+     * 关联预载入 In 方式.
      *
      * @param array|string $with 关联方法名称
      *
@@ -352,7 +352,7 @@
     }
 
     /**
-     * 关联预载入 JOIN方式.
+     * 关联预载入 JOIN 方式.
      *
      * @param array|string $with     关联方法名
      * @param string       $joinType JOIN方式
@@ -408,7 +408,7 @@
      *
      * @return $this
      */
-    protected function withAggregate(string | array $relations, string $aggregate = 'count', $field = '*', bool $subQuery = true)
+    protected function withAggregate(string | array $relations, string $aggregate = 'count', string $field = '*', bool $subQuery = true)
     {
         if (empty($this->model)) {
             return $this;
@@ -435,7 +435,7 @@
      * @param string|array|bool $relation 关联方法名
      * @param mixed             $key      缓存key
      * @param int|\DateTime     $expire   缓存有效期
-     * @param string            $tag      缓存标签
+     * @param string|null       $tag      缓存标签
      *
      * @return $this
      */

src/db/concern/ParamsBind.php

@@ -44,9 +44,9 @@ public function bind(array $value)
     /**
      * 单个参数绑定.
      *
-     * @param mixed  $value 绑定变量值
-     * @param int    $type  绑定类型
-     * @param string $name  绑定标识
+     * @param mixed       $value 绑定变量值
+     * @param int|null    $type  绑定类型
+     * @param string|null $name  绑定标识
      *
      * @return string
      */

src/db/concern/ResultOperation.php

@@ -30,8 +30,8 @@ trait ResultOperation
     /**
      * 设置数据处理（支持模型）.
      *
-     * @param callable $filter 数据处理Callable
-     * @param string   $index  索引（唯一）
+     * @param callable    $filter 数据处理 Callable
+     * @param string|null $index  索引（唯一）
      *
      * @return $this
      */
@@ -155,7 +155,7 @@ protected function getResultAttr(array &$result, array $withAttr = []): void
 
     /**
      * 处理空数据.
-     * @param Closure $closure 闭包数据
+     * @param Closure|null $closure 闭包数据
      * @throws DbException
      * @throws ModelNotFoundException
      * @throws DataNotFoundException

src/db/concern/WhereQuery.php

@@ -303,10 +303,10 @@ public function whereOrJsonContains(string $field, $condition)
     /**
      * 比较两个字段.
      *
-     * @param string $field1   查询字段
-     * @param string $operator 比较操作符
-     * @param string $field2   比较字段
-     * @param string $logic    查询逻辑 and or xor
+     * @param string      $field1   查询字段
+     * @param string      $operator 比较操作符
+     * @param string|null $field2   比较字段
+     * @param string      $logic    查询逻辑 and or xor
      *
      * @return $this
      */
@@ -601,9 +601,9 @@ public function removeWhereField(string $field, string $logic = 'AND')
     /**
      * 条件查询.
      *
-     * @param mixed         $condition 满足条件（支持闭包）
-     * @param Closure|array $query     满足条件后执行的查询表达式（闭包或数组）
-     * @param Closure|array $otherwise 不满足条件后执行
+     * @param mixed              $condition 满足条件（支持闭包）
+     * @param Closure|array      $query     满足条件后执行的查询表达式（闭包或数组）
+     * @param Closure|array|null $otherwise 不满足条件后执行
      *
      * @return $this
      */