数据查询助手

// 1. 控制器中，创建查询器（查询器支持链式操作）
// 控制器需要继承 \think\admin\Controller 类；
// 参数：$dbQuery 数据模型或者数据表名
// 参数：$input 为输入对象，如：post、get、request 或 数组
$query = $this->_query();
$query = $this->_query($dbQuery, $input);

// 2. 新版本中，模型也支持直接创建查询器
// 模型需要继承基础模型 \think\admin\Model
// 参数：$input 为输入对象，如：post、get、request 或 数组
// 参数：$callable 为回调用处理，回调参数1为对象本身`QueryHelper`对象
$query = MyModel::mQuery();
$query = MyModel::mQuery($data, function(QueryHelper $helper){});
$query = MyModel::mQuery('post', function(QueryHelper $helper){});
$query = MyModel::mQuery(null, function(QueryHelper $helper){
    $helper->with("数据模型关联");
    $helper->where("查询条件"); 
    // $helper->like()->equal() ...
});

// 快捷查询助手分页参数：
// 参数：$page bool 是否启用分页，默认分页
// 参数：$display bool 是否直接显示模板，默认显示模板
// 参数：$total int|false 分页模式，如果为数字则为列表统计数，false 自动统计，true 使用简化分页
// 参数：$limit int 每页数量，分页时每页数据记录数量
// 参数：$template string 模板名称，当启用显示模板时，会加载指定模板 
$query->page($page, $display, $total, $limit, $template);

// 新版本中 QueryHelper 对象支持 Layui 表格数据加载
$query->layTable(function(QueryHelper $query){
    // 前置操作，处理 HTML 模型
}，function(QueryHelper $query){
    // 后置操作，处理表格数据
});

// 1. 从 QueryHelper 对象中获取 ThinkORM 的 Query 对象
$db = $query->db(); // 获取 ThinkORM 的查询对象

// 2. 使用 ThinkORM 的 Query 对象进行操作
$count = $db->count(); // 获取记录数量
$total = $db->sum('字段'); // 统计字段的求和
$mysql = $db->buildSql(); // 获取生成的 SQL 查询语句

// 3. 更新多数据聚合及查询请查询 ThinkORM 文档

// 1.0. 控制器中使用原生查询器（指定表名）
$query = $this->_query('SystemUser');

// 1.1. 使用模型创建查询器。
// SystemUser 是已继承基础模型 \think\admin\Model 的模型类，mQuery() 方法是自定义的查询构建器。
$query = SystemUser::mQuery();

// 2.0. 使用传入的 URL 参数进行查询条件设置。
// 这里使用了 `like` 和 `equal` 方法分别处理模糊查询和精确查询。
$query->like('username,sex')->equal('status');

// 3.0. 执行分页查询，分页结果会自动返回，便于前端展示。
$query->page();

// 4.0. 使用别名来处理 URL 参数与数据库字段不匹配的情况。
// 例如，URL 参数 'username_alias' 对应数据库中的 'username' 字段，
// 'user_status' 对应数据库中的 'status' 字段。
$get = ['username_alias' => 'admin', 'user_status' => 1];
$query = $this->_query('SystemUser', $get)->like('username#username_alias,sex')->equal('status#user_status');

// 5.0. 执行分页查询。
$query->page();

// 6.0. 额外的列表数据赋值到模板：
// 这里查询所有状态为 1 的用户列表，并将结果传递给模板变量 $userList。
$this->userList = $this->_query('SystemUser')->where(['status' => 1])->select();

// 7.0. 接收 URL 参数，进行查询条件设置。
// 假设 URL 参数 'username' 和 'sex' 使用 `like` 模糊查询，'status' 使用 `equal` 精确查询。
$get = ['status' => 1, 'username' => 'admin'];
$query = $this->_query('SystemUser', $get)->like('username,sex')->equal('status');

// 8.0. 执行分页查询并返回结果。
$query->page();

// 1. 模拟通过 GET 请求传递的查询条件，这里可以根据实际情况动态生成或获取条件
$get = ['username' => 'admin']; 

// 2. 构建查询规则，创建 Query 查询对象。请注意：SQL 语句中必须包含别名以避免歧义。
$query = $this->_query('(SELECT * FROM system_user) AS a', $get);

// 3. 设置查询字段及条件。在使用别名时，条件也必须使用相应的别名。使用 like() 等 QueryHelper 方法进行模糊查询，确保条件正确应用。
$query->like('a.username#username'); // 假设查询用户名为 'admin'

// 4. 额外的过滤条件（可选）。可以根据需求继续链式添加查询条件。
$query->where('a.status', 1); // 假设 1 表示启用状态的用户

// 5. 使用 page() 分页输出结果，也可以直接调用 layTable() 或 select() 方法。
$result = $query->page(true, false);

// 1. 模拟通过 GET 请求传递的查询条件，这里可以根据实际情况动态生成或获取条件
$get = ['username' => 'admin']; 

// 2. 构建查询规则，创建 Query 查询对象。设置 join 相关的参数与 ThinkORM 操作一样。
$query = $this->_query('system_user', $get)->alias('a')->join('system_oplog b', 'a.username=b.username');

// 3. 设置查询字段及条件。在使用别名时，条件也必须使用相应的别名。
//    使用 join 时，输出的结果字段可能会出现重复，这里需要指定 field 输出的字段
$query->like('a.username#username')->field('a.username,b.action');

// 4. 使用 page() 分页输出结果，也可以直接调用 layTable() 或 select() 方法。
$result = $query->page(true, false);
dump($result);

protected function _page_filter(&$data){
  // 这里可以对 $data 进行二次处理，注意是引用
}

### 当一个控制器存在多个page操作时，可以指定回调前缀
protected function _index_page_filter(&$data){
  // 精准回调对 $data 进行二次处理，注意是引用
}

/**
 * 系统操作日志
 * @auth true
 * @menu true
 * @throws \think\Exception
 * @throws \think\db\exception\DataNotFoundException
 * @throws \think\db\exception\ModelNotFoundException
 * @throws \think\exception\DbException
 */
public function index()
{
    $this->title = '系统操作日志';
    $query = $this->_query($this->table)->like('action,node,content,username,geoip');
    $query->dateBetween('create_at')->order('id desc')->page();
}

/**
 * 列表数据处理
 * @param array $data
 * @throws \Exception
 */
protected function _index_page_filter(&$data)
{
    $ip = new \Ip2Region();
    foreach ($data as &$vo) {
        $result = $ip->btreeSearch($vo['geoip']);
        $vo['isp'] = isset($result['region']) ? $result['region'] : '';
        $vo['isp'] = str_replace(['内网IP', '0', '|'], '', $vo['isp']);
    }
}

// 在这里对 Db 进行操作，如果 $db->where()->buildSql() 等等
$db = $this->_query('表名')->db();
// or 模型调用法
$db = MyModel::mQuery()->db();

// 输出 Sql 语句
var_dump($db->buildSql());

// 对于联表操作，需要指定 field,join 如果用到了条件查询，一定要用上别名查询
$query = $this->_query('table_a')->alias('a')->field('a.id,a.name,b.pid,b.nickname');
$query->join('table_b b','a.id=b.pid')->like('a.name#a_name')->page();

// 另外，对于 TP 原有的用法也支持如 | 和 & 用法
$map = ['a&b' => 1]; // 生成的条件是： where a = 1 and b = 1
$map = ['a|b' => 1]; // 生成的条件是： where b = 1 or b = 1

// 以上两种情况配合别名使用
$this->_query('table_a')->alias('a')->equal('a|b#name')...
// or 模型调用法
MyModel::mQuery()->alias('a')->equal('a|b#name')...
// 当前请求带上 name 值时，会生成 where a=值 or b=值

$this->_query('table_a')->alias('a')->equal('a&b#name')...
// or 模型调用法
MyModel::mQuery()->alias('a')->equal('a&b#name')...
// 当前请求带上 name 值时，会生成 where a=值 and b=值