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

124 lines
6.3 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
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);