Files
terry 8ac51d3160 TinyImgUploader 2.0.0:Typecho 1.3 图片上传插件(对接 TinyImg 图床)
在撰写文章 / 页面的右侧栏增加图片上传窗口,选图后上传到自建 TinyImg
图床,并把 Markdown 链接插入编辑器光标处。

主要功能
1. 侧栏卡片 + 弹窗上传
   - 挂在 admin/write-post.php 与 write-page.php 的 option 钩子
   - 支持点选、拖入、Ctrl+V 粘贴,上传前可预览
   - 用 getSelection / replaceSelection 插入光标处并触发 input 事件,
     草稿自动保存与实时预览都能同步

2. 三种图床鉴权方式
   - token(默认):X-TinyImg-Token 请求头,未配置则明确拒绝
   - admin:模拟图床后台登录 Cookie(无需改图床,但凭证等价于后台密码)
   - guest:游客上传,图片进 temp/ 并受每日配额限制
   - token / admin 两种模式强制服务端代理,凭证绝不下发浏览器

3. 「测试连接」按钮
   - 读取输入框当前值,无需先保存
   - 经博客同源 Action(带 CSRF)调用图床 functions/upload.php?ping=1
   - 返回图床版本、鉴权方式与管理员目录,并比对是否落在 upload/

4. 为什么必须走服务端代理
   - 实测图床 upload.php 不返回 Access-Control-Allow-Origin,
     浏览器从博客后台直接 POST 会被同源策略拦截

5. 服务端校验
   - 登录态 + 用户组(可选「仅管理员」) + CSRF 令牌
   - 上传大小上限、getimagesize 真实图片头校验(拦 SVG / 伪装脚本)
   - 未认出管理员身份时返回 warn,前端不自动关闭弹窗

6. 附带工具与测试
   - tools/probe.php:命令行连通性自检(只读探测 / 真实上传 / 目录判定)
   - tools/cookie.php:本地计算图床管理员 Cookie 值,不联网
   - tests/:六组共 207 项,含故意错误实现的反证

版本:2.0.0
2026-11-05 17:33:44 +08:00

212 lines
8.6 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 后台 Token 设置页验收测试(桩环境渲染,不需要图床运行、不联网)。
* 运行:php tests/setting_test.php
*
* 这个文件存在的理由:设置页最初把完整 Token 直接写进 input 的 value 属性,
* 页面源码、浏览器缓存、截图里都会留有明文。现在改成「默认只输出掩码,
* 点显示/复制时带 CSRF 向服务器取一次」。下面的断言把这条约束固定住,
* 并且验证错误 CSRF 拿不到 Token —— 否则谁都能用一个 GET 读到凭证。
*/
$stat = ['pass' => 0, 'fail' => 0];
$check = function ($name, $ok, $detail = '') use (&$stat) {
if ($ok) {
$stat['pass']++;
echo ' [PASS] ' . $name . PHP_EOL;
} else {
$stat['fail']++;
echo ' [FAIL] ' . $name . ($detail === '' ? '' : ' -> ' . $detail) . PHP_EOL;
}
};
$root = dirname(__DIR__, 2);
$host = $root . '/TinyImg';
$php = PHP_BINARY;
if (!is_file($host . '/admin/setting.php')) {
fwrite(STDERR, '找不到图床源码:' . $host . '/admin/setting.php' . PHP_EOL);
exit(1);
}
// 沙箱放在项目内而不是系统临时目录:Windows 下 shell_exec 走 cmd.exe,
// 系统临时目录常带 8.3 短名或重定向,容易出现「命令没执行、stdout 为空」。
$sandbox = dirname(__DIR__) . '/.ti_setting_tmp';
$sessDir = $sandbox . '/sess';
/** 递归删除临时目录 */
function setting_rm($dir)
{
if (!is_dir($dir)) {
return;
}
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($it as $f) {
$f->isDir() ? @rmdir($f->getPathname()) : @unlink($f->getPathname());
}
@rmdir($dir);
}
setting_rm($sandbox);
foreach (['admin', 'functions/class', 'tpl/admin', 'db', 'sess'] as $d) {
@mkdir($sandbox . '/' . $d, 0777, true);
}
// 复制被测文件与依赖
copy($host . '/admin/setting.php', $sandbox . '/admin/setting.php');
copy($host . '/functions/token.php', $sandbox . '/functions/token.php');
copy($host . '/functions/version.php', $sandbox . '/functions/version.php');
copy($host . '/functions/version.txt', $sandbox . '/functions/version.txt');
copy($host . '/tpl/admin/header.php', $sandbox . '/tpl/admin/header.php');
copy($host . '/tpl/admin/left.php', $sandbox . '/tpl/admin/left.php');
copy($host . '/tpl/admin/footer.php', $sandbox . '/tpl/admin/footer.php');
// 桩:替代后台登录校验,只提供页面需要的 $config / $database / $pic
file_put_contents($sandbox . '/functions/class/class.admin.php', <<<'PHP'
<?php
$config = ['user' => 'demo-admin', 'domain' => 'https://img.example.com/', 'admindir' => 'upload'];
$database = null;
$pic = null;
PHP
);
// 场景驱动:通过命令行参数控制 GET / POST、Token 状态、CSRF 是否正确
file_put_contents($sandbox . '/driver.php', <<<'PHP'
<?php
$sandbox = __DIR__;
chdir($sandbox . '/admin');
define('APP', $sandbox . '/');
require_once $sandbox . '/functions/token.php';
$case = isset($argv[1]) ? $argv[1] : 'empty';
$csrf = isset($argv[2]) ? $argv[2] : 'good';
if ($case === 'empty') {
tinyimg_token_save('', false, ['user' => 'demo-admin']);
} elseif ($case === 'enabled') {
tinyimg_token_save('SecretTokenValue0123456789abcdef', true, ['user' => 'demo-admin']);
} elseif ($case === 'disabled') {
tinyimg_token_save('SecretTokenValue0123456789abcdef', false, ['user' => 'demo-admin']);
}
$_SERVER['REQUEST_METHOD'] = $case === 'reveal' ? 'POST' : 'GET';
if ($case === 'reveal') {
tinyimg_token_save('SecretTokenValue0123456789abcdef', true, ['user' => 'demo-admin']);
session_id('tisettingtest');
session_start();
$_SESSION['tinyimg_csrf'] = 'CSRF_GOOD';
session_write_close();
$_POST['action'] = 'reveal';
$_POST['csrf'] = $csrf === 'good' ? 'CSRF_GOOD' : 'CSRF_BAD';
session_id('tisettingtest');
}
require $sandbox . '/admin/setting.php';
PHP
);
/** 在沙箱里跑一个场景,返回标准输出 */
$run = function ($case, $csrf = 'good') use ($php, $sandbox, $sessDir) {
// Windows 的 shell_exec 走 cmd.exe,不认 escapeshellarg 生成的单引号,必须用双引号;
// 否则命令根本不会执行、stdout 为空,看起来像「页面没输出」。
$q = function ($value) {
return DIRECTORY_SEPARATOR === '\\'
? '"' . $value . '"'
: escapeshellarg($value);
};
$cmd = $q($php)
. ' -d session.save_path=' . $q($sessDir)
. ' -d display_startup_errors=0 -d display_errors=1 -d error_reporting=E_ALL '
. $q($sandbox . '/driver.php')
. ' ' . $q($case) . ' ' . $q($csrf);
return (string) shell_exec($cmd);
};
$TOKEN = 'SecretTokenValue0123456789abcdef';
echo PHP_EOL . '1. 未设置 Token 时的渲染' . PHP_EOL;
$empty = $run('empty');
$check('页面正常输出(无 Fatal / Parse error)',
$empty !== '' && stripos($empty, 'Fatal error') === false && stripos($empty, 'Parse error') === false,
substr(trim($empty), 0, 120));
$check('显示「未设置」状态', strpos($empty, '未设置') !== false);
$check('无 Token 时「显示 / 复制」按钮禁用',
substr_count($empty, 'id="ti-reveal"') === 1 && preg_match('/id="ti-reveal"\s+disabled/', $empty) === 1);
$check('页面有「重新生成 Token」入口', strpos($empty, '重新生成 Token') !== false);
$check('页面有「填入自定义 Token」表单',
strpos($empty, 'name="custom_token"') !== false);
echo PHP_EOL . '2. 已启用时的渲染(核心安全约束)' . PHP_EOL;
$enabled = $run('enabled');
$check('页面正常输出', $enabled !== '' && stripos($enabled, 'Fatal error') === false);
$check('状态显示「已启用」', strpos($enabled, '已启用') !== false);
$check('【关键】完整 Token 不出现在 HTML 中', strpos($enabled, $TOKEN) === false,
'在页面源码里找到了完整 Token');
$check('只输出掩码', strpos($enabled, 'Secret***') !== false);
$check('掩码同时写入 value 与 data-masked',
substr_count($enabled, 'data-masked') >= 1 && strpos($enabled, 'value="Secret***') !== false);
$check('长度信息可见(便于核对,不泄露内容)', strpos($enabled, '长度 32 位') !== false);
$check('没有 Token 时按钮 disabled,有 Token 时不 disabled',
preg_match('/id="ti-reveal"\s+disabled/', $enabled) !== 1);
$check('页面有脱敏视图说明', strpos($enabled, '完整值不写入页面') !== false);
echo PHP_EOL . '3. 已停用时的渲染' . PHP_EOL;
$disabled = $run('disabled');
$check('状态显示「已停用」', strpos($disabled, '已停用') !== false);
$check('停用时按钮仍可用(Token 还在,只是不接受上传)',
preg_match('/id="ti-reveal"\s+disabled/', $disabled) !== 1);
$check('停用时也不泄露完整 Token', strpos($disabled, $TOKEN) === false);
echo PHP_EOL . '4. 按需取回(reveal)受 CSRF 保护' . PHP_EOL;
$revealOk = $run('reveal', 'good');
$revealBad = $run('reveal', 'bad');
$jsonOk = json_decode($revealOk, true);
$check('CSRF 正确时返回 JSON', is_array($jsonOk) && isset($jsonOk['code']) && $jsonOk['code'] === 1,
substr(trim($revealOk), 0, 120));
$check('CSRF 正确时能拿到完整 Token',
is_array($jsonOk) && isset($jsonOk['token']) && $jsonOk['token'] === $TOKEN);
$check('CSRF 错误时不返回任何 Token',
strpos($revealBad, $TOKEN) === false && strpos($revealBad, '"token"') === false,
'错误 CSRF 竟然拿到了 Token');
$check('CSRF 错误时不是合法 JSON 成功响应',
!(is_array(json_decode($revealBad, true)) && isset(json_decode($revealBad, true)['token'])));
echo PHP_EOL . '5. 反证:错误实现必须被这些断言抓住' . PHP_EOL;
// 反证 A:像最初那样直接把 token 放进 value
$badRender = '<input type="password" value="' . $TOKEN . '" readonly>';
$check('反证 A:把明文写进 value 的实现会被「不含完整 Token」断言否掉',
strpos($badRender, $TOKEN) !== false);
$check('反证 A 同时说明该断言不是恒真', strpos($badRender, $TOKEN) !== false
&& strpos($enabled, $TOKEN) === false);
// 反证 B:reveal 不做 CSRF 校验(任何请求都能读)
$badReveal = function ($csrfOk) use ($TOKEN) {
return json_encode(['code' => 1, 'token' => $TOKEN], JSON_UNESCAPED_UNICODE);
};
$check('反证 B:不校验 CSRF 的实现会在「错误 CSRF」场景泄露 Token',
strpos($badReveal(false), $TOKEN) !== false);
$check('反证 B 对照:真实实现在错误 CSRF 下没有泄露',
strpos($revealBad, $TOKEN) === false);
setting_rm($sandbox);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);