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:
@@ -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);
|
||||
Reference in New Issue
Block a user