基于 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
202 lines
6.5 KiB
PHP
202 lines
6.5 KiB
PHP
<?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'];
|
||
}
|
||
?>
|