ThinkPHP排序必须在查询阶段用order()方法完成，推荐关联数组写法如['status'=>'desc','create_time'=>'asc']，TP6支持、TP5.1+兼容，自动转义防注入；多字段排序用二维数组格式；用户可控排序需白名单校验；关联查询须加表别名避免歧义。
ThinkPHP 排序必须在查询阶段用 order() 方法完成，不能靠 PHP 数组二次排序，否则分页错、性能差、关联字段失效。最规范写法是用关联数组传参，字段名和方向一一对应，自动转义、兼容性强、防注入。
推荐用关联数组写法
字段名作键，方向（'asc' 或 'desc'）作值，语义清晰且安全：
$list = User::order(['status' => 'desc', 'create_time' => 'asc'])->select();- TP6 全面支持，TP5.1 后期版本也兼容，比字符串更稳
- 字段含点号（如
user.name）或关键字（如order）时，数组方式由框架自动加反引号，不用手动处理 - 避免用字符串拼接：
$model->order($field . ' ' . $dir)——用户可控输入可能引发 SQL 注入
多字段排序要明确顺序和兜底
多个字段排序时，优先用二维数组格式，避免键名覆盖或版本兼容问题：
->order([['top_weight', 'desc'], ['create_time', 'desc'], ['id', 'desc']])- 尤其做置顶+时间混合排序时，
top_weight放第一位，id放最后作为唯一兜底，防止分页数据重复或错乱 - 别依赖一维关联数组（如
['a'=>'asc','b'=>'desc']），TP5.x 不支持，TP6 早期版本存在覆盖风险
用户可选排序时必须白名单校验
前端传来的排序字段和方向不能直接信任，需映射 + 校验：
立即学习“PHP免费学习笔记（深入）”；
- 定义允许字段：
$allowFields = ['id' => 'id', 'title' => 'title', 'status' => 'status']; - 取参并校验：
$field = input('sort_field', 'id'); $sort = $allowFields[$field] ?? 'id'; - 方向只认两个值：
$dir = in_array(input('sort_type'), ['asc','desc']) ? input('sort_type') : 'desc'; - 最终调用：
->order([$sort => $dir])，不拼字符串，不走Db::raw()
关联查询排序要指定来源表
用了 join() 或 view() 时，同名字段必须加表别名，否则报 Column 'xxx' is ambiguous：
- 正确：
->join('user u', 'u.id = article.user_id')->order(['u.status' => 'desc', 'article.create_time' => 'asc']) - 预加载
with()不支持跨表排序，如需按关联字段排序，改用join()或view() - 实在要用表达式（如中文拼音排序），用
orderRaw("convert(name using gbk) asc")，但注意它绕过字段解析，需自行确保安全性
