在撰写文章 / 页面的右侧栏增加图片上传窗口,选图后上传到自建 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
226 lines
9.1 KiB
PHP
226 lines
9.1 KiB
PHP
<?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'] === ''
|
||
);
|
||
|
||
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);
|
||
}
|