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

226 lines
9.1 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
/**
* 渲染冒烟测试:用最小 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);
}