2.4.4 函数注释

函数申明处注释的内容： （1）函数作用：当前函数需要达成的目的 （2）函数参数：说明是输入还是输出，及参数含义 （3）返回值：含义和类型 示例

    /**
     * 加载书籍列表
     * @param class 书籍类型
     * @param limit 检索数据条数限制
     * @return array 数据列表
     */
    function loadBookList($class = -1, $limit = 10) {
        $condition = [['is_del', '=', 0], ['md5', '>', 0], ['status', '>', 0], ['class', '<>', 11]];
        if ((int) $class > 0) {
            $condition['class'] = (int) $class;
        }
        return Db::table($this->table)
            ->field('id, md5, name, key, class, count, snap, author')
            ->where($condition)
            ->order('id', 'asc')
            ->limit($limit)
            ->select();
    }