fastadmin_tailored/application/api/validate/inspection/Order.php

<?php

namespace app\api\validate\inspection;

use think\Validate;

class Order extends Validate
{
    /**
     * 验证规则
     */
    protected $rule = [
        // 基础参数
        'address_id'       => 'require|integer|gt:0',
        'user_coupon_id'   => 'integer|gt:0',
        'memo'            => 'max:500',
        
        // 购物车相关
        'ids'             => 'require|array',
        'cart_ids'        => 'require|array',
        
        // 商品列表相关
        'goods_list'      => 'require|array|checkGoodsList',
        'goods_list.*.goods_id'     => 'require|integer|gt:0',
        'goods_list.*.goods_sku_id' => 'integer|egt:0',
        'goods_list.*.nums'         => 'require|integer|gt:0',
        
        // 计算订单数据验证
        'calculate_data'  => 'checkCalculateData',
        
        // 创建订单数据验证
        'create_data'     => 'checkCreateData',
        
        // 订单操作相关
        'order_sn'        => 'require|alphaNum',
        'order_id'        => 'require|integer|gt:0',
        'pay_type'         => 'require|in:alipay,wechat,unionpay,balance',
        'method'          => 'require|in:web,wap,app,miniapp,mp,mini',
        
        // 订单列表查询相关
        'page'            => 'integer|egt:1',
        'page_size'        => 'integer|between:1,100',
        'status'          => 'checkOrderStatus',
        'keywords'        => 'max:50',
        'start_time'      => 'date',
        'end_time'        => 'date',
        'time_range'      => 'checkTimeRange',
        
        // 统计相关
        'type'            => 'require|in:day,month,year',
        'date'            => 'require|date',
        'days'            => 'integer|between:1,365',
        
        // 发货相关
        'express_name'    => 'require|max:50',
        'express_no'      => 'require|alphaNum|max:50', 
        'express_image'   => 'require|array|max:9|checkExpressImages',
    ];

    /**
     * 提示消息
     */
    protected $message = [
        // 基础参数
        'address_id.require'    => '收货地址不能为空',
        'address_id.integer'    => '收货地址ID必须是整数',
        'address_id.gt'         => '收货地址ID必须大于0',
        'address_id.egt'        => '收货地址ID格式错误',
        'user_coupon_id.integer' => '优惠券ID必须是整数',
        'user_coupon_id.gt'     => '优惠券ID必须大于0',
        'memo.max'              => '备注长度不能超过500个字符',
        
        // 购物车相关
        'ids.require'           => '请选择商品',
        'ids.array'             => '商品选择参数格式错误',
        'cart_ids.require'      => '购物车ID不能为空',
        'cart_ids.array'        => '购物车ID必须是数组',
        
        // 商品列表相关
        'goods_list.require'    => '商品列表不能为空',
        'goods_list.array'      => '商品列表必须是数组',
        'goods_list.*.goods_id.require' => '商品ID不能为空',
        'goods_list.*.goods_id.integer' => '商品ID必须是整数',
        'goods_list.*.goods_id.gt'      => '商品ID必须大于0',
        'goods_list.*.goods_sku_id.integer' => '商品规格ID必须是整数',
        'goods_list.*.goods_sku_id.egt'     => '商品规格ID必须大于或等于0',
        'goods_list.*.nums.require'     => '商品数量不能为空',
        'goods_list.*.nums.integer'     => '商品数量必须是整数',
        'goods_list.*.nums.gt'          => '商品数量必须大于0',
        
        // 订单操作相关
        'order_sn.require'      => '订单号不能为空',
        'order_sn.alphaNum'     => '订单号格式错误',
        'order_id.require'       => '订单ID不能为空',
        'order_id.integer'       => '订单ID必须是整数',
        'order_id.gt'            => '订单ID必须大于0',
        'pay_type.require'       => '支付方式不能为空',
        'pay_type.in'            => '支付方式不支持',
        'method.require'        => '支付方法不能为空',
        'method.in'             => '支付方法不支持',

        // 订单列表查询相关
        'page.integer'          => '页码必须是整数',
        'page.egt'              => '页码必须大于等于1',
        'pageSize.integer'      => '每页数量必须是整数',
        'pageSize.between'      => '每页数量必须在1-100之间',
        'keywords.max'          => '搜索关键词长度不能超过50个字符',
        'start_time.date'       => '开始时间格式错误',
        'end_time.date'         => '结束时间格式错误',
        
        // 统计相关提示
        'type.require'              => '统计类型不能为空',
        'type.in'                   => '统计类型只能是day、month、year',
        'date.require'              => '统计日期不能为空',
        'date.date'                 => '统计日期格式错误',
        'days.integer'              => '天数必须是整数',
        'days.between'              => '天数必须在1-365之间',
        
        // 发货相关提示
        'express_name.require'      => '快递公司不能为空',
        'express_name.max'          => '快递公司名称不能超过50个字符',
        'express_no.require'        => '快递单号不能为空',
        'express_no.alphaNum'       => '快递单号只能包含字母和数字',
        'express_no.max'            => '快递单号不能超过50个字符',
        'express_image.require'     => '快递图片不能为空',
        'express_image.array'       => '快递图片必须是数组格式',
        'express_image.max'         => '快递图片最多上传9张',
    ];

    /**
     * 验证场景
     */
    protected $scene = [
        // 统一创建订单接口（支持购物车和商品规格两种模式）
        'create'            => ['address_id', 'user_coupon_id', 'memo', 'create_data'],
        // 计算订单（支持购物车和商品规格两种模式） 地址不是必填
        'calculate'         => ['address_id' => 'integer|egt:0', 'user_coupon_id', 'calculate_data'],
        // 订单详情、确认收货、查询物流
        'detail'            => ['orderId'],
        // 取消订单
        'cancel'            => ['orderId'],
        // 订单支付
        'pay'               => ['order_sn', 'pay_type', 'method'],
        // 订单列表
        'lists'             => ['page', 'page_size', 'status', 'keywords', 'start_time', 'end_time', 'time_range'],
        
        // 统计相关场景
        'statistics'  => ['type', 'date'],
        'trend'       => ['type', 'days'],
        
        // 发货相关场景
        'send'        => ['order_id', 'express_name', 'express_no', 'express_image'],
    ];



    /**
     * 自定义验证规则：验证商品列表格式
     * @param $value
     * @param $rule
     * @param $data
     * @return bool|string
     */
    protected function checkGoodsList($value, $rule, $data)
    {
        if (!is_array($value)) {
            return '商品列表必须是数组';
        }
        
        if (empty($value)) {
            return '商品列表不能为空';
        }
        
        foreach ($value as $index => $item) {
            if (!is_array($item)) {
                return "商品列表第" . ($index + 1) . "项格式错误";
            }
            
            // 验证必要字段
            if (!isset($item['goods_id']) || !is_numeric($item['goods_id']) || $item['goods_id'] <= 0) {
                return "商品列表第" . ($index + 1) . "项的商品ID无效";
            }
            
            if (!isset($item['nums']) || !is_numeric($item['nums']) || $item['nums'] <= 0) {
                return "商品列表第" . ($index + 1) . "项的数量无效";
            }
            
            // 验证可选字段
            if (isset($item['goods_sku_id']) && (!is_numeric($item['goods_sku_id']) || $item['goods_sku_id'] < 0)) {
                return "商品列表第" . ($index + 1) . "项的规格ID无效";
            }
        }
        
        return true;
    }

    /**
     * 自定义验证规则：验证计算订单参数
     * @param $value
     * @param $rule
     * @param $data
     * @return bool|string
     */
    protected function checkCalculateData($value, $rule, $data)
    {
        // 必须提供购物车ID或商品列表其中之一
        $hasCartIds = isset($data['cart_ids']) && is_array($data['cart_ids']) && !empty($data['cart_ids']);
        $hasGoodsList = isset($data['goods_list']) && is_array($data['goods_list']) && !empty($data['goods_list']);
        
        if (!$hasCartIds && !$hasGoodsList) {
            return '请提供购物车ID或商品列表';
        }
        
        // if ($hasCartIds && $hasGoodsList) {
        //     return '不能同时提供购物车ID和商品列表';
        // }
        
        // 验证购物车ID格式
        if ($hasCartIds) {
            foreach ($data['cart_ids'] as $index => $cart_id) {
                if (!is_numeric($cart_id) || $cart_id <= 0) {
                    return "购物车ID第" . ($index + 1) . "项格式错误";
                }
            }
        }
        
        // 验证商品列表格式
        if ($hasGoodsList) {
            $result = $this->checkGoodsList($data['goods_list'], '', $data);
            if ($result !== true) {
                return $result;
            }
        }
        
        return true;
    }

    /**
     * 自定义验证规则：验证创建订单参数
     * @param $value
     * @param $rule
     * @param $data
     * @return bool|string
     */
    protected function checkCreateData($value, $rule, $data)
    {
        // 必须提供购物车ID或商品列表其中之一
        $hasCartIds = isset($data['cart_ids']) && is_array($data['cart_ids']) && !empty($data['cart_ids']);
        $hasGoodsList = isset($data['goods_list']) && is_array($data['goods_list']) && !empty($data['goods_list']);
        
        if (!$hasCartIds && !$hasGoodsList) {
            return '请提供购物车ID或商品列表';
        }
        
        if ($hasCartIds && $hasGoodsList) {
            return '不能同时提供购物车ID和商品列表';
        }
        
        // 验证购物车ID格式
        if ($hasCartIds) {
            foreach ($data['cart_ids'] as $index => $cart_id) {
                if (!is_numeric($cart_id) || $cart_id <= 0) {
                    return "购物车ID第" . ($index + 1) . "项格式错误";
                }
            }
        }
        
        // 验证商品列表格式
        if ($hasGoodsList) {
            $result = $this->checkGoodsList($data['goods_list'], '', $data);
            if ($result !== true) {
                return $result;
            }
        }
        
        return true;
    }

    /**
     * 自定义验证规则：验证时间范围
     * @param $value
     * @param $rule
     * @param $data
     * @return bool|string
     */
    protected function checkTimeRange($value, $rule, $data)
    {
        // 如果提供了开始时间和结束时间，验证时间范围
        if (isset($data['start_time']) && isset($data['end_time'])) {
            $startTime = strtotime($data['start_time']);
            $endTime = strtotime($data['end_time']);
            
            if ($startTime === false) {
                return '开始时间格式错误';
            }
            
            if ($endTime === false) {
                return '结束时间格式错误';
            }
            
            if ($startTime > $endTime) {
                return '开始时间不能大于结束时间';
            }
            
            // 限制查询时间范围不超过1年
            $maxRange = 365 * 24 * 3600; // 1年的秒数
            if (($endTime - $startTime) > $maxRange) {
                return '查询时间范围不能超过1年';
            }
        }
        
        return true;
    }

    /**
     * 自定义验证规则：验证订单状态
     * @param $value
     * @param $rule
     * @param $data
     * @return bool|string
     */
    protected function checkOrderStatus($value, $rule, $data)
    {
        // 引入OrderEnum
        $allowedStatuses = array_keys(\app\common\Enum\OrderEnum::SHOW_TYPE_STATUS_MAP);
        
        if (!in_array($value, $allowedStatuses)) {
            $allowedValues = implode(', ', $allowedStatuses);
            return "订单状态值不正确，允许的值为：{$allowedValues}";
        }
        
        return true;
    }

    /**
     * 自定义验证规则：验证快递图片数组
     * @param $value
     * @param $rule
     * @param $data
     * @return bool|string
     */
    protected function checkExpressImages($value, $rule, $data)
    {
        if (!is_array($value)) {
            return '快递图片必须是数组格式';
        }
        
        if (empty($value)) {
            return '快递图片不能为空';
        }
        
        if (count($value) > 9) {
            return '快递图片最多上传9张';
        }
        
        // 验证每个图片URL格式
        foreach ($value as $index => $image) {
            if (!is_string($image) || empty($image)) {
                return "第" . ($index + 1) . "张图片URL不能为空";
            }
            
            // 验证图片URL格式（可以是相对路径或完整URL）
            if (!preg_match('/\.(jpg|jpeg|png|gif|bmp|webp)$/i', $image)) {
                return "第" . ($index + 1) . "张图片格式不正确，支持jpg、jpeg、png、gif、bmp、webp格式";
            }
        }
        
        return true;
    }
}