feat: 实现TCP Server

2026-03-02 21:59:43 +08:00
parent 043306819b
commit a79dfae57d
144 changed files with 15785 additions and 140 deletions
@@ -0,0 +1,141 @@
+<?php
+
+namespace app\flow;
+
+use app\config\Config;
+use app\flow\config\ProcessConfig;
+use app\net\PacketContext;
+use app\utils\Logger;
+
+/**
+ * FlowMain Flow入口类（单例）
+ *
+ * 职责：
+ * 1. 作为TCP服务器的入口点，接收刷卡事件
+ * 2. 管理流程处理器的生命周期（单例）
+ * 3. 从全局配置加载自定义流程配置
+ * 4. 提供配置热更新能力
+ *
+ * 与 FlowProcessor 的关系：
+ * - FlowMain 是入口和调度器（有状态单例）
+ * - FlowProcessor 是业务处理器（无状态，可被复用）
+ *
+ * @see FlowProcessor 流程处理器，处理具体业务逻辑
+ */
+class FlowMain
+{
+    private FlowProcessor $flowProcessor;
+
+    /**
+     * 获取FlowMain实例（单例模式）
+     */
+    private static ?FlowMain $instance = null;
+
+
+    public static function getInstance(): FlowMain
+    {
+        if (self::$instance === null) {
+            self::$instance = new self();
+        }
+        return self::$instance;
+    }
+
+    /**
+     * 私有构造函数，防止外部实例化
+     */
+    private function __construct()
+    {
+        $this->flowProcessor = $this->createFlowProcessor();
+
+    }
+
+    /**
+     * 创建流程处理器
+     *
+     * 根据配置创建对应的 FlowProcessor
+     */
+    private function createFlowProcessor(): FlowProcessor
+    {
+        $useCustomProcess = Config::getInstance()->flowUseCustomProcess;
+        $processConfigKey = Config::getInstance()->flowProcessConfigKey;
+
+        // 流程配置 通过流程配置可以实现，加载/卸载流程节点，添加/修改语音输出
+        $processConfig = null;
+        if ($useCustomProcess && !empty($processConfigKey)) {
+            // 从全局配置加载自定义流程
+            $globalConfig = Config::getInstance();
+            $customProcess = $globalConfig->customProcess;
+            $processConfigArray = $customProcess[$processConfigKey] ?? null;
+
+            if ($processConfigArray !== null) {
+                Logger::info("使用自定义流程: {}",  [$processConfigKey]);
+                $processConfig = ProcessConfig::fromArray($processConfigArray);
+                return FlowProcessor::create($processConfig);
+            }
+        }
+
+        Logger::info("FlowMain 使用默认标准流程");
+        Logger::info("使用数据库: {}",[ Config::getInstance()->database->database]);
+        $processConfig = ProcessConfig::createStandard();
+        // 使用默认标准流程
+        return FlowProcessor::create($processConfig);
+    }
+
+    /**
+     * Flow主入口方法
+     *
+     * @param PacketContext $packetContext 数据包上下文
+     * @return ProcessContext
+     */
+    public function main(PacketContext $packetContext): ProcessContext
+    {
+        // 调用流程处理器处理数据包并返回处理完成后的上下文
+        // process 参数：数据包上下文
+        // process 参数: 是否执行结果处理器，默认是执行
+        // 返回值: 处理完成后的数据包上下文
+        $packetContext = $this->flowProcessor->process($packetContext);
+        return $packetContext;
+    }
+
+    /**
+     * 获取流程处理器实例
+     *
+     * @return FlowProcessor
+     */
+    public function getFlowProcessor(): FlowProcessor
+    {
+        return $this->flowProcessor;
+    }
+
+    /**
+     * 重新加载配置（配置热更新）
+     *
+     * @return void
+     */
+    public function reloadConfig(): void
+    {
+        $this->flowProcessor = $this->createFlowProcessor();
+    }
+
+    /**
+     * 切换流程配置
+     *
+     * @param string $configKey 配置键名（如 'standard', 'no_morning_wash'）
+     * @return void
+     */
+    public function switchConfig(string $configKey): void
+    {
+        self::$processConfigKey = $configKey;
+        $this->reloadConfig();
+    }
+
+    /**
+     * 重置单例（主要用于测试）
+     *
+     * @return void
+     */
+    public static function resetInstance(): void
+    {
+        self::$instance = null;
+    }
+}