'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', // 发货相关 'order_goods_id' => 'require|integer|gt:0', 'express_id' => 'require|integer|gt:0', '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之间', // 发货相关提示 'order_goods_id.require' => '订单商品ID不能为空', 'order_goods_id.integer' => '订单商品ID必须是整数', 'order_goods_id.gt' => '订单商品ID必须大于0', 'express_id.require' => '快递公司不能为空', 'express_id.integer' => '快递公司ID必须是整数', 'express_id.gt' => '快递公司ID必须大于0', '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', 'order_goods_id', 'express_id', '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; } }