// 隐藏入参,泛类型:字符串/数字/布尔/对象/数组/null * } * * value 的语义由各子类自行解释(见各子类注释),基类只做归一化,方便子类按键取值。 * * 约定: * - 子类实现 run(),返回数组:会写进接口响应与日志,便于排查 * - 执行失败直接 throw \Exception,由 ActionDispatcher 统一捕获记录,不影响文本回复 */ abstract class Base { /** * extend_props.value 原始值(泛类型,未做任何转换) * @var mixed */ protected $value; /** * 通知 data 原文(group_id / user_id / user_name / group_name / ext_id ...) * @var array */ protected $data = []; /** * 动作名(与 extend_props.do 对应) * @return string */ abstract public function name(); /** * 执行动作 * * @param mixed $value extend_props.value,泛类型 * @param array $data 通知 data 节点 * @return array 执行结果(写入接口响应与日志) * @throws \Exception 执行失败时抛出 */ abstract public function run($value, array $data); /** * 统一入口:先固化上下文,再执行 * * @param mixed $value * @param array $data * @return array */ public function execute($value, array $data) { $this->value = $value; $this->data = $data; return $this->run($value, $data); } // ==================== 公共能力:Redis / 仓库 / 操作人 / 车牌 ==================== /** Redis 连接信息(与项目其它地方的硬编码保持一致) */ const REDIS_HOST = '127.0.0.1'; const REDIS_PORT = 6379; const REDIS_AUTH = 'qwe2019@'; /** 查不到群对应仓库时的兜底仓库(与 Chat::openD 的硬编码保持一致,子类可覆盖) */ const DEFAULT_WAREHOUSE_ID = 5400; /** 放行缘由中文名(与 Wms::plateresult 的映射保持一致) */ const TYPE_TEXT = ['daohuo' => '到货', 'tihuo' => '提货']; /** * 连接 Redis 并选择库 * * @param int $db 库号 * @return \Redis */ protected function redis($db) { $redis = new \Redis(); $redis->connect(static::REDIS_HOST, static::REDIS_PORT); $redis->auth(static::REDIS_AUTH); $redis->select($db); return $redis; } /** * 解析仓库 ID * * 顺序:value.warehouseId →(按通知里的 group_id 反查 qiwe_rooms/rooms)→ 兜底仓库 * * @param array $data 通知 data 节点 * @return array ['id' => int, 'from' => string] * @throws \Exception 三者都取不到时抛出 */ protected function resolveWarehouseId(array $data) { // 1. value 里显式指定 $fromValue = $this->param(['warehouseId', 'warehouse', 'wmsWarehouseId']); if (is_numeric($fromValue) && intval($fromValue) > 0) { return ['id' => intval($fromValue), 'from' => 'value']; } // 2. 按群 ID 反查(企微群优先,再查微信群) $groupId = isset($data['group_id']) ? trim(strval($data['group_id'])) : ''; if ($groupId !== '') { try { $room = (new \app\common\model\qiwe\Rooms())->where(['room_id' => $groupId])->find(); if (!$room) { $room = (new \app\common\model\Rooms())->where(['room_id' => $groupId])->find(); } if ($room && intval(($room['WAREHOUSEID'] ?? null)) > 0) { return ['id' => intval($room['WAREHOUSEID']), 'from' => "group:{$groupId}"]; } } catch (\Exception $e) { \think\Log::error('[' . $this->name() . "] 反查群仓库失败: " . $e->getMessage()); } } // 3. 兜底默认仓库 if (static::DEFAULT_WAREHOUSE_ID > 0) { return ['id' => static::DEFAULT_WAREHOUSE_ID, 'from' => 'default']; } throw new \Exception('无法确定仓库,请在 extend_props.value 里指定 warehouseId'); } /** * 解析操作人(写日志用):value.username → 通知里的 user_name → '-' * * @param array $data * @return string */ protected function resolveUsername(array $data) { $username = $this->param(['username', 'userName', 'operator']); if ($username !== null && !is_array($username) && !is_object($username) && trim(strval($username)) !== '') { return trim(strval($username)); } $userName = isset($data['user_name']) ? trim(strval($data['user_name'])) : ''; return $userName !== '' ? $userName : '-'; } /** * 从文本中提取车牌号(正则与 Chat::extractLicensePlates 保持一致,如需调整请两处同步) * * @param string $string * @return array 提取到的车牌列表 */ protected static function extractLicensePlates($string) { if (!is_string($string) || $string === '') { return []; } $pattern = '/ (?:[京津沪渝冀豫云辽黑湘晩鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z]| # 普通省份简称+字母 京[A-Z]| # 北京特殊格式 沪[A-Z]| # 上海特殊格式 浙[A-Z]| # 浙江特殊格式 苏[A-Z]| # 江苏特殊格式 粤Z) # 港澳车牌 [A-Z0-9]{4,6} # 4-5位字母数字组合 |WJ\d{4}[A-Z0-9] # 武警车牌 |[军海空北沈兰济南广成]\w{5} # 军车车牌 |\d{6}使 # 使馆车牌另一种格式 /xu'; preg_match_all($pattern, $string, $matches); return isset($matches[0]) ? $matches[0] : []; } // ==================== 泛类型 value 处理工具 ==================== /** * 把泛类型 value 归一化成关联数组,便于统一按键取值 * * null / '' / [] → [] * 对象 → (array) 转换 * 数组 → 原样返回 * JSON 字符串 → 解码为数组('{...}' / '[...]') * 其他字符串 / 数字 / 布尔 → ['value' => 原值] * * @return array */ protected function valueParams() { $value = $this->value; if ($value === null || $value === '' || $value === []) { return []; } if (is_object($value)) { return (array) $value; } if (is_array($value)) { return $value; } if (is_string($value)) { $trim = trim($value); if ($trim !== '' && ($trim[0] === '{' || $trim[0] === '[')) { $json = json_decode($trim, true); if (is_array($json)) { return $json; } } return ['value' => $trim]; } return ['value' => $value]; } /** * 按候选键名取值(忽略大小写、下划线、中划线差异) * * $this->param(['warehouseId', 'WAREHOUSEID']) 等价于取 warehouse_id / warehouseid / warehouse-id ... * * @param array $keys 候选键名列表 * @param mixed $default 取不到时的默认值 * @return mixed */ protected function param(array $keys, $default = null) { $params = $this->valueParams(); if (!$params) { return $default; } // 归一化参数键:小写 + 去掉 _ - $normalized = []; foreach ($params as $k => $v) { $normalized[self::normalizeKey($k)] = $v; } foreach ($keys as $key) { $nk = self::normalizeKey($key); if (array_key_exists($nk, $normalized)) { return $normalized[$nk]; } } return $default; } /** * 判断 value 是否为「对象/数组」形态(而非标量) * @return bool */ protected function isStructuredValue() { $value = $this->value; if (is_array($value) || is_object($value)) { return true; } if (is_string($value)) { $trim = trim($value); return $trim !== '' && ($trim[0] === '{' || $trim[0] === '['); } return false; } /** * 键名归一化:小写并去掉 _ - 空格 * @param mixed $key * @return string */ protected static function normalizeKey($key) { return str_replace(['_', '-', ' '], '', strtolower((string) $key)); } }