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
This commit is contained in:
terry
2026-11-05 17:30:05 +08:00
parent 39e84a0fac
commit aac91aa9b6
180 changed files with 15976 additions and 2 deletions
+201
View File
@@ -0,0 +1,201 @@
<?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'];
}
?>