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);