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
This commit is contained in:
terry
2026-11-05 17:33:44 +08:00
parent 33e9371f00
commit 8ac51d3160
14 changed files with 3398 additions and 2 deletions
+123
View File
@@ -0,0 +1,123 @@
<?php
use TypechoPlugin\TinyImgUploader\Util;
require_once __DIR__ . '/../Util.php';
/**
* 管理员鉴权契约测试(无需 Typecho、无需联网)。
* 运行:php tests/auth_test.php
*
* 关键点:TinyImg 的 Cookie 模式在不匹配时不会报错,而是静默把图片放进游客目录。
* 因此这里直接复刻 functions/class/class.user.php::check() 的判定公式,
* 验证 Util::adminCookie() 生成的两个字段确实能被图床认成 islogin。
* 同时比对真实源码里的公式,防止图床升级后契约漂移而测试还蒙在鼓里。
*/
$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;
}
};
/** 逐字复刻 class.user.php::check(),$_COOKIE 的值已被 PHP 自动 urldecode */
function tinyimgIsLogin(array $config, array $cookies)
{
$user1 = $config['user'] . md5('tinyimg' . $config['password']);
$user2 = (isset($cookies['user']) ? rawurldecode($cookies['user']) : '')
. (isset($cookies['password']) ? rawurldecode($cookies['password']) : '');
return $user1 === $user2 ? 'islogin' : 'nologin';
}
$root = dirname(__DIR__, 2) . '/TinyImg';
$userSource = $root . '/functions/class/class.user.php';
$uploadSource = $root . '/functions/upload.php';
echo PHP_EOL . '1. 与 TinyImg 源码的契约比对' . PHP_EOL;
if (is_file($userSource) && is_file($uploadSource)) {
$u = file_get_contents($userSource);
$p = file_get_contents($uploadSource);
$check('login() 用 md5("tinyimg" + 密码) 生成 password Cookie',
strpos($u, 'md5("tinyimg".$admin[\'password\'])') !== false);
$check('check() 期望 user + md5("tinyimg" + 密码)',
strpos($u, 'md5("tinyimg".$userinfo[\'password\'])') !== false);
$check('check() 比较的是 $_COOKIE[\'user\'] . $_COOKIE[\'password\']',
strpos($u, '$_COOKIE[\'user\'].$_COOKIE[\'password\']') !== false);
$check('upload.php 登录时走 admindir',
strpos($p, 'if($status == \'islogin\')') !== false && strpos($p, '$updir = $config[\'admindir\'];') !== false);
$check('upload.php 游客分支才调用 limitnum()',
strpos($p, '$updir = $config[\'userdir\'];') !== false && strpos($p, '$basis->limitnum();') !== false);
$check('upload.php 先校验 Referer 再检查登录态',
strpos($p, 'HTTP_REFERER') !== false
&& strpos($p, 'HTTP_REFERER') < strpos($p, '$basis->check($config)'));
} else {
echo ' [SKIP] 未找到 TinyImg 源码目录,跳过源码契约比对(不影响下面的纯逻辑测试)' . PHP_EOL;
}
echo PHP_EOL . '2. Util::adminCookie 生成的凭证能否通过图床 check()' . PHP_EOL;
$config = ['user' => 'imgadmin', 'password' => 'p@ssw0rd'];
$plain = Util::adminCookie($config['user'], $config['password']);
$md5 = md5('tinyimg' . $config['password']);
$check('明文密码 -> islogin', tinyimgIsLogin($config, $plain) === 'islogin', json_encode($plain));
$check('password Cookie 值等于 md5("tinyimg"+密码)', $plain['password'] === $md5, $plain['password']);
$check('直接填 32 位 Cookie 值 -> islogin',
tinyimgIsLogin($config, Util::adminCookie($config['user'], $md5)) === 'islogin');
$check('32 位大写十六进制也能识别并归一',
Util::adminCookie($config['user'], strtoupper($md5))['password'] === $md5);
$check('错误密码 -> nologin',
tinyimgIsLogin($config, Util::adminCookie($config['user'], 'wrong')) === 'nologin');
$check('错误账号 -> nologin',
tinyimgIsLogin($config, Util::adminCookie('someone', $config['password'])) === 'nologin');
$check('账号或密码为空 -> null',
Util::adminCookie('', 'x') === null && Util::adminCookie('x', '') === null);
$check('含空格 / 中文的账号 urlencode 后仍能通过 check()',
tinyimgIsLogin(['user' => '张 三', 'password' => 'pw'], Util::adminCookie('张 三', 'pw')) === 'islogin');
echo PHP_EOL . '3. 测试集有效性反证(故意写错的实现)' . PHP_EOL;
// 错误实现 A:漏掉盐值 "tinyimg",直接 md5(密码)
$badNoSalt = ['user' => $config['user'], 'password' => md5($config['password'])];
$check('错误实现 A(无盐 md5)必须被图床判为 nologin',
tinyimgIsLogin($config, $badNoSalt) === 'nologin');
// 错误实现 B:把明文密码直接当成 Cookie 值
$badPlain = ['user' => $config['user'], 'password' => $config['password']];
$check('错误实现 B(明文当 Cookie)必须被判为 nologin',
tinyimgIsLogin($config, $badPlain) === 'nologin');
// 错误实现 C:把账号也拼进 md5
$badBoth = ['user' => $config['user'], 'password' => md5('tinyimg' . $config['user'] . $config['password'])];
$check('错误实现 C(账号参与哈希)必须被判为 nologin',
tinyimgIsLogin($config, $badBoth) === 'nologin');
$check('同一份配置下正确实现必须是 islogin(证明测试能区分对错)',
tinyimgIsLogin($config, $plain) === 'islogin');
echo PHP_EOL . '4. Cookie 合并与目录判定' . PHP_EOL;
$merged = Util::mergeCookie('theme=dark; user=old; PHPSESSID=abc', $plain);
$check('保留用户自定义 Cookie', strpos($merged, 'theme=dark') !== false && strpos($merged, 'PHPSESSID=abc') !== false, $merged);
$check('覆盖同名的 user / password',
strpos($merged, 'user=old') === false && strpos($merged, 'password=' . $md5) !== false, $merged);
$check('空 Cookie 头也能生成', Util::mergeCookie('', $plain) === 'user=' . $config['user'] . '; password=' . $md5);
$check('管理员目录 URL 判定为 true',
Util::inAdminDir('https://img.example.com/tinyimg/upload/2611/abcd.jpg', 'upload') === true);
$check('游客目录 URL 判定为 false(可据此发出警告)',
Util::inAdminDir('https://img.example.com/tinyimg/temp/2611/abcd.jpg', 'upload') === false);
$check('目录名前后斜杠被归一化',
Util::inAdminDir('https://img.example.com/tinyimg/upload/2611/abcd.jpg', '/upload/') === true);
$check('目录名留空 -> null(跳过校验)',
Util::inAdminDir('https://img.example.com/tinyimg/temp/2611/abcd.jpg', '') === null);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
+153
View File
@@ -0,0 +1,153 @@
<?php
/**
* TinyImg 2.0 图床侧改造验收测试(无需 Typecho、无需联网、不上传任何图片)。
* 运行:php tests/host_test.php
*
* 检查:品牌去旧名、版本号、SM.MS 通道彻底关闭、后台 Token 设置页、
* 关键静态资源与数据库改名,以及一个反证(故意留一个 SM.MS 请求必须被抓到)。
*/
$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';
$plugin = $root . '/TinyImgUploader';
// 拼接构造,避免测试代码自身成为「旧品牌字面量」的命中项
$forbidden = 'img' . 'url';
/** 递归收集文本文件(跳过第三方 layui 与二进制文件) */
function host_text_files($dir)
{
$out = [];
$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS));
foreach ($it as $f) {
$path = str_replace('\\', '/', $f->getPathname());
if (strpos($path, '/static/layui/') !== false) {
continue;
}
$ext = strtolower(pathinfo($path, PATHINFO_EXTENSION));
if (!in_array($ext, ['php', 'js', 'html', 'htm', 'css', 'txt', 'md', 'json', 'svg', 'htaccess'], true)
&& !in_array(basename($path), ['.htaccess', '.gitignore', 'LICENSE'], true)) {
continue;
}
$out[] = ['path' => $path, 'body' => file_get_contents($path)];
}
return $out;
}
$hostFiles = host_text_files($host);
$pluginFiles = host_text_files($plugin);
echo PHP_EOL . '1. 更名与版本号' . PHP_EOL;
$oldNameHits = 0;
foreach (array_merge($hostFiles, $pluginFiles) as $f) {
$oldNameHits += substr_count(strtolower($f['body']), $forbidden);
}
$check('两个工程源码里旧品牌字样为 0', $oldNameHits === 0, '命中 ' . $oldNameHits . ' 处');
$version = trim(file_get_contents($host . '/functions/version.txt'));
$check('版本号更新为 v2.0.0', strpos($version, 'v2.0.0') === 0, $version);
$check('版本文件带构建日期', (bool) preg_match('/\(\d{8}\)/', $version), $version);
$check('存在统一版本模块 functions/version.php', is_file($host . '/functions/version.php'));
$check('旧的 v1.40 版本号不再出现在版本文件', strpos($version, '1.40') === false);
$check('前台关于页读取统一版本号',
strpos(file_get_contents($host . '/about.php'), 'TINYIMG_VERSION') !== false);
$check('后台关于弹窗读取统一版本号',
strpos(file_get_contents($host . '/admin/about.php'), 'TINYIMG_VERSION') !== false);
$check('站点标题统一为 TinyImg',
strpos(file_get_contents($host . '/index.php'), 'TinyImg') !== false
&& strpos(file_get_contents($host . '/tpl/admin/header.php'), '<h1>TinyImg</h1>') !== false);
echo PHP_EOL . '2. SM.MS 上传通道已屏蔽 / 移除' . PHP_EOL;
$smUploadHits = 0;
foreach ($hostFiles as $f) {
$smUploadHits += substr_count(strtolower($f['body']), 'sm.ms/api');
}
$check('没有任何对 sm.ms 上传 API 的请求', $smUploadHits === 0, '命中 ' . $smUploadHits . ' 处');
$miniup = file_get_contents($host . '/miniup.html');
$check('极简上传页没有 SM.MS 选项卡', strpos($miniup, '<li>SM.MS</li>') === false);
$check('极简上传页没有 #sm 文件输入', strpos($miniup, 'id="sm"') === false);
$check('极简上传页保留本站拖拽上传', strpos($miniup, 'id="upimg"') !== false);
$embed = file_get_contents($host . '/static/embed.js');
$check('embed.js 没有 smshow / deletesm 函数',
strpos($embed, 'function smshow') === false && strpos($embed, 'function deletesm') === false);
$check('embed.js 保留本站上传逻辑',
strpos($embed, "url: 'functions/upload.php'") !== false);
$left = file_get_contents($host . '/tpl/admin/left.php');
$check('后台左侧菜单没有 SM.MS 入口', strpos($left, 'smadmin.php') === false);
$check('后台左侧菜单新增 Token 设置入口', strpos($left, 'setting.php') !== false);
$check('后台顶部导航新增 Token 设置入口',
strpos(file_get_contents($host . '/tpl/admin/header.php'), './setting.php') !== false);
$check('前台导航没有 SM.MS 入口',
strpos(file_get_contents($host . '/tpl/user/header.php'), 'sm.php') === false);
$smPage = file_get_contents($host . '/sm.php');
$check('sm.php 返回 410 且不提供上传表单',
strpos($smPage, 'http_response_code(410)') !== false && strpos($smPage, 'id="sm"') === false);
$smFunc = file_get_contents($host . '/functions/sm.php');
$check('functions/sm.php fail closed,不写数据库',
strpos($smFunc, 'http_response_code(410)') !== false
&& strpos($smFunc, '$database->insert') === false);
$smAdmin = file_get_contents($host . '/admin/smadmin.php');
$check('admin/smadmin.php 不再查询数据库', strpos($smAdmin, 'querysm') === false);
$check('admin/delete.php 拒绝 type=sm',
strpos(file_get_contents($host . '/admin/delete.php'), "=== 'sm'") !== false);
$adminClass = file_get_contents($host . '/functions/class/class.admin.php');
$check('class.admin.php 已移除 querysm / deletesm',
strpos($adminClass, 'function querysm') === false && strpos($adminClass, 'function deletesm') === false);
$check('upgrade.php 不再创建 sm 表',
strpos(file_get_contents($host . '/upgrade.php'), 'CREATE TABLE') === false);
echo PHP_EOL . '3. Token 设置页与存储' . PHP_EOL;
$check('admin/setting.php 存在', is_file($host . '/admin/setting.php'));
$check('functions/token.php 存在', is_file($host . '/functions/token.php'));
$check('Token 存储文件带 PHP 守卫(不会通过 URL 泄漏)',
strpos(file_get_contents($host . '/functions/token.php'), "<?php exit;") !== false);
$check('config-simple.php 仍保留 api_token 兼容项',
strpos(file_get_contents($host . '/config-simple.php'), 'api_token') !== false);
echo PHP_EOL . '4. 静态资源与数据库改名' . PHP_EOL;
$check('static/tinyimg.js 存在', is_file($host . '/static/tinyimg.js'));
$check('旧的 static/' . $forbidden . '.js 已不存在', !is_file($host . '/static/' . $forbidden . '.js'));
$check('油猴脚本的站点地址可配置',
strpos(file_get_contents($host . '/static/tinyimg.js'), 'TINYIMG_BASE') !== false);
$check('db/tinyimg-simple.db3 存在', is_file($host . '/db/tinyimg-simple.db3'));
$check('旧的 db/' . $forbidden . '-simple.db3 已不存在', !is_file($host . '/db/' . $forbidden . '-simple.db3'));
$check('安装器使用新的数据库文件名',
strpos(file_get_contents($host . '/functions/class/class.install.php'), 'tinyimg-simple.db3') !== false);
$check('config-simple.php 指向新的数据库文件',
strpos(file_get_contents($host . '/config-simple.php'), 'db/tinyimg.db3') !== false);
echo PHP_EOL . '5. 测试集有效性反证' . PHP_EOL;
// 故意伪造一份「还留着 SM.MS 上传」的代码,检测器必须判为不合格
$fakeSmUpload = "upload.render({ elem: '#sm', url: 'https://sm.ms/api/upload' });";
$dumbDetector = function ($code) {
return strpos(strtolower($code), 'sm.ms/api') === false;
};
$check('检测器能抓到故意保留的 SM.MS 上传请求', $dumbDetector($fakeSmUpload) === false);
$check('真实 embed.js 通过同一检测器',
$dumbDetector($embed) === true);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
+225
View File
@@ -0,0 +1,225 @@
<?php
/**
* 渲染冒烟测试:用最小 stub 模拟 Typecho 1.3 环境,直接调用两个钩子回调,
* 检查输出的侧栏卡片、弹窗 DOM、注入配置与脚本是否完整。
*
* 运行:php tests/render_test.php
* 不需要真实 Typecho、不需要数据库、不需要联网。
*/
namespace Typecho\Plugin {
interface PluginInterface
{
}
class Exception extends \Exception
{
}
}
namespace Widget {
class Options
{
public $markdown = true;
/** 让测试可以模拟「管理员账号密码已填好」的场景 */
public static $pluginConfig = [];
public static function alloc()
{
return new self();
}
public function plugin($name)
{
return new class (self::$pluginConfig) {
private $cfg;
public function __construct($cfg)
{
$this->cfg = $cfg;
}
public function toArray()
{
return $this->cfg;
}
};
}
}
class Security
{
public static function alloc()
{
return new self();
}
public function getIndex($path)
{
// 模拟 Typecho:getTokenUrl 会把 _ 参数并进已有 query
$sep = strpos($path, '?') === false ? '?' : '&';
return 'https://blog.example.com' . $path . $sep . '_=FAKE_TOKEN';
}
}
}
namespace {
use TypechoPlugin\TinyImgUploader\Plugin;
define('__TYPECHO_ROOT_DIR__', dirname(__DIR__));
function _t($text)
{
return $text;
}
require_once dirname(__DIR__) . '/Util.php';
require_once dirname(__DIR__) . '/Plugin.php';
$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;
}
};
ob_start();
Plugin::renderOption(null);
$option = ob_get_clean();
ob_start();
Plugin::renderFooter(null);
$footer = ob_get_clean();
echo PHP_EOL . '1. option 钩子:右侧栏卡片' . PHP_EOL;
$check('输出 #iu-box 容器', strpos($option, 'id="iu-box"') !== false);
$check('输出打开按钮 #iu-open', strpos($option, 'id="iu-open"') !== false);
$check('输出状态行 #iu-status', strpos($option, 'id="iu-status"') !== false);
$check('显示 2 MB 上限提示', strpos($option, '2 MB') !== false);
$check('侧栏显示图床身份(默认 API Token)',
strpos($option, '图床身份:') !== false && strpos($option, '<strong>API Token</strong>') !== false);
$check('未填凭证时侧栏给出红色告警并指向图床后台设置页',
strpos($option, '未填写 API Token') !== false
&& strpos($option, 'Token 设置') !== false);
$check('接口地址仍是占位值时侧栏给出红色告警',
strpos($option, '仍是占位值') !== false);
$check('侧栏不含任何 Token 明文 / 图床地址',
strpos($option, 'SUPER_SECRET') === false && strpos($option, 'img.example.com') === false);
echo PHP_EOL . '2. bottom 钩子:弹窗与脚本' . PHP_EOL;
$check('输出 #iu-modal 弹窗', strpos($footer, 'id="iu-modal"') !== false);
$check('输出确认按钮 #iu-confirm', strpos($footer, 'id="iu-confirm"') !== false);
$check('输出文件输入 #iu-file', strpos($footer, 'id="iu-file"') !== false);
$check('包含 insertMarkdown 插入逻辑', strpos($footer, 'function insertMarkdown') !== false);
$check('包含捕获阶段粘贴拦截', strpos($footer, "addEventListener('paste'") !== false);
$check('包含 CSS 样式块', strpos($footer, '.iu-modal') !== false);
echo PHP_EOL . '3. 注入的前端配置' . PHP_EOL;
$matched = preg_match('/window\.IU_CFG=(\{.*?\});<\/script>/s', $footer, $matches);
$cfg = $matched ? json_decode($matches[1], true) : null;
$check('window.IU_CFG 是合法 JSON', is_array($cfg), $matched ? $matches[1] : '未匹配到配置');
$check('默认走服务端代理', is_array($cfg) && isset($cfg['mode']) && $cfg['mode'] === 'proxy');
$check(
'Action 地址带 CSRF 令牌',
is_array($cfg) && isset($cfg['actionUrl'])
&& strpos($cfg['actionUrl'], '/action/tinyimg-uploader?_=FAKE_TOKEN') !== false,
is_array($cfg) && isset($cfg['actionUrl']) ? $cfg['actionUrl'] : ''
);
$check('代理模式下不把 token 下发到浏览器', is_array($cfg) && !array_key_exists('token', $cfg));
$check('代理模式下不把图床地址下发到浏览器', is_array($cfg) && !array_key_exists('apiUrl', $cfg));
$check(
'默认插入模板正确',
is_array($cfg) && isset($cfg['template']) && $cfg['template'] === '![%alt%](%url%)'
);
echo PHP_EOL . '4. 身份失效警告的前端处理' . PHP_EOL;
$check('上传成功分支里处理服务端返回的 warn', strpos($footer, 'data.warn') !== false);
$check('有 warn 时不自动关闭弹窗', strpos($footer, 'showError(data.warn)') !== false);
$check('状态行区分管理员 / 游客', strpos($footer, "'管理员' : '游客'") !== false);
echo PHP_EOL . '5. Token 模式:凭证隔离 + 强制服务端代理' . PHP_EOL;
\Widget\Options::$pluginConfig = [
'authMode' => 'token',
'token' => 'SUPER_SECRET_TOKEN_VALUE',
'adminDir' => 'upload',
'mode' => 'direct', // 故意直连,验证会被强制改回代理
'allowGroup' => 'administrator',
];
ob_start();
Plugin::renderOption(null);
Plugin::renderFooter(null);
$withToken = ob_get_clean();
$check('已配置 Token 时侧栏不再报「未填写」', strpos($withToken, '未填写 API Token') === false);
$check('页面源码里不含 Token 明文', strpos($withToken, 'SUPER_SECRET_TOKEN_VALUE') === false);
$check('页面源码里不含图床地址', strpos($withToken, 'img.example.com') === false);
$check('身份标识为 API Token', strpos($withToken, '<strong>API Token</strong>') !== false);
preg_match('/window\.IU_CFG=(\{.*?\});<\/script>/s', $withToken, $m2);
$cfg2 = isset($m2[1]) ? json_decode($m2[1], true) : null;
$check('即使设置里选了直连,Token 模式仍强制 proxy',
is_array($cfg2) && isset($cfg2['mode']) && $cfg2['mode'] === 'proxy');
$check('注入配置里没有 token / apiUrl 字段',
is_array($cfg2) && !array_key_exists('token', $cfg2) && !array_key_exists('apiUrl', $cfg2));
echo PHP_EOL . '6. Cookie 模式(回退方案):凭证同样隔离' . PHP_EOL;
\Widget\Options::$pluginConfig = [
'authMode' => 'admin',
'adminUser' => 'imgadmin',
'adminSecret' => 'SUPER_SECRET_PLAINTEXT',
'adminDir' => 'upload',
'allowGroup' => 'administrator',
];
ob_start();
Plugin::renderOption(null);
Plugin::renderFooter(null);
$withCookie = ob_get_clean();
$check('已配置时侧栏不再报「未填写」', strpos($withCookie, '未填写管理员账号') === false);
$check('页面源码里不含明文密码 / Cookie 值',
strpos($withCookie, 'SUPER_SECRET_PLAINTEXT') === false
&& strpos($withCookie, 'password=') === false);
$check('页面源码里不含图床管理员账号', strpos($withCookie, 'imgadmin') === false);
$check('身份标识为管理员 Cookie', strpos($withCookie, '<strong>管理员 Cookie</strong>') !== false);
echo PHP_EOL . '7. 设置页「测试连接」按钮' . PHP_EOL;
$testHtml = Plugin::testButtonHtml();
$check('渲染测试按钮与结果区',
strpos($testHtml, 'id="ti-test-btn"') !== false
&& strpos($testHtml, 'id="ti-test-result"') !== false);
$check('按钮文案是「测试连接」', strpos($testHtml, '测试连接') !== false);
$check('测试 URL 指向 do=test 且带 CSRF 令牌',
strpos($testHtml, '/action/tinyimg-uploader?do=test&_=FAKE_TOKEN') !== false);
$check('用 fetch 发 POST 并读取输入框里的 Token',
strpos($testHtml, "fetch(URL") !== false
&& strpos($testHtml, "input[name=\"token\"]") !== false
&& strpos($testHtml, "fd.append('token'") !== false);
$check('页面源码里不出现图床地址或 Token 明文',
strpos($testHtml, 'SUPER_SECRET') === false
&& strpos($testHtml, 'X-TinyImg-Token') === false);
$check('提示语说明无需先保存即可测试',
strpos($testHtml, '无需先保存') !== false);
preg_match('#<script>(.*?)</script>#s', $testHtml, $jsMatch);
$check('测试按钮脚本被完整包在 <script> 中', !empty($jsMatch[1]));
$check('测试按钮脚本里没有残留占位符',
isset($jsMatch[1]) && strpos($jsMatch[1], '__TEST_URL__') === false);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
}
+211
View File
@@ -0,0 +1,211 @@
<?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);
+202
View File
@@ -0,0 +1,202 @@
<?php
/**
* TinyImg 2.0 API Token 契约测试(无需 Typecho、无需联网、不上传任何图片)。
* 运行:php tests/token_test.php
*
* 覆盖:
* 1. 直接加载图床 functions/token.php,测真实纯函数;
* 2. 源码级断言 functions/upload.php 的 Token 门与 ?ping=1 自检;
* 3. 源码级断言后台 Token 设置页的 CSRF / 四种操作 / 守卫说明;
* 4. 三个「故意写错的实现」反证:证明测试集能抓到真实漏洞。
*/
$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;
}
};
$host = dirname(__DIR__, 2) . '/TinyImg';
$tokenFile = $host . '/functions/token.php';
$uploadFile = $host . '/functions/upload.php';
$settingFile = $host . '/admin/setting.php';
$adminClass = $host . '/functions/class/class.admin.php';
echo PHP_EOL . '1. 交付文件完整性' . PHP_EOL;
foreach (['Token 存储模块' => $tokenFile, '上传端点' => $uploadFile, '后台设置页' => $settingFile] as $label => $path) {
$check($label . '存在', is_file($path), $path);
}
require_once $tokenFile;
echo PHP_EOL . '2. Token 存储文件:编解码与守卫' . PHP_EOL;
$state = [
'token' => 'Abc_123-XYZ789abcdef',
'enabled' => 1,
'created_at' => '2026-11-04 10:00:00',
'updated_at' => '2026-11-04 11:00:00',
];
$raw = tinyimg_token_encode($state);
$decoded = tinyimg_token_decode($raw);
$check('编码首行是 <?php exit; 守卫(直接访问 URL 不会输出 Token)',
strpos($raw, '<?php exit;') === 0);
$check('JSON 载荷在第二行', count(explode("\n", trim($raw))) >= 2);
$check('解码还原 token / enabled / 时间戳',
is_array($decoded) && $decoded['token'] === $state['token']
&& $decoded['enabled'] === 1 && $decoded['created_at'] === $state['created_at']);
$check('解码拒绝没有守卫的裸 JSON', tinyimg_token_decode('{"token":"x"}') === null);
$check('解码拒绝损坏的 JSON', tinyimg_token_decode("<?php exit; ?>\n{not json") === null);
$check('解码拒绝缺少 token 字段', tinyimg_token_decode("<?php exit; ?>\n{\"enabled\":1}") === null);
$check('encode 对 enabled=0 输出 0',
strpos(tinyimg_token_encode(['token' => 'x', 'enabled' => 0]), '"enabled":0') !== false);
echo PHP_EOL . '3. Token 校验:正例 / 反例 / fail closed' . PHP_EOL;
$enabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 1];
$check('正确 Token -> 通过', tinyimg_token_verify($enabled, 'S3cr3tTokenValue_123456') === true);
$check('错误 Token -> 拒绝', tinyimg_token_verify($enabled, 'wrong') === false);
$check('空请求 -> 拒绝', tinyimg_token_verify($enabled, '') === false);
$check('未配置 Token + 空请求 -> 拒绝(不能提权)',
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
$check('未配置 Token + 任意请求 -> 拒绝',
tinyimg_token_verify(['token' => '', 'enabled' => 1], 'anything') === false);
$check('已停用 -> 即使 Token 正确也拒绝',
tinyimg_token_verify(['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0], 'S3cr3tTokenValue_123456') === false);
$check('真实实现使用 hash_equals 恒定时间比较',
strpos(file_get_contents($tokenFile), 'hash_equals($stored, $provided)') !== false);
echo PHP_EOL . '4. 生成 / 格式 / 脱敏 / 旧配置兼容' . PHP_EOL;
$generated = tinyimg_token_generate(32);
$check('生成 64 位十六进制 Token', (bool) preg_match('/^[a-f0-9]{64}$/', $generated), $generated);
$check('两次生成不相同', tinyimg_token_generate(32) !== tinyimg_token_generate(32));
$check('格式校验接受 16~128 位合法字符', tinyimg_token_valid_format(str_repeat('a', 16)));
$check('格式校验拒绝过短', !tinyimg_token_valid_format('abc'));
$check('格式校验拒绝空格 / 引号等危险字符', !tinyimg_token_valid_format('abc def"123456') && !tinyimg_token_valid_format("a'b123456789012"));
$check('脱敏保留首尾且不含完整 Token',
strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), '************') !== false
&& strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), 'abcdefghijklmnopqrstuvwxyz') === false);
$check('脱敏空值给出「未设置」', tinyimg_token_mask('') === '(未设置)');
$fromConfig = tinyimg_token_default(['api_token' => 'legacy-token-value']);
$check('旧版 config.php 的 api_token 会被自动接管',
$fromConfig['token'] === 'legacy-token-value' && $fromConfig['enabled'] === 1
&& $fromConfig['source'] === 'config');
$noConfig = tinyimg_token_default([]);
$check('无旧配置时默认停用(fail closed)',
$noConfig['enabled'] === 0 && $noConfig['source'] === 'none');
echo PHP_EOL . '5. 上传端点源码契约' . PHP_EOL;
$u = is_file($uploadFile) ? file_get_contents($uploadFile) : '';
$check('读取 X-TinyImg-Token 请求头', strpos($u, 'HTTP_X_TINYIMG_TOKEN') !== false);
$check('兼容 POST 字段 token', strpos($u, "\$_POST['token']") !== false);
$check('调用 tinyimg_token_load / tinyimg_token_verify',
strpos($u, 'tinyimg_token_load($config)') !== false
&& strpos($u, 'tinyimg_token_verify($tokenState, $reqToken)') !== false);
$check('校验失败明确报错,不静默回落',
strpos($u, "\$basis->re_error(") !== false && strpos($u, "'API Token 无效!'") !== false);
$check('未配置 / 已停用分别给出可诊断的报错',
strpos($u, 'API Token 未配置') !== false && strpos($u, 'API Token 上传已停用') !== false);
$check('?ping=1 缺少 Token 时直接拒绝', strpos($u, "缺少 API Token") !== false);
$check('?ping=1 成功返回版本与管理员目录',
strpos($u, "'version' => TINYIMG_VERSION") !== false
&& strpos($u, "'admin_dir'") !== false);
$check('校验通过才置 islogin', strpos($u, "\$status = 'islogin';") !== false);
$check('不带 Token 时保留原 Referer + Cookie 逻辑',
strpos($u, 'HTTP_REFERER') !== false && strpos($u, '$basis->check($config)') !== false);
$check('原有上传主体未被改写',
strpos($u, '$basis->limitnum();') !== false
&& strpos($u, "\$handle->file_max_size = '2097152'") !== false
&& strpos($u, "\$handle->process('../'.\$updir") !== false);
$check('上传端点不含旧品牌字符串', strpos(strtolower($u), 'img' . 'url') === false);
echo PHP_EOL . '6. 后台设置页与权限边界' . PHP_EOL;
$s = is_file($settingFile) ? file_get_contents($settingFile) : '';
$check('设置页复用后台登录鉴权', strpos($s, 'class.admin.php') !== false);
$check('写操作校验 Session CSRF', strpos($s, "hash_equals(\$csrf, \$_POST['csrf'])") !== false);
$check('提供重新生成 / 自定义保存 / 启停 / 清空四种操作',
strpos($s, "=== 'regenerate'") !== false && strpos($s, "=== 'save'") !== false
&& strpos($s, "=== 'toggle'") !== false && strpos($s, "=== 'clear'") !== false);
$check('页面显示 Token 且可显示/隐藏/复制',
strpos($s, 'id="ti-token"') !== false && strpos($s, 'ti-reveal') !== false
&& strpos($s, 'ti-copy') !== false);
$check('页面给出连接信息与 ping 自检示例',
strpos($s, 'X-TinyImg-Token') !== false && strpos($s, 'ping=1') !== false);
$check('后台管理类不认识 Token(Token 泄露无法进后台)',
is_file($adminClass) && strpos(file_get_contents($adminClass), 'api_token') === false);
echo PHP_EOL . '7. 测试集有效性反证(故意写错的实现)' . PHP_EOL;
// 错误实现 A:漏掉 enabled 检查 —— 管理员在后台停用 Token 后,旧 Token 仍能上传
$badNoEnabledCheck = function ($state, $provided) {
$stored = isset($state['token']) ? $state['token'] : '';
return $stored !== '' && $provided !== '' && hash_equals($stored, $provided);
};
$disabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0];
$check('错误实现 A 在「已停用」状态下仍放行(真实漏洞)',
$badNoEnabledCheck($disabled, 'S3cr3tTokenValue_123456') === true);
$check('真实实现在同样输入下必须拒绝',
tinyimg_token_verify($disabled, 'S3cr3tTokenValue_123456') === false);
// 错误实现 B:用 == 松散比较且不检查空值 —— 空配置 + 空请求直接提权
$badLooseCompare = function ($state, $provided) {
return $state['token'] == $provided;
};
$check('错误实现 B 在「空配置 + 空请求」下放行(真实漏洞)',
$badLooseCompare(['token' => '', 'enabled' => 1], '') === true);
$check('真实实现在同样输入下必须拒绝',
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
// 错误实现 C:子串匹配当校验
$badSubstring = function ($state, $provided) {
return $provided !== '' && strpos($state['token'], $provided) !== false;
};
$check('错误实现 C 让短前缀冒充 Token 通过',
$badSubstring($enabled, substr($enabled['token'], 0, 4)) === true);
$check('真实实现必须拒绝短前缀',
tinyimg_token_verify($enabled, substr($enabled['token'], 0, 4)) === false);
echo PHP_EOL . '8. 真实文件读写(临时目录,不碰线上数据)' . PHP_EOL;
$tmp = sys_get_temp_dir() . '/tinyimg-token-test-' . bin2hex(random_bytes(4));
@mkdir($tmp . '/db', 0700, true);
if (!defined('APP')) {
define('APP', $tmp . '/');
}
$saved = tinyimg_token_save('RealFileToken_123456', true, []);
$check('保存成功', $saved[0] === true, $saved[1]);
$path = tinyimg_token_file();
$check('存储文件落在 db/ 目录', is_file($path) && basename($path) === 'tinyimg-token.php', $path);
$check('存储文件首行是 PHP exit 守卫',
strpos(file_get_contents($path), '<?php exit;') === 0);
$loaded = tinyimg_token_load([]);
$check('读回 Token 且来源标记为 file',
$loaded['token'] === 'RealFileToken_123456' && $loaded['enabled'] === 1
&& $loaded['source'] === 'file', json_encode($loaded));
$check('读回状态能通过校验', tinyimg_token_verify($loaded, 'RealFileToken_123456') === true);
$check('停用后读回状态不再放行', (function () use ($tmp) {
tinyimg_token_save('RealFileToken_123456', false, []);
return tinyimg_token_verify(tinyimg_token_load([]), 'RealFileToken_123456') === false;
})());
$check('自定义非法 Token 不会被写入', !tinyimg_token_valid_format('bad token!'));
@unlink($path);
@rmdir($tmp . '/db');
@rmdir($tmp);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
+171
View File
@@ -0,0 +1,171 @@
<?php
use TypechoPlugin\TinyImgUploader\Util;
require_once __DIR__ . '/../Util.php';
/**
* Util 纯函数测试(无需 Typecho、无需联网)
* 运行:php tests/util_test.php
*
* 除了正例 / 反例,还内置两个「故意写错的实现」,用来证明测试集
* 确实能区分正确实现与错误实现,而不是无论怎么写都能通过。
*/
$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;
}
};
$base = 'https://img.example.com/tinyimg/functions/upload.php';
echo PHP_EOL . '1. 图床响应解析' . PHP_EOL;
$cases = [
[
'name' => 'TinyImg 2.0 成功响应(源码里的字段结构)',
'body' => '{"code":1,"id":9527,"url":"https://img.example.com/tinyimg/temp/2611/abcd.jpg","width":800,"height":600}',
'code' => 1,
'url' => 'https://img.example.com/tinyimg/temp/2611/abcd.jpg',
],
[
'name' => 'TinyImg 2.0 失败响应(Token 无效 / 非法请求)',
'body' => '{"code":0,"msg":"\u975e\u6cd5\u8bf7\u6c42\uff01"}',
'code' => 0,
'url' => null,
],
[
'name' => 'TinyImg 2.x 成功响应(data.url 嵌套)',
'body' => '{"code":200,"msg":"success","data":{"url":"https://img.example.com/a.png"}}',
'code' => 1,
'url' => 'https://img.example.com/a.png',
],
[
'name' => '通用 success / data.url 响应',
'body' => '{"success":true,"data":{"url":"https://img.example.com/b.jpg"}}',
'code' => 1,
'url' => 'https://img.example.com/b.jpg',
],
[
'name' => 'code=0 但带了 url,仍必须判失败',
'body' => '{"code":0,"url":"https://img.example.com/c.jpg","msg":"非法请求"}',
'code' => 0,
'url' => null,
],
[
'name' => '非 JSON 的 HTML 错误页',
'body' => '<html><body>500 Internal Server Error</body></html>',
'code' => 0,
'url' => null,
],
[
'name' => '空响应(PHP 报错 / 5xx 常见表现)',
'body' => '',
'code' => 0,
'url' => null,
],
[
'name' => 'JSON 前有 PHP notice 也能解析',
'body' => 'Notice: undefined index in upload.php' . "\n" . '{"code":1,"url":"https://img.example.com/d.png"}',
'code' => 1,
'url' => 'https://img.example.com/d.png',
],
];
foreach ($cases as $case) {
$got = Util::parseResponse($case['body'], $base);
$ok = ($got['code'] === $case['code']) && (($got['url'] ?: null) === $case['url']);
$check($case['name'], $ok, json_encode($got, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
}
echo PHP_EOL . '2. 图片地址归一化' . PHP_EOL;
$normalized = [
['{"code":1,"url":"/tinyimg/temp/2611/x.png"}', 'https://img.example.com/tinyimg/temp/2611/x.png'],
['{"code":1,"url":"//cdn.example.com/x.png"}', 'https://cdn.example.com/x.png'],
['{"code":1,"url":"temp/2611/x.jpg"}', 'https://img.example.com/tinyimg/functions/temp/2611/x.jpg'],
];
foreach ($normalized as $item) {
$got = Util::parseResponse($item[0], $base);
$check('归一化 ' . $item[1], $got['code'] === 1 && $got['url'] === $item[1], (string) $got['url']);
}
echo PHP_EOL . '3. 配置文本解析' . PHP_EOL;
$pairs = Util::parsePairs("# 注释行\ntoken=abc123\nuid=1\n\nfolder=3", '=');
$check('key=value 解析', count($pairs) === 3 && $pairs['token'] === 'abc123' && $pairs['uid'] === '1', json_encode($pairs));
$headerPairs = Util::parsePairs("Referer: https://img.example.com/tinyimg/\nCookie: sid=abc", ':');
$check(
'Key: Value 中值含冒号',
$headerPairs['Referer'] === 'https://img.example.com/tinyimg/' && $headerPairs['Cookie'] === 'sid=abc',
json_encode($headerPairs)
);
$check(
'deriveReferer 去掉 functions 层',
Util::deriveReferer($base) === 'https://img.example.com/tinyimg/',
Util::deriveReferer($base)
);
$check(
'deriveReferer 通用 /api/upload',
Util::deriveReferer('https://x.example.com/api/upload') === 'https://x.example.com/api/'
);
echo PHP_EOL . '4. 连接自检地址(?ping=1)' . PHP_EOL;
$pingCases = [
['https://img.example.com/functions/upload.php', 'https://img.example.com/functions/upload.php?ping=1'],
['https://img.example.com/functions/upload.php?x=1', 'https://img.example.com/functions/upload.php?x=1&ping=1'],
['https://img.example.com/functions/upload.php#frag', 'https://img.example.com/functions/upload.php?ping=1'],
['', ''],
];
foreach ($pingCases as $i => $case) {
$got = Util::pingUrl($case[0]);
$check('pingUrl 用例 ' . ($i + 1), $got === $case[1], $got);
}
$check('pingUrl 输出是 http(s) 绝对地址',
(bool) preg_match('#^https://.+\?ping=1$#', Util::pingUrl('https://img.example.com/functions/upload.php')));
echo PHP_EOL . '5. 测试集有效性反证(故意错误的实现)' . PHP_EOL;
// 错误实现 A:只认 TinyImg 2.x 的 data.url,漏掉 1.x 的顶层 url
$badV2Only = function ($body) {
$data = json_decode($body, true);
return isset($data['data']['url']) ? $data['data']['url'] : null;
};
$check(
'错误实现 A 在 1.x 成功样例上必须取不到 URL',
$badV2Only($cases[0]['body']) === null
);
$check(
'正确实现在同一份样例上必须成功',
Util::parseResponse($cases[0]['body'], $base)['code'] === 1
);
// 错误实现 B:忽略 code=0,只要看到 url 就算成功
$badIgnoreCode = function ($body) {
$data = json_decode($body, true);
return isset($data['url']) ? $data['url'] : null;
};
$failureWithUrl = '{"code":0,"url":"https://img.example.com/c.jpg","msg":"非法请求"}';
$check(
'错误实现 B 会把失败响应误判为成功',
$badIgnoreCode($failureWithUrl) === 'https://img.example.com/c.jpg'
);
$check(
'正确实现必须把该响应判为失败',
Util::parseResponse($failureWithUrl, $base)['code'] === 0
);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);