'; } /** 把状态数组序列化成文件正文(纯函数,便于测试) */ function tinyimg_token_encode(array $state) { $payload = [ 'token' => isset($state['token']) ? (string) $state['token'] : '', 'enabled' => !empty($state['enabled']) ? 1 : 0, 'created_at' => isset($state['created_at']) ? (string) $state['created_at'] : '', 'updated_at' => isset($state['updated_at']) ? (string) $state['updated_at'] : '', ]; return tinyimg_token_guard() . "\n" . json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE) . "\n"; } /** 解析文件正文,失败返回 null(纯函数) */ function tinyimg_token_decode($raw) { $raw = (string) $raw; $pos = strpos($raw, '?>'); if ($pos === false) { return null; } $json = trim(substr($raw, $pos + 2)); $data = json_decode($json, true); if (!is_array($data) || !array_key_exists('token', $data)) { return null; } return [ 'token' => (string) $data['token'], 'enabled' => !empty($data['enabled']) ? 1 : 0, 'created_at' => isset($data['created_at']) ? (string) $data['created_at'] : '', 'updated_at' => isset($data['updated_at']) ? (string) $data['updated_at'] : '', ]; } /** 无存储文件时的默认状态(兼容 config.php 的 api_token) */ function tinyimg_token_default($config = []) { $legacy = (is_array($config) && isset($config['api_token'])) ? trim((string) $config['api_token']) : ''; return [ 'token' => $legacy, 'enabled' => $legacy === '' ? 0 : 1, 'created_at' => '', 'updated_at' => '', 'source' => $legacy === '' ? 'none' : 'config', ]; } /** 读取当前状态;返回数组一定含 source 字段:file / config / none */ function tinyimg_token_load($config = []) { $fallback = tinyimg_token_default($config); $file = tinyimg_token_file(); if (!is_file($file)) { return $fallback; } $raw = @file_get_contents($file); if ($raw === false) { return $fallback; } $state = tinyimg_token_decode($raw); if ($state === null) { return $fallback; } $state['source'] = 'file'; return $state; } /** 生成随机 Token;优先 CSPRNG,最后才退化到弱随机 */ function tinyimg_token_generate($bytes = 32) { if (function_exists('random_bytes')) { return bin2hex(random_bytes($bytes)); } if (function_exists('openssl_random_pseudo_bytes')) { return bin2hex(openssl_random_pseudo_bytes($bytes)); } return md5(uniqid('', true) . mt_rand() . microtime(true)) . md5(uniqid('', true) . mt_rand()); } /** 自定义 Token 的格式约束:16~128 位字母数字 / 下划线 / 短横线 */ function tinyimg_token_valid_format($token) { return (bool) preg_match('/^[A-Za-z0-9_-]{16,128}$/', (string) $token); } /** 恒定时间比较;未启用 / 空配置 / 空请求一律拒绝(fail closed) */ function tinyimg_token_verify($state, $provided) { $stored = is_array($state) && isset($state['token']) ? (string) $state['token'] : ''; $enabled = is_array($state) && !empty($state['enabled']); $provided = (string) $provided; if (!$enabled || $stored === '' || $provided === '') { return false; } return function_exists('hash_equals') ? hash_equals($stored, $provided) : $stored === $provided; } /** 脱敏显示:保留前 6 位与后 4 位 */ function tinyimg_token_mask($token) { $token = (string) $token; if ($token === '') { return '(未设置)'; } if (strlen($token) <= 12) { return str_repeat('*', strlen($token)); } return substr($token, 0, 6) . str_repeat('*', 12) . substr($token, -4); } /** 原子写入存储文件;返回 [是否成功, 消息] */ function tinyimg_token_save($token, $enabled, $config = []) { $file = tinyimg_token_file(); $dir = dirname($file); if (!is_dir($dir)) { return [false, 'db 目录不存在']; } if (!is_writable($dir)) { return [false, 'db 目录不可写,请给 Web 用户写权限']; } $previous = tinyimg_token_load($config); $now = date('Y-m-d H:i:s'); $state = [ 'token' => (string) $token, 'enabled' => $enabled ? 1 : 0, 'created_at' => $previous['created_at'] !== '' ? $previous['created_at'] : $now, 'updated_at' => $now, ]; $suffix = function_exists('random_bytes') ? bin2hex(random_bytes(4)) : md5(uniqid('', true)); $tmp = $file . '.tmp.' . $suffix; if (@file_put_contents($tmp, tinyimg_token_encode($state), LOCK_EX) === false) { @unlink($tmp); return [false, '写入临时文件失败']; } @chmod($tmp, 0600); if (!@rename($tmp, $file)) { @unlink($tmp); return [false, '无法覆盖 Token 存储文件']; } @chmod($file, 0600); return [true, 'ok']; } ?>