// 隐藏入参:字符串 / 数字 / 布尔 / 对象 / 数组 / null * } * * 已注册动作: * openDoor — 远程开门(value: 闸口号 / 对象) * registerLicensePlate— 登记车牌临时通行 6 小时(value: 车牌号 / 对象) * * 与文本回复相互独立: * - content 非空 → 照常推送到 IM 群 * - do 非空 → 执行对应动作(content 为空时也要执行,例如纯开门指令) * * 新增动作: * 1. 在 application/index/library/new_wms/notify/action/ 下新建类,继承 action\Base * 2. 在下面的 $map 里加一行 do => 类名(大小写不敏感匹配) */ class ActionDispatcher { /** * do => 动作类名 * @var array */ private static $map = [ 'openDoor' => \app\index\library\new_wms\notify\action\OpenDoor::class, 'registerLicensePlate' => \app\index\library\new_wms\notify\action\RegisterLicensePlate::class, ]; /** * 已注册的动作名列表 * @return array */ public static function registered() { return array_keys(self::$map); } /** * 注册(或覆盖)一个动作 * * @param string $do 动作名(与 extend_props.do 对应) * @param string $class 动作类名(需继承 action\Base) */ public static function register($do, $class) { self::$map[trim((string) $do)] = $class; } /** * 是否存在可执行的动作 * * @param mixed $do * @return bool */ public static function has($do) { return self::resolve($do) !== null; } /** * 执行动作 * * 不抛异常:动作失败只记录日志并把失败原因带回响应,不影响文本回复流程。 * * @param mixed $do extend_props.do * @param mixed $value extend_props.value,泛类型 * @param array $data 通知 data 节点 * @return array|null null = 没有 do,未执行任何动作 */ public static function run($do, $value, array $data = []) { $do = is_string($do) ? trim($do) : ''; if ($do === '') { return null; } $start = microtime(true); $class = self::resolve($do); if (!$class || !class_exists($class)) { \think\Log::error("[WmsNotify] 动作未注册: do={$do},已注册: " . implode(', ', self::registered())); return [ 'do' => $do, 'ok' => false, 'msg' => '动作未注册', 'cost' => self::cost($start), ]; } try { /** @var Base $action */ $action = new $class(); $result = $action->execute($value, $data); $cost = self::cost($start); \think\Log::info("[WmsNotify] 动作执行成功: do={$do} cost={$cost}ms value=" . self::encode($value) . " result=" . self::encode($result)); return [ 'do' => $do, 'ok' => true, 'msg' => 'ok', 'result' => $result, 'cost' => $cost, ]; } catch (\Throwable $e) { $cost = self::cost($start); \think\Log::error("[WmsNotify] 动作执行失败: do={$do} cost={$cost}ms value=" . self::encode($value) . " err=" . $e->getMessage()); return [ 'do' => $do, 'ok' => false, 'msg' => $e->getMessage(), 'cost' => $cost, ]; } } /** * 解析 do 对应的动作类名(大小写不敏感) * * @param mixed $do * @return string|null */ private static function resolve($do) { $do = is_string($do) ? trim($do) : ''; if ($do === '') { return null; } if (isset(self::$map[$do])) { return self::$map[$do]; } foreach (self::$map as $name => $class) { if (strcasecmp($name, $do) === 0) { return $class; } } return null; } /** * 计算耗时(毫秒) * @param float $start * @return float */ private static function cost($start) { return round((microtime(true) - $start) * 1000, 2); } /** * JSON 编码(便于日志查看,失败时退回 var_export) * @param mixed $value * @return string */ private static function encode($value) { $json = json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); return $json === false ? var_export($value, true) : $json; } }