Files
terry aac91aa9b6 TinyImg 2.0.0:更名、下线 SM.MS、新增后台 Token 设置页
基于 ImgURL 1.x 的二次开发版本,主要变更:

1. 更名
   - 项目定名为 TinyImg,源码中不再出现旧品牌字样(0 处)
   - static/imgurl.js -> static/tinyimg.js
   - db/imgurl-simple.db3 -> db/tinyimg-simple.db3

2. 移除 SM.MS 上传
   - 删除 embed.js 中的 upload.render / smshow / deletesm
   - miniup.html 去掉 SM.MS 选项卡;前台与后台导航移除入口
   - sm.php、functions/sm.php、admin/smadmin.php 改为下线说明页
   - admin/delete.php 移除 type=sm 分支;class.admin.php 删除 querysm()/deletesm()

3. 新增后台 Token 设置(admin/setting.php + functions/token.php)
   - 生成 / 自定义 / 启用 / 停用 / 清空,全部校验 Session CSRF
   - 存储于 db/tinyimg-token.php(首行 <?php exit; 守卫)
   - config.php 的 api_token 仅作兼容回退,保存一次后由文件接管
   - 完整 Token 不写入页面 HTML:默认只渲染掩码,点「显示/复制」时
     经 POST action=reveal(同源 + CSRF + 仅登录会话)按需取回

4. 上传端点鉴权
   - 统一使用 X-TinyImg-Token 请求头,hash_equals 比较,空配置 fail closed
   - 新增 ?ping=1 自检,返回版本、鉴权方式、管理员目录,供写作插件测试连接

5. 版本号
   - 统一为 v2.0.0(20261104),前后台页脚引用 functions/version.php

6. 兼容性修复
   - class.upload.php 中 $size{...} 花括号下标改为 $size[...](PHP 8 已移除该语法)

7. 仓库整理
   - .gitignore 排除 config.php / db/tinyimg-token.php / 运行时目录,
     保留 db/.htaccess 与空模板 db/tinyimg-simple.db3
   - .gitattributes 统一 LF
2026-11-05 17:30:05 +08:00

202 lines
6.5 KiB
PHP
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
/**
* TinyImg API Token 存储与校验(不依赖 Web 环境,可单独被测试脚本加载)。
*
* 存储文件:db/tinyimg-token.php
* 首行是 PHP 守卫,直接通过 URL 访问时只会执行 exit,不会泄漏 Token;
* 第二行是 JSON。即使站点跑在 Nginx 且没有屏蔽 db 目录,也拿不到内容。
*
* 兼容策略:存储文件不存在时,回落到 config.php 的 api_token(旧版部署),
* 后台设置页第一次保存后即以存储文件为准。
*/
require_once __DIR__ . '/version.php';
/** Token 存储文件路径 */
function tinyimg_token_file()
{
if (defined('APP')) {
return rtrim(APP, "/\\") . '/db/tinyimg-token.php';
}
return dirname(__DIR__) . '/db/tinyimg-token.php';
}
/** 文件首行守卫:任何直接 HTTP 访问都会在这里终止 */
function tinyimg_token_guard()
{
return '<?php exit; /* TinyImg API Token store - DO NOT EDIT */ ?>';
}
/** 把状态数组序列化成文件正文(纯函数,便于测试) */
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'];
}
?>