first()); $adminId = (int) ($state['bound_admin_id'] ?? 0); return ['bound' => !empty($state['chat_id']) && self::eligibleAdmin($adminId), 'admin_id' => $adminId]; } public static function createBinding(int $adminId): array { TicketTelegramConfig::runtime(true); if (!self::eligibleAdmin($adminId)) { throw new \RuntimeException('只有超级管理员可以绑定工单通知'); } $code = bin2hex(random_bytes(24)); self::ensureBindingRow(); (new Configurations())->getConnection()->transaction(function () use ($adminId, $code) { $row = Configurations::where('name', self::KEY)->lockForUpdate()->firstOrFail(); $state = self::readState($row); $state['pending_hash'] = hash('sha256', $code); $state['pending_admin_id'] = $adminId; $state['pending_expires_at'] = time() + self::BINDING_TTL; $row->value = json_encode($state, JSON_THROW_ON_ERROR); $row->save(); }); return ['code' => $code, 'expires_in' => self::BINDING_TTL]; } public static function unbind(): void { Configurations::where('name', self::KEY)->delete(); } /** Create the binding state without relying on mass-assignable model attributes. */ private static function ensureBindingRow(): void { if (Configurations::where('name', self::KEY)->first() !== null) { return; } $row = new Configurations(); $row->name = self::KEY; $row->value = '{}'; try { $row->save(); } catch (\Throwable $exception) { // Another request may have created the uniquely named binding row. if (Configurations::where('name', self::KEY)->first() === null) { throw $exception; } } } public static function bindingCommand(array $update): ?array { $message = $update['message'] ?? null; if (!is_array($message) || ($message['chat']['type'] ?? '') !== 'private' || !empty($message['from']['is_bot']) || !empty($message['forward_origin']) || !empty($message['forward_from']) || !empty($message['forward_date'])) { return null; } $chatId = (string) ($message['chat']['id'] ?? ''); $senderId = (string) ($message['from']['id'] ?? ''); if (!preg_match('/^[1-9][0-9]{0,18}$/D', $chatId) || $chatId !== $senderId || !preg_match('/^\/start\s+([a-f0-9]{48})$/D', (string) ($message['text'] ?? ''), $matches)) { return null; } return ['chat_id' => $chatId, 'code' => $matches[1]]; } public static function handleUpdate(array $update): bool { $command = self::bindingCommand($update); if ($command === null) { return false; } return (new Configurations())->getConnection()->transaction(function () use ($command) { $row = Configurations::where('name', self::KEY)->lockForUpdate()->first(); $state = self::readState($row); $adminId = (int) ($state['pending_admin_id'] ?? 0); if ($row === null || (int) ($state['pending_expires_at'] ?? 0) <= time() || !hash_equals((string) ($state['pending_hash'] ?? ''), hash('sha256', $command['code'])) || !self::eligibleAdmin($adminId)) { return false; } // One-time token consumed atomically; replay cannot change the recipient. $row->value = json_encode(['bound_admin_id' => $adminId, 'chat_id' => $command['chat_id']], JSON_THROW_ON_ERROR); $row->save(); return true; }); } public static function notify(string $event, int $ticketId, string $title, string $content): bool { try { $config = TicketTelegramConfig::runtime(true); $state = self::readState(Configurations::where('name', self::KEY)->first()); $chatId = $state['chat_id'] ?? null; if ((!is_string($chatId) && !is_int($chatId)) || preg_match('/^[1-9][0-9]{0,18}$/D', (string) $chatId) !== 1 || !self::eligibleAdmin((int) ($state['bound_admin_id'] ?? 0))) { return false; } $label = in_array($event, ['created', '新工单'], true) ? '新工单' : '工单更新'; $plain = strip_tags($title . "\n" . $content); $text = $label . ' #' . $ticketId . "\n" . mb_substr($plain, 0, 3000, 'UTF-8'); (new BotApi($config['bot_token']))->call('sendMessage', [ 'chat_id' => (string) $chatId, 'text' => $text, 'disable_web_page_preview' => 'true', ], 10); return true; } catch (\Throwable $exception) { // SDK error URLs may contain bot secrets. Never log their messages. error_log('Administrator ticket Telegram delivery failed; ticket=' . $ticketId); return false; } } public static function registerWebhook(): bool { try { $config = TicketTelegramConfig::runtime(true); } catch (\Throwable $exception) { throw new \RuntimeException(self::safeConfigurationMessage($exception)); } try { $result = (new BotApi($config['bot_token']))->call('setWebhook', [ 'url' => $config['webhook_base_url'] . '/telegram_callback', 'secret_token' => $config['webhook_secret'], 'allowed_updates' => '["message"]', ], 10); if ($result !== true) { throw new \RuntimeException('Webhook registration rejected'); } return true; } catch (\Throwable $exception) { throw new \RuntimeException('Telegram webhook 注册失败,请检查 HTTPS、出站网络和 bot 配置'); } } private static function readState($row): array { $state = $row === null ? [] : json_decode((string) $row->value, true); return is_array($state) ? $state : []; } private static function safeConfigurationMessage(\Throwable $exception): string { $message = $exception->getMessage(); foreach ([ 'Telegram 工单提醒', 'Telegram 凭据', 'Telegram 机器人 Token', 'Telegram Webhook 密钥', 'Telegram 通信域名', 'PHP sodium ', '请在工单系统的 Telegram ', ] as $safePrefix) { if (str_starts_with($message, $safePrefix)) { return $message; } } return 'Telegram 配置读取失败,请检查数据库与服务器日志'; } private static function eligibleAdmin(int $adminId): bool { $allowed = array_map('intval', explode(',', (string) Config::get('super_admin', ''))); if ($adminId <= 0 || !in_array($adminId, $allowed, true)) { return false; } $user = User::find($adminId); return $user !== null && (bool) $user->is_admin && (int) $user->enable === 1; } }