文件
fenleixinxi/application/api/controller/AdminOrder.php
linda 11174f8693 fix(api): 修复 TP5.0 查询构造器复用与数组入参两处系统性缺陷
1) count() 后复用同一 Query 会清空 options,导致 alias/join/where 丢失
   (SQL 报错 Unknown column/table,或筛选静默失效)
   → 基类新增 pageQuery(callable) 助手,8 个分页接口全部改用闭包重建查询
2) TP5.0 Request::input() 对不含 / 的参数名做字符串强转,值若为数组会抛
   variable type error:array(影响 media[]/benefits[]/permissions[]/icons)
   → 基类 input()/inputs() 改用 post(false)/get(false) 取原始数组
3) 种子数据:佣金调整为 settled 336.4 / 未结算 950,使可提现余额 = 186.4(与前端 mock 对齐)
4) 测试脚本:P1 必填校验断言按 分类→标题→内容 顺序修正
2026-10-15 14:56:06 +08:00

119 行
3.9 KiB
PHP

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?php
namespace app\api\controller;
use think\Db;
/**
* 后台管理端 · 订单管理(Module-ADM-ORDER)
* 路由:
* GET /api/v1/admin/orders AO1 订单列表
* POST /api/v1/admin/order/:id/refund AO2 订单退款
* POST /api/v1/admin/order/supplement AO3 订单补单
*/
class AdminOrder extends V1
{
/**
* AO1 订单列表
* GET /api/v1/admin/orders 入参 {type?,page,size}
* → 分页 {list:[{id,orderNo,type,title,amount,payType,status,userId,userName,createdAt}],page,size,total,hasMore}
*/
public function index()
{
$type = trim((string)$this->input('type', ''));
// 闭包重建查询:TP5.0 的 count() 会清空 Query::options,不能复用同一对象
list($rows, $total, $page, $size) = $this->pageQuery(function ($forCount) use ($type) {
$q = Db::name('fc_order')->alias('o')
->join('user u', 'u.id = o.user_id', 'LEFT');
if ($type !== '') {
$q->where('o.type', $type);
}
if ($forCount) {
return $q;
}
return $q->field('o.*, u.nickname AS nickname')
->order('o.createtime desc');
});
$list = [];
foreach ($rows as $row) {
$list[] = [
'id' => (int)$row['id'],
'orderNo' => (string)$row['order_no'],
'type' => (string)$row['type'],
'title' => (string)$row['title'],
'amount' => (float)$row['amount'],
'payType' => (string)$row['pay_type'],
'status' => (string)$row['status'],
'userId' => (int)$row['user_id'],
'userName' => (string)$row['nickname'],
'createdAt' => $this->iso($row['createtime']),
];
}
$this->ok($this->paginate($list, $total, $page, $size));
}
/**
* AO2 订单退款
* POST /api/v1/admin/order/:id/refund 入参 {amount,reason?} → {id,refunded}
* 规则 BR-10:退款金额需大于 0
*/
public function refund()
{
$id = (int)$this->request->param('id', 0);
$amount = round((float)$this->input('amount', 0), 2);
$reason = trim((string)$this->input('reason', ''));
if ($amount <= 0) {
$this->fail('退款金额需大于 0');
}
$order = Db::name('fc_order')->where('id', $id)->find();
if (!$order) {
$this->fail('订单不存在', 404);
}
Db::name('fc_order')->where('id', $id)->update([
'status' => 'refunded',
'refund_amount' => $amount,
'refund_reason' => $reason,
]);
$this->notify($order['user_id'], 'system', '订单已退款', '您的订单「' . $order['title'] . '」已退款 ' . $amount . ' 元。');
$this->adminLog('订单退款 #' . $id . ' 金额' . $amount);
$this->ok(['id' => (int)$id, 'refunded' => true]);
}
/**
* AO3 订单补单
* POST /api/v1/admin/order/supplement 入参 {orderNo} → {orderNo,supplemented}
* 幂等:已支付直接返回
*/
public function supplement()
{
$orderNo = trim((string)$this->input('orderNo', ''));
if ($orderNo === '') {
$this->fail('订单号不能为空');
}
$order = Db::name('fc_order')->where('order_no', $orderNo)->find();
if (!$order) {
$this->fail('订单不存在', 404);
}
if ($order['status'] !== 'paid') {
Db::name('fc_order')->where('id', $order['id'])->update([
'status' => 'paid',
'paytime' => time(),
]);
$this->flow('income', '订单补单', $order['amount'], 0, $order['id']);
$this->adminLog('订单补单 #' . $orderNo);
}
$this->ok(['orderNo' => (string)$orderNo, 'supplemented' => true]);
}
}