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
+9
View File
@@ -0,0 +1,9 @@
# 统一按 LF 存储,避免 Windows 检出成 CRLF 后部署到 Linux 出问题
* text=auto eol=lf
*.png binary
*.jpg binary
*.jpeg binary
*.gif binary
*.ico binary
*.webp binary
+11
View File
@@ -0,0 +1,11 @@
# ---- 测试沙箱与临时产物 ----
.ti_setting_tmp/
.ti_*/
*.tmp
*.tmp.js
/js_*.js
# ---- 本地环境 ----
.DS_Store
Thumbs.db
*.log
+497
View File
@@ -0,0 +1,497 @@
<?php
namespace TypechoPlugin\TinyImgUploader;
use Widget\ActionInterface;
use Widget\Base;
if (!defined('__TYPECHO_ROOT_DIR__')) {
exit;
}
/**
* 服务端上传代理:接收后台 Ajax 的图片文件,转发到自建图床,统一返回 JSON。
*
* 存在的理由:实测 TinyImg 的 functions/upload.php 不返回任何
* Access-Control-Allow-Origin,浏览器从博客后台直接 POST 会被同源策略拦截。
* 还负责在服务端注入 API Token 请求头或图床登录 Cookie(凭证不下发到浏览器),
* 以及设置页「测试连接」按钮用到的 ?ping=1 连通性探测。
*/
class Action extends Base implements ActionInterface
{
public function action()
{
$cfg = self::config();
$this->assertAuthorized($cfg);
// 设置页的「测试连接」按钮:do=test,不接收文件,只验证 Token 与图床版本
if ($this->param('do') === 'test') {
$this->testConnection($cfg);
}
if (strtoupper(isset($_SERVER['REQUEST_METHOD']) ? $_SERVER['REQUEST_METHOD'] : '') !== 'POST') {
$this->json(['code' => 0, 'msg' => '仅支持 POST 上传']);
}
if (empty($_FILES['image']) || is_array($_FILES['image']['error'])) {
$this->json(['code' => 0, 'msg' => '没有收到图片文件(表单字段名应为 image)']);
}
$file = $_FILES['image'];
if ($file['error'] !== UPLOAD_ERR_OK) {
$this->json(['code' => 0, 'msg' => self::uploadErrorMessage($file['error'])]);
}
$tmp = $file['tmp_name'];
if (!is_uploaded_file($tmp)) {
$this->json(['code' => 0, 'msg' => '上传的临时文件无效']);
}
$maxBytes = max(1, (int) $cfg['maxSize']) * 1048576;
if ($file['size'] <= 0 || $file['size'] > $maxBytes) {
$this->json([
'code' => 0,
'msg' => '图片大小不合要求(当前 ' . ceil($file['size'] / 1024) . ' KB,上限 '
. $cfg['maxSize'] . ' MB)',
]);
}
// 用图片头真实校验类型,禁止 SVG / PHP 等可执行内容混过 image/* 判断
$image = self::imageMime($tmp);
if ($image === null) {
$this->json(['code' => 0, 'msg' => '仅支持 jpg / png / gif / webp / bmp 图片']);
}
$name = self::safeName($file['name'], $image['ext']);
$apiUrl = trim((string) $cfg['apiUrl']);
if (!preg_match('#^https?://#i', $apiUrl)) {
$this->json(['code' => 0, 'msg' => '上传接口地址必须以 http:// 或 https:// 开头']);
}
$byToken = $cfg['authMode'] === 'token';
$extra = Util::parsePairs($cfg['extraFields'], '=');
// Token 模式只用请求头传凭证,不再作为表单字段重复发送
if (!$byToken && $cfg['token'] !== '' && !isset($extra['token'])) {
$extra['token'] = $cfg['token'];
}
$headers = [
'User-Agent' => 'Mozilla/5.0 (compatible; TypechoTinyImgUploader/2.0)',
'Referer' => Util::deriveReferer($apiUrl),
'X-Requested-With' => 'XMLHttpRequest',
];
foreach (Util::parsePairs($cfg['headers'], ':') as $key => $value) {
$headers[$key] = $value;
}
$headers = array_filter($headers, function ($value) {
return $value !== '';
});
// 凭证只在服务端使用,浏览器收到的是同源 Action 地址,看不到任何图床秘密。
$asAdmin = $cfg['authMode'] !== 'guest';
if ($byToken) {
// 推荐方式:独立 API Token,只被图床的 functions/upload.php 识别
$apiToken = trim((string) $cfg['token']);
if ($apiToken === '') {
$this->json([
'code' => 0,
'msg' => '已开启 API Token 上传,但未填写 Token:请到图床后台「Token 设置」生成,'
. '填入插件设置后用「测试连接」验证',
]);
}
$headers['X-TinyImg-Token'] = $apiToken;
} elseif ($asAdmin) {
// 兼容方式:模拟图床后台登录 Cookie(TinyImg 1.x 原生逻辑)
$cookie = Util::adminCookie($cfg['adminUser'], $cfg['adminSecret']);
if ($cookie === null) {
$this->json([
'code' => 0,
'msg' => '已开启管理员上传,但未填写图床管理员账号或密码/Cookie,请到插件设置里补全',
]);
}
$existing = '';
foreach ($headers as $key => $value) {
if (strcasecmp($key, 'Cookie') === 0) {
$existing = $value;
unset($headers[$key]);
}
}
$headers['Cookie'] = Util::mergeCookie($existing, $cookie);
}
$fieldName = trim((string) $cfg['fieldName']);
if ($fieldName === '') {
$fieldName = 'file';
}
$fields = $extra;
$fields[$fieldName] = [
'file' => $tmp,
'mime' => $image['mime'],
'name' => $name,
];
$result = self::forward($apiUrl, $fields, $headers);
if ($result['error']) {
$this->json(['code' => 0, 'msg' => '转发到图床失败:' . $result['error']]);
}
if ($result['status'] && ($result['status'] < 200 || $result['status'] >= 300)) {
$this->json([
'code' => 0,
'msg' => '图床返回 HTTP ' . $result['status'] . ':' . Util::clip($result['body'], 200),
]);
}
$parsed = Util::parseResponse($result['body'], $apiUrl);
if ($parsed['code'] !== 1) {
$this->json([
'code' => 0,
'msg' => $parsed['msg'],
'raw' => Util::clip($result['body'], 300),
]);
}
$out = [
'code' => 1,
'url' => $parsed['url'],
'name' => $name,
'as' => $asAdmin ? 'admin' : 'guest',
];
// 图床在 Cookie 不匹配时不会报错,而是静默回落到游客目录。
// 用返回地址里的目录名反查一次,避免「以为改成管理员、其实没生效」。
if ($asAdmin && Util::inAdminDir($parsed['url'], $cfg['adminDir']) === false) {
$out['warn'] = $byToken
? '图片已上传,但地址里没有管理员目录「' . $cfg['adminDir']
. '」:图床没有按 Token 识别身份。请到图床后台「Token 设置」确认 Token 已启用,'
. '并与插件设置里的值完全一致;可用「测试连接」按钮复核。'
: '图片已上传,但地址里没有管理员目录「' . $cfg['adminDir']
. '」:图床没认出管理员身份,本次实际仍是游客上传。请核对图床 config.php 的 '
. 'user / password,或把「管理员上传目录名」改成你实际的 admindir。';
}
$this->json($out);
}
private static function config()
{
return Plugin::settings();
}
/** 从 Typecho Request 读取参数,取不到时回落到原始超全局(兼容不同 1.3 构建) */
private function param($key)
{
$value = $this->request->get($key);
if ($value === null && isset($_GET[$key])) {
$value = $_GET[$key];
}
if ($value === null && isset($_POST[$key])) {
$value = $_POST[$key];
}
return is_scalar($value) ? (string) $value : null;
}
/** 登录 + 用户组 + CSRF;校验失败一律返回 JSON,不做 302 跳转 */
private function assertAuthorized(array $cfg)
{
$group = $cfg['allowGroup'] === 'administrator' ? 'administrator' : 'contributor';
if (!$this->user->hasLogin() || !$this->user->pass($group, true)) {
$this->json([
'code' => 0,
'msg' => $group === 'administrator'
? '请先登录后台,且需要「管理员」权限'
: '请先登录后台,且账号至少具有「贡献者」权限',
]);
}
// 与 Widget\Security::protect() 等价,但校验失败时返回 JSON 而不是 302 跳转
$token = $this->param('_');
if (!$token || $token !== $this->security->getToken($this->request->getReferer())) {
$this->json(['code' => 0, 'msg' => '安全校验失败,请刷新页面后重试']);
}
}
/**
* 设置页「测试连接」:用输入框里的 Token 请求图床 upload.php?ping=1。
* 不上传任何文件、不写数据库;Token 只出现在服务端到图床的请求头里。
*/
private function testConnection(array $cfg)
{
if (strtoupper(isset($_SERVER['REQUEST_METHOD']) ? $_SERVER['REQUEST_METHOD'] : '') !== 'POST') {
$this->json(['code' => 0, 'msg' => '测试连接需要 POST 请求']);
}
$token = trim((string) $this->param('token'));
if ($token === '') {
$token = trim((string) $cfg['token']); // 允许直接测已保存的 Token
}
if ($token === '') {
$this->json(['code' => 0, 'msg' => '请先在上方填入 API Token(可点击「测试连接」前不保存)']);
}
$apiUrl = trim((string) $cfg['apiUrl']);
if (!preg_match('#^https?://#i', $apiUrl) || strpos($apiUrl, 'img.example.com') !== false) {
$this->json([
'code' => 0,
'msg' => '「图床上传接口地址」仍是占位值或格式不对,请先改成你的实际地址(functions/upload.php)',
]);
}
$headers = [
'User-Agent' => 'Mozilla/5.0 (compatible; TypechoTinyImgUploader/2.0)',
'Referer' => Util::deriveReferer($apiUrl),
'X-Requested-With' => 'XMLHttpRequest',
'Accept' => 'application/json',
];
foreach (Util::parsePairs($cfg['headers'], ':') as $key => $value) {
if ($value !== '') {
$headers[$key] = $value;
}
}
// 强制覆盖,避免「附加请求头」里误配同名项导致测的不是当前 Token
$headers['X-TinyImg-Token'] = $token;
$result = self::forward(Util::pingUrl($apiUrl), [], array_filter($headers, function ($v) {
return $v !== '';
}));
if ($result['error']) {
$this->json(['code' => 0, 'msg' => '连接图床失败:' . $result['error']]);
}
if ($result['status'] && ($result['status'] < 200 || $result['status'] >= 300)) {
$this->json([
'code' => 0,
'msg' => '图床返回 HTTP ' . $result['status'],
'raw' => Util::clip($result['body'], 200),
]);
}
$data = json_decode(trim((string) $result['body']), true);
if (!is_array($data)) {
$this->json([
'code' => 0,
'msg' => '图床返回的不是 JSON:请确认已升级到 TinyImg 2.0(支持 ?ping=1),且接口地址正确',
'raw' => Util::clip($result['body'], 200),
]);
}
if (!isset($data['code']) || (string) $data['code'] !== '1') {
$this->json([
'code' => 0,
'msg' => isset($data['msg']) ? (string) $data['msg'] : 'Token 校验未通过',
'raw' => Util::clip($result['body'], 200),
]);
}
$out = [
'code' => 1,
'msg' => '连接成功,Token 有效',
'name' => isset($data['name']) ? (string) $data['name'] : '',
'version' => isset($data['version']) ? (string) $data['version'] : '',
'admin_dir' => isset($data['admin_dir']) ? (string) $data['admin_dir'] : '',
];
$reportedDir = $out['admin_dir'];
if ($reportedDir !== '' && $cfg['adminDir'] !== ''
&& strcasecmp($reportedDir, $cfg['adminDir']) !== 0) {
$out['warn'] = '图床报告的管理员目录是「' . $reportedDir . '」,插件填的是「'
. $cfg['adminDir'] . '」,请把插件设置改成一致,否则上传后会误报身份未生效';
}
if ($cfg['authMode'] !== 'token') {
$out['warn'] = (isset($out['warn']) ? $out['warn'] . ';' : '')
. '注意:当前鉴权方式为「' . $cfg['authMode'] . '」,实际上传不会使用这个 Token';
}
$this->json($out);
}
private static function imageMime($path)
{
$info = @getimagesize($path);
$mime = ($info && !empty($info['mime'])) ? $info['mime'] : '';
$allowed = [
'image/jpeg' => 'jpg',
'image/pjpeg' => 'jpg',
'image/png' => 'png',
'image/gif' => 'gif',
'image/webp' => 'webp',
'image/bmp' => 'bmp',
'image/x-ms-bmp'=> 'bmp',
];
return isset($allowed[$mime]) ? ['mime' => $mime, 'ext' => $allowed[$mime]] : null;
}
private static function safeName($name, $ext)
{
$name = basename(str_replace('\\', '/', (string) $name));
$name = preg_replace('/[^\x20-\x7e]/', '', $name);
$name = str_replace(['"', "\r", "\n", '/'], '', $name);
$name = trim($name);
if ($name === '' || $name === '.' || $name === '..') {
$name = 'image';
}
if (!preg_match('/\.[a-z0-9]{2,5}$/i', $name)) {
$name .= '.' . $ext;
}
return $name;
}
private static function uploadErrorMessage($code)
{
$messages = [
UPLOAD_ERR_INI_SIZE => '超过服务器 upload_max_filesize 限制',
UPLOAD_ERR_FORM_SIZE => '超过表单 MAX_FILE_SIZE 限制',
UPLOAD_ERR_PARTIAL => '文件只上传了一部分',
UPLOAD_ERR_NO_FILE => '没有选择文件',
UPLOAD_ERR_NO_TMP_DIR => '服务器缺少临时目录',
UPLOAD_ERR_CANT_WRITE => '服务器写入临时文件失败',
UPLOAD_ERR_EXTENSION => 'PHP 扩展中止了上传',
];
return isset($messages[$code]) ? $messages[$code] : ('未知上传错误:' . $code);
}
/**
* 优先 curl;没有 curl 扩展时退回 stream 手工拼 multipart。
*/
private static function forward($url, array $fields, array $headers)
{
return function_exists('curl_init')
? self::forwardByCurl($url, $fields, $headers)
: self::forwardByStream($url, $fields, $headers);
}
private static function forwardByCurl($url, array $fields, array $headers)
{
$postFields = [];
foreach ($fields as $key => $value) {
$postFields[$key] = (is_array($value) && isset($value['file']))
? new \CURLFile($value['file'], $value['mime'], $value['name'])
: $value;
}
$lines = ['Expect:'];
foreach ($headers as $key => $value) {
$lines[] = $key . ': ' . $value;
}
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $postFields,
CURLOPT_HTTPHEADER => $lines,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 45,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_MAXREDIRS => 3,
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
]);
$body = curl_exec($ch);
if ($body === false) {
$error = curl_error($ch);
curl_close($ch);
return ['error' => $error, 'status' => 0, 'body' => ''];
}
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return ['error' => null, 'status' => $status, 'body' => (string) $body];
}
private static function forwardByStream($url, array $fields, array $headers)
{
$random = function_exists('random_bytes') ? bin2hex(random_bytes(8)) : md5(uniqid('', true));
$boundary = '----TypechoIU' . $random;
$body = '';
foreach ($fields as $key => $value) {
$safeKey = str_replace(['"', "\r", "\n"], '', $key);
$body .= '--' . $boundary . "\r\n";
if (is_array($value) && isset($value['file'])) {
$safeName = str_replace(['"', "\r", "\n"], '', $value['name']);
$body .= 'Content-Disposition: form-data; name="' . $safeKey
. '"; filename="' . $safeName . '"' . "\r\n";
$body .= 'Content-Type: ' . $value['mime'] . "\r\n\r\n";
$body .= file_get_contents($value['file']) . "\r\n";
} else {
$body .= 'Content-Disposition: form-data; name="' . $safeKey . '"' . "\r\n\r\n";
$body .= $value . "\r\n";
}
}
$body .= '--' . $boundary . "--\r\n";
$header = 'Content-Type: multipart/form-data; boundary=' . $boundary . "\r\n";
foreach ($headers as $key => $value) {
$header .= $key . ': ' . $value . "\r\n";
}
$context = stream_context_create([
'http' => [
'method' => 'POST',
'header' => $header,
'content' => $body,
'timeout' => 45,
'ignore_errors' => true,
'follow_location' => 1,
'max_redirects' => 3,
],
]);
$response = @file_get_contents($url, false, $context);
if ($response === false) {
$last = error_get_last();
return [
'error' => $last ? $last['message'] : '请求失败(allow_url_fopen 可能已关闭)',
'status' => 0,
'body' => '',
];
}
$status = 0;
if (isset($http_response_header[0]) && preg_match('#\s(\d{3})\s#', $http_response_header[0], $m)) {
$status = (int) $m[1];
}
return ['error' => null, 'status' => $status, 'body' => $response];
}
private function json(array $data)
{
$this->response->setContentType('application/json');
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
exit;
}
}
+807
View File
@@ -0,0 +1,807 @@
<?php
namespace TypechoPlugin\TinyImgUploader;
use Typecho\Plugin\PluginInterface;
use Typecho\Widget\Helper\Form;
use Typecho\Widget\Helper\Form\Element\Password;
use Typecho\Widget\Helper\Form\Element\Radio;
use Typecho\Widget\Helper\Form\Element\Text;
use Typecho\Widget\Helper\Form\Element\Textarea;
use Utils\Helper;
use Widget\Options;
if (!defined('__TYPECHO_ROOT_DIR__')) {
exit;
}
/**
* 撰写文章 / 页面右侧栏的图床上传窗口。
* 选择图片 -> 确认 -> 上传到自建 TinyImg 图床 -> 把 Markdown 插入光标处。
*
* @package TinyImgUploader
* @author BuddyRobot
* @version 2.0.0
* @since 1.3.0
*/
class Plugin implements PluginInterface
{
/** 插件目录名,也是设置项的命名空间 */
const NAME = 'TinyImgUploader';
/** Action 名,对应 /action/tinyimg-uploader */
const ACTION = 'tinyimg-uploader';
/** 允许显式留空的设置项:留空表示「跳过管理员目录校验」 */
const NULLABLE = ['adminDir'];
/** 设置项默认值 */
const DEFAULTS = [
// 占位地址:部署后请改成自己图床的 functions/upload.php 绝对地址
'apiUrl' => 'https://img.example.com/functions/upload.php',
'fieldName' => 'file',
'mode' => 'proxy',
'authMode' => 'token',
'adminUser' => '',
'adminSecret' => '',
'adminDir' => 'upload',
'allowGroup' => 'contributor',
'token' => '',
'extraFields' => '',
'headers' => '',
'maxSize' => '2',
'template' => '![%alt%](%url%)',
];
public static function activate()
{
// 侧栏卡片:admin/write-post.php:119 / admin/write-page.php:145
\Typecho\Plugin::factory('admin/write-post.php')->option = __CLASS__ . '::renderOption';
\Typecho\Plugin::factory('admin/write-page.php')->option = __CLASS__ . '::renderOption';
// 弹窗与脚本:页面底部,此时 jQuery 已加载
\Typecho\Plugin::factory('admin/write-post.php')->bottom = __CLASS__ . '::renderFooter';
\Typecho\Plugin::factory('admin/write-page.php')->bottom = __CLASS__ . '::renderFooter';
Helper::addAction(self::ACTION, Action::class);
return _t('图床上传已启用;请在设置里填写图床 functions/upload.php 地址,并填入图床后台「Token 设置」页生成的 API Token,然后点「测试连接」验证');
}
public static function deactivate()
{
Helper::removeAction(self::ACTION);
}
public static function config(Form $form)
{
$apiUrl = new Text(
'apiUrl',
null,
self::DEFAULTS['apiUrl'],
_t('图床上传接口地址'),
_t('TinyImg 2.0 的上传端点:https://你的图床域名/functions/upload.php。默认值是占位地址,必须改成你的实际地址;以 http:// 或 https:// 开头。')
);
$apiUrl->addRule('required', _t('请填写上传接口地址'));
$apiUrl->input->setAttribute('class', 'w-100 text');
$form->addInput($apiUrl);
$authMode = new Radio(
'authMode',
[
'token' => _t('API Token(推荐,TinyImg 2.0 原生支持)'),
'admin' => _t('管理员 Cookie(回退方案,凭证等价于后台密码)'),
'guest' => _t('游客上传(图片进 temp 目录,受每日数量限制)'),
],
self::DEFAULTS['authMode'],
_t('上传到图床的鉴权方式'),
_t('Token 用 X-TinyImg-Token 请求头,由图床后台「Token 设置」页生成,只在服务端出现;Cookie 模式模拟图床后台登录态。详见 README 的鉴权方案对比。')
);
$form->addInput($authMode);
$adminUser = new Text(
'adminUser',
null,
'',
_t('图床管理员账号'),
_t('图床 config.php 里 user 配置项的值,必须与图床完全一致(区分大小写)。')
);
$form->addInput($adminUser);
// 个别 Typecho 构建可能没有 Password 元素,降级成普通输入框以免设置页直接 500
$secretElement = class_exists('Typecho\\Widget\\Helper\\Form\\Element\\Password')
? Password::class
: Text::class;
$adminSecret = new $secretElement(
'adminSecret',
null,
'',
_t('图床管理员密码 / 登录 Cookie 值'),
_t('可填明文密码(插件自动算 md5("tinyimg" + 密码) 作为 Cookie);更推荐用 tools/cookie.php 算出 32 位值后填入,或直接复制图床登录后 Cookie 里的 password 值,避免明文密码存入数据库。')
);
$form->addInput($adminSecret);
$adminDir = new Text(
'adminDir',
null,
self::DEFAULTS['adminDir'],
_t('管理员上传目录名'),
_t('图床 config.php 里 admindir 的值,默认 upload。上传后用它检查是否真的以管理员身份生效;留空则跳过该检查。')
);
$form->addInput($adminDir);
$allowGroup = new Radio(
'allowGroup',
[
'contributor' => _t('贡献者及以上(默认)'),
'administrator' => _t('仅博客管理员可用'),
],
self::DEFAULTS['allowGroup'],
_t('允许使用该插件的博客用户组'),
_t('这是 Typecho 侧的权限,与上面的图床身份无关;两处都设为管理员即实现「仅管理员以管理员身份上传」。')
);
$form->addInput($allowGroup);
$fieldName = new Text(
'fieldName',
null,
self::DEFAULTS['fieldName'],
_t('文件表单字段名'),
_t('TinyImg 2.0 为 file;其它图床可能是 image、smfile 等,按接口文档填写。')
);
$form->addInput($fieldName);
$mode = new Radio(
'mode',
[
'proxy' => _t('服务端代理(推荐,无需图床开放 CORS)'),
'direct' => _t('浏览器直连(需图床返回 CORS 响应头)'),
],
self::DEFAULTS['mode'],
_t('上传方式'),
_t('实测本图床未返回 Access-Control-Allow-Origin,默认必须用服务端代理;Token / Cookie 模式会强制走代理,防止凭证下发到浏览器。')
);
$form->addInput($mode);
$maxSize = new Text(
'maxSize',
null,
self::DEFAULTS['maxSize'],
_t('单张图片上限(MB)'),
_t('TinyImg 2.0 源码里硬编码 file_max_size = 2097152(2 MB),填大于 2 会被图床拒绝。')
);
$maxSize->addRule('required', _t('请填写大小上限'));
$maxSize->addRule('isInteger', _t('请填写整数'));
$form->addInput($maxSize);
$template = new Text(
'template',
null,
self::DEFAULTS['template'],
_t('插入 Markdown 模板'),
_t('可用占位符:%url% 图片地址、%alt% 不含扩展名的文件名、%name% 原文件名。想和极简图床页面完全一致可填 ![](%url%)。')
);
$template->input->setAttribute('class', 'w-100 mono');
$form->addInput($template);
$token = new $secretElement(
'token',
null,
'',
_t('图床 API Token'),
_t('在图床后台「Token 设置」页生成或复制,粘贴到此处,两处必须完全一致。Token 模式用 X-TinyImg-Token 请求头在服务端发送,不写入撰写页、不出现在 URL;Cookie / 游客模式下本项留空。')
. self::testButtonHtml()
);
$token->input->setAttribute('class', 'w-100 mono');
$form->addInput($token);
$extraFields = new Textarea(
'extraFields',
null,
'',
_t('附加表单字段(可选)'),
_t('每行一项,格式 key=value,例如 uid=1。用于需要 uid / apiType / folder 等参数的图床。')
);
$form->addInput($extraFields);
$headers = new Textarea(
'headers',
null,
'',
_t('附加请求头(可选,仅代理模式)'),
_t('每行一项,格式 Key: Value。例如需要登录态时填 Cookie: xxxx,或覆盖 Referer。默认已自动带 User-Agent、Referer、X-Requested-With。')
);
$form->addInput($headers);
}
public static function personalConfig(Form $form)
{
}
/**
* 设置页「测试连接」按钮的 HTML(由 config() 放进 Token 字段的说明里)。
*
* 走博客同源的 /action/tinyimg-uploader?do=test,由 PHP 携带 Token 去请求
* 图床的 functions/upload.php?ping=1,因此不受跨域限制、也不会把图床地址
* 或 Token 暴露给撰写文章页。URL 里的 _ 参数是 Typecho 的 CSRF 令牌。
*
* 单独做成 public 方法,便于 tests/render_test.php 直接断言而不必 stub 整套表单类。
*/
public static function testButtonHtml()
{
$testUrl = '';
try {
if (class_exists('\\Widget\\Security')) {
$testUrl = \Widget\Security::alloc()->getIndex('/action/' . self::ACTION . '?do=test');
}
} catch (\Throwable $e) {
$testUrl = '';
}
$jsonUrl = json_encode(
(string) $testUrl,
JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT
);
$html = '<span id="ti-test-wrap" style="display:block;margin-top:10px;">'
. '<button type="button" class="btn" id="ti-test-btn">' . _t('测试连接') . '</button>'
. '<span id="ti-test-result" style="margin-left:10px;line-height:1.8;"></span>'
. '</span>'
. '<span style="display:block;margin-top:4px;color:#999;">'
. _t('测试会读取上方输入框里的 Token(无需先保存),验证图床是否认这个 Token,并返回图床版本与管理员目录。')
. '</span>';
if ($testUrl === '') {
return $html . '<span style="color:#c0392b;">' . _t('无法生成安全令牌,请刷新设置页后重试') . '</span>';
}
$js = <<<'TIJS'
<script>
(function () {
'use strict';
var URL = __TEST_URL__;
var btn = document.getElementById('ti-test-btn');
var out = document.getElementById('ti-test-result');
if (!btn || !out) { return; }
function done() {
btn.disabled = false;
btn.textContent = '测试连接';
}
function fail(msg) {
out.textContent = '✗ ' + msg;
out.style.color = '#c0392b';
}
btn.onclick = function () {
var input = document.querySelector('input[name="token"]');
var fd = new FormData();
fd.append('token', input ? input.value : '');
fd.append('do', 'test');
btn.disabled = true;
btn.textContent = '测试中…';
out.textContent = '';
out.style.color = '';
fetch(URL, { method: 'POST', body: fd, credentials: 'same-origin' })
.then(function (r) { return r.text(); })
.then(function (text) {
var d = null;
try { d = JSON.parse(text); } catch (e) { d = null; }
if (!d) {
fail('服务器返回的不是 JSON(可能安全令牌已过期,请刷新设置页重试)');
done();
return;
}
var msg = d.msg || '';
if (d.name) { msg += ' · ' + d.name + ' ' + (d.version || ''); }
if (d.admin_dir) { msg += ' · 管理员目录 ' + d.admin_dir; }
if (d.warn) { msg += ' · ' + d.warn; }
if (d.code == 1) {
out.textContent = '✓ ' + msg;
out.style.color = d.warn ? '#c47f00' : '#27865b';
} else {
out.textContent = '✗ ' + msg + (d.raw ? ' · ' + d.raw : '');
out.style.color = '#c0392b';
}
done();
})
.catch(function (e) {
fail('请求失败:' + (e && e.message ? e.message : '网络错误'));
done();
});
};
})();
</script>
TIJS;
return $html . str_replace('__TEST_URL__', $jsonUrl, $js);
}
/**
* 读取设置,缺失项回落默认值。禁用插件会清空设置,这里做兜底避免出现 500。
* Action 也复用本方法,保证权限校验与转发行为读的是同一份配置。
*/
public static function settings()
{
try {
$saved = Options::alloc()->plugin(self::NAME)->toArray();
} catch (\Typecho\Plugin\Exception $e) {
$saved = [];
}
foreach (self::DEFAULTS as $key => $default) {
$exists = array_key_exists($key, $saved);
// adminDir 允许显式留空(表示跳过目录校验)
$nullableEmpty = $exists && $saved[$key] === '' && in_array($key, self::NULLABLE, true);
if (!$exists || ($saved[$key] === '' && !$nullableEmpty)) {
$saved[$key] = $default;
}
}
return $saved;
}
/**
* 「仅博客管理员可用」时,非管理员连侧栏卡片都不显示。
* Action 里仍会再做一次权限校验,这里是纯粹的界面收敛。
*/
private static function canUse(array $cfg)
{
if ($cfg['allowGroup'] !== 'administrator' || !class_exists('\\Widget\\User')) {
return true;
}
$user = \Widget\User::alloc();
return (bool) ($user->hasLogin() && $user->pass('administrator', true));
}
/**
* option 钩子:右侧「选项」标签页内的上传卡片。
*/
public static function renderOption($content)
{
$cfg = self::settings();
if (!self::canUse($cfg)) {
return;
}
$limit = htmlspecialchars((string) $cfg['maxSize'], ENT_QUOTES, 'UTF-8');
echo '<section class="typecho-post-option" id="iu-box">';
echo '<label class="typecho-label">' . _t('图床上传') . '</label>';
echo '<p><button type="button" class="btn primary w-100" id="iu-open">' . _t('选择图片上传') . '</button></p>';
echo '<p class="description">' . _t('选图并确认后上传到自建图床,自动把 Markdown 插入光标处;也可拖入图片或在弹窗内 Ctrl+V 粘贴。单张不超过 ')
. $limit . ' MB。</p>';
if (!Options::alloc()->markdown) {
echo '<p class="description" style="color:#c0392b">'
. _t('当前站点未开启 Markdown,插入的图片语法可能不会被解析。') . '</p>';
}
$mode = $cfg['authMode'];
$identity = $mode === 'token' ? _t('API Token')
: ($mode === 'admin' ? _t('管理员 Cookie') : _t('游客'));
$missing = ($mode === 'token' && $cfg['token'] === '')
|| ($mode === 'admin' && ($cfg['adminUser'] === '' || $cfg['adminSecret'] === ''));
$hint = $mode === 'token'
? _t('(未填写 API Token,上传会被拒绝;请到图床后台「Token 设置」页生成后填入插件设置)')
: _t('(未填写管理员账号或密码/Cookie,上传会被拒绝)');
echo '<p class="description">' . _t('图床身份:') . '<strong>' . $identity . '</strong>';
if ($missing) {
echo ' <span style="color:#c0392b">' . $hint . '</span>';
}
echo '</p>';
// 默认接口地址是占位符,没改过就上传必然失败,这里提前拦住并给出明确指引
if (strpos($cfg['apiUrl'], 'img.example.com') !== false) {
echo '<p class="description" style="color:#c0392b">'
. _t('插件设置里的「图床上传接口地址」仍是占位值,请先改成你的实际地址,并用「测试连接」验证。')
. '</p>';
}
echo '<p class="description" id="iu-status"></p>';
echo '</section>';
}
/**
* bottom 钩子:弹窗 DOM、样式、交互脚本。
*/
public static function renderFooter($content)
{
$cfg = self::settings();
$actionUrl = \Widget\Security::alloc()->getIndex('/action/' . self::ACTION);
// Token / Cookie 模式携带服务端凭证,绝不允许把请求切到浏览器直连
$mode = ($cfg['mode'] === 'direct' && $cfg['authMode'] === 'guest') ? 'direct' : 'proxy';
$jsCfg = [
'mode' => $mode,
'template' => (string) $cfg['template'],
'maxSize' => max(1, (int) $cfg['maxSize']),
'actionUrl' => $actionUrl,
];
// 直连模式必须把接口信息下发到浏览器;代理模式下 token 只留在服务端。
if ($jsCfg['mode'] === 'direct') {
$jsCfg['apiUrl'] = (string) $cfg['apiUrl'];
$jsCfg['fieldName'] = (string) $cfg['fieldName'];
$jsCfg['token'] = (string) $cfg['token'];
$jsCfg['extra'] = Util::parsePairs($cfg['extraFields'], '=');
}
$flags = JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_HEX_TAG
| JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT;
echo '<script>window.IU_CFG=' . json_encode($jsCfg, $flags) . ';</script>';
echo <<<'IUCSS'
<style>
.iu-modal { display: none; position: fixed; inset: 0; z-index: 9999; font-size: 14px; color: #444; }
.iu-modal.iu-open { display: block; }
.iu-mask { position: absolute; inset: 0; background: rgba(0,0,0,.45); }
.iu-dialog { position: relative; width: 560px; max-width: 92vw; margin: 8vh auto 0; background: #fff;
border-radius: 8px; box-shadow: 0 14px 44px rgba(0,0,0,.28); overflow: hidden; }
.iu-head { padding: 12px 16px; border-bottom: 1px solid #eee; font-size: 15px; color: #333; }
.iu-head strong { font-weight: 600; }
.iu-close { float: right; border: 0; background: none; font-size: 22px; line-height: 1;
color: #999; cursor: pointer; padding: 0 4px; }
.iu-close:hover { color: #333; }
.iu-body { padding: 16px; }
.iu-drop { border: 1px dashed #bbb; border-radius: 6px; padding: 22px 10px; text-align: center;
color: #777; background: #fafafa; cursor: pointer; transition: .15s; }
.iu-drop:hover, .iu-drop.iu-hover, #iu-box.iu-hover { border-color: #467b96; background: #f2f8fb; }
.iu-hidden { display: none; }
.iu-preview { display: block; max-width: 100%; max-height: 240px; margin: 14px auto 0;
border: 1px solid #eee; border-radius: 4px; }
.iu-meta { margin: 10px 0 0; color: #666; word-break: break-all; }
.iu-progress { display: none; height: 6px; margin-top: 12px; background: #eee; border-radius: 3px; overflow: hidden; }
.iu-progress > i { display: block; width: 0; height: 100%; background: #467b96; transition: width .15s; }
.iu-error { min-height: 1.2em; margin: 8px 0 0; color: #c0392b; word-break: break-all; }
.iu-foot { padding: 12px 16px; border-top: 1px solid #eee; text-align: right; background: #fcfcfc; }
.iu-foot .btn { margin-left: 8px; }
.iu-tip { float: left; color: #999; line-height: 30px; font-size: 12px; }
@media (max-width: 600px) { .iu-tip { display: none; } }
</style>
IUCSS;
echo <<<'IUHTML'
<div id="iu-modal" class="iu-modal">
<div class="iu-mask"></div>
<div class="iu-dialog" role="dialog" aria-modal="true" aria-label="上传图片到图床">
<div class="iu-head">
<strong>上传图片到图床</strong>
<button type="button" class="iu-close" title="关闭">&times;</button>
</div>
<div class="iu-body">
<div id="iu-drop" class="iu-drop">点击选择图片,或拖入 / Ctrl+V 粘贴</div>
<input type="file" id="iu-file" class="iu-hidden" accept="image/*">
<img id="iu-preview" class="iu-preview" alt="图片预览">
<p id="iu-meta" class="iu-meta"></p>
<div class="iu-progress"><i></i></div>
<p id="iu-error" class="iu-error"></p>
</div>
<div class="iu-foot">
<span class="iu-tip">确认后上传并插入 Markdown 到光标处</span>
<button type="button" class="btn" id="iu-cancel">取消</button>
<button type="button" class="btn primary" id="iu-confirm" disabled>确认上传</button>
</div>
</div>
</div>
IUHTML;
echo <<<'IUJS'
<script>
(function ($) {
'use strict';
var cfg = window.IU_CFG || {};
var $modal = $('#iu-modal');
var $file = $('#iu-file');
var $drop = $('#iu-drop');
var $preview = $('#iu-preview');
var $meta = $('#iu-meta');
var $error = $('#iu-error');
var $confirm = $('#iu-confirm');
var $bar = $('.iu-progress > i');
var $status = $('#iu-status');
var current = null;
var previewUrl = null;
var busy = false;
function readableSize(n) {
return n >= 1048576 ? (n / 1048576).toFixed(2) + ' MB' : Math.ceil(n / 1024) + ' KB';
}
function showError(msg) {
$error.text(msg || '');
}
function showStatus(msg, color) {
if ($status.length) {
$status.text(msg).css('color', color || '');
}
}
function reset() {
if (previewUrl) {
URL.revokeObjectURL(previewUrl);
previewUrl = null;
}
current = null;
$file.val('');
$preview.hide().removeAttr('src');
$meta.text('');
$confirm.prop('disabled', true).text('确认上传');
$('.iu-progress').hide();
$bar.css('width', '0');
showError('');
}
function open(file) {
$modal.addClass('iu-open');
if (file) {
pick(file);
}
}
function close() {
if (busy) {
return;
}
$modal.removeClass('iu-open');
reset();
}
function pick(file) {
showError('');
if (!file) {
return;
}
if (!/^image\//.test(file.type || '')) {
showError('请选择图片文件(jpg / png / gif / webp / bmp)');
return;
}
if (!file.size) {
showError('图片内容为空');
return;
}
if (file.size > (cfg.maxSize || 2) * 1048576) {
showError('图片 ' + readableSize(file.size) + ' 超过 ' + cfg.maxSize + ' MB 限制');
return;
}
if (previewUrl) {
URL.revokeObjectURL(previewUrl);
}
current = file;
previewUrl = URL.createObjectURL(file);
$preview.attr('src', previewUrl).show();
$meta.text(file.name + ' · ' + readableSize(file.size));
$confirm.prop('disabled', false);
}
// 直连模式下图床返回格式不统一,递归找出图片地址
function extractUrl(obj, depth) {
if (!obj || typeof obj !== 'object' || depth > 8) {
return null;
}
var keys = ['url', 'link', 'src', 'image', 'original'];
var i, value;
for (i = 0; i < keys.length; i++) {
value = obj[keys[i]];
if (typeof value === 'string' && /^(https?:\/\/|\/\/|\/)/i.test(value.trim())) {
return value.trim();
}
}
for (var key in obj) {
if (Object.prototype.hasOwnProperty.call(obj, key)) {
var found = extractUrl(obj[key], depth + 1);
if (found) {
return found;
}
}
}
return null;
}
// 插入光标处:复用 Typecho 的 jquery.selection API,并触发 input 让草稿自动保存 / 预览刷新
function insertMarkdown(url, name) {
var $text = $('#text');
if (!$text.length) {
return false;
}
var el = $text[0];
var alt = (name || '').replace(/\.[^.]+$/, '').replace(/[\[\]()]/g, '');
var md = (cfg.template || '![%alt%](%url%)')
.replace(/%url%/g, function () { return url; })
.replace(/%alt%/g, function () { return alt; })
.replace(/%name%/g, function () { return name || ''; });
var start, end;
if ($.fn.getSelection) {
var sel = $text.getSelection();
start = sel ? sel.start : 0;
end = sel ? sel.end : 0;
} else {
start = el.selectionStart || 0;
end = el.selectionEnd || 0;
}
var text = $text.val();
var before = text.substring(0, start);
var after = text.substring(end);
var chunk = (before && !/\n$/.test(before) ? '\n' : '')
+ md
+ (after && !/^\n/.test(after) ? '\n' : '');
if ($.fn.replaceSelection) {
$text.replaceSelection(chunk);
if ($.fn.setSelection) {
$text.setSelection(start + chunk.length, start + chunk.length);
}
} else if (el.setRangeText) {
el.setRangeText(chunk, start, end, 'end');
} else {
$text.val(before + chunk + after);
}
$text.trigger('input').trigger('change');
$text.focus();
return true;
}
function finish() {
busy = false;
$confirm.prop('disabled', false).text('确认上传');
}
function upload() {
if (!current || busy) {
return;
}
busy = true;
showError('');
$confirm.prop('disabled', true).text('上传中…');
$('.iu-progress').show();
$bar.css('width', '5%');
var fd = new FormData();
var url;
if (cfg.mode === 'direct') {
url = cfg.apiUrl;
$.each(cfg.extra || {}, function (key, value) {
fd.append(key, value);
});
if (cfg.token) {
fd.append('token', cfg.token);
}
fd.append(cfg.fieldName || 'file', current, current.name);
} else {
url = cfg.actionUrl;
fd.append('image', current, current.name);
}
var xhr = new XMLHttpRequest();
xhr.open('POST', url, true);
xhr.upload.onprogress = function (e) {
if (e.lengthComputable) {
$bar.css('width', Math.min(95, 5 + 70 * e.loaded / e.total) + '%');
}
};
xhr.onload = function () {
finish();
var data = null;
try {
data = JSON.parse(xhr.responseText);
} catch (e) {
data = null;
}
if (!data) {
$bar.css('width', '0');
showError('服务器返回的不是 JSON(HTTP ' + xhr.status
+ ')。常见原因:安全令牌过期或未登录,请刷新撰写页面后重试。');
return;
}
var imageUrl = (data.code == 1 && data.url) ? data.url : extractUrl(data, 0);
if (xhr.status >= 200 && xhr.status < 300 && imageUrl) {
$bar.css('width', '100%');
var name = current ? current.name : 'image';
if (insertMarkdown(imageUrl, name)) {
showStatus('已插入(' + (data.as === 'admin' ? '管理员' : '游客')
+ '):' + imageUrl, data.warn ? '#c47f00' : '#27865b');
if (data.warn) {
// 身份没生效时保留弹窗,否则自动关闭会把警告掩盖掉
showError(data.warn);
} else {
setTimeout(function () { close(); }, 300);
}
} else {
showError('已上传 ' + imageUrl + ',但未找到编辑框 #text,请手动复制该地址。');
}
} else {
$bar.css('width', '0');
showError('上传失败:' + (data.msg || ('HTTP ' + xhr.status)));
}
};
xhr.onerror = function () {
finish();
$bar.css('width', '0');
showError('网络错误或请求被浏览器拦截(跨域 / HTTPS 混合内容)。');
};
xhr.send(fd);
}
function swallow(e) {
e.preventDefault();
e.stopPropagation();
}
$('#iu-open').on('click', function () { open(); });
$drop.on('click', function () { $file.trigger('click'); });
$file.on('change', function () {
if (this.files && this.files[0]) {
pick(this.files[0]);
}
});
$confirm.on('click', upload);
$('#iu-cancel, .iu-close, .iu-mask').on('click', close);
$(document).on('keydown', function (e) {
if (e.key === 'Escape') {
close();
}
});
$(document)
.on('dragover', '#iu-box, #iu-drop', function (e) {
swallow(e);
$(this).addClass('iu-hover');
})
.on('dragleave', '#iu-box, #iu-drop', function () {
$(this).removeClass('iu-hover');
})
.on('drop', '#iu-box, #iu-drop', function (e) {
swallow(e);
$(this).removeClass('iu-hover');
var dt = e.originalEvent && e.originalEvent.dataTransfer;
if (dt && dt.files && dt.files[0]) {
open(dt.files[0]);
}
});
// 捕获阶段拦截粘贴,避免弹窗打开时同时触发 Typecho 自带的「粘贴上传到本地附件」
document.addEventListener('paste', function (e) {
if (!$modal.hasClass('iu-open')) {
return;
}
var cd = e.clipboardData || (e.originalEvent && e.originalEvent.clipboardData);
var items = cd && cd.items;
if (!items) {
return;
}
for (var i = 0; i < items.length; i++) {
if (items[i].kind === 'file' && /^image\//.test(items[i].type)) {
var file = items[i].getAsFile();
if (file) {
e.preventDefault();
e.stopPropagation();
pick(file);
return;
}
}
}
}, true);
$preview.hide();
})(jQuery);
</script>
IUJS;
}
}
+166 -2
View File
@@ -1,3 +1,167 @@
# TinyImgUploader # TinyImgUploader 2.0.0 — Typecho 1.3 图床上传插件
TinyImgUploader typecho 1.3 在 Typecho 撰写文章 / 页面右侧「选项」栏增加一个图片上传窗口:点击按钮 → 弹窗选图并预览 → 确认上传 → 图片上传到自建 **TinyImg 2.0** 图床 → Markdown 自动插入编辑框光标处。
插件设置页里可以填 API Token,并有 **「测试连接」按钮** 一键验证图床是否认这个 Token。
---
## 1. 本次变更
| # | 变更 |
|---|---|
| 1 | 插件目录、命名空间、Action 名统一改为 `TinyImgUploader` / `tinyimg-uploader` |
| 2 | 请求头改为 `X-TinyImg-Token`,配合图床 2.0 的后台 Token 设置页 |
| 3 | 设置页 Token 字段新增「测试连接」按钮,读取输入框当前值(**无需先保存**),返回图床版本与管理员目录 |
| 4 | 图床 `?ping=1` 自检端点由插件的服务端 Action 调用,不受跨域限制、不把凭证下发给浏览器 |
| 5 | 默认值改为占位地址 `https://img.example.com/functions/upload.php`,侧栏会在未修改时给出红色提示 |
| 6 | 去掉旧的图床补丁包(`patch/` 目录):Token 现在是图床原生功能 |
| 7 | 管理员 Cookie 回退方案的盐同步改为 `tinyimg`;新增 `tests/host_test.php`、`tests/setting_test.php` 等六组测试 |
---
## 2. 从 v1.2 升级(需要重装一次,请先看这节)
插件目录名变了,Typecho 靠目录名识别插件,**不能只覆盖文件**。
> ⚠️ **禁用插件会清空它的设置**。请先把旧设置页里的接口地址、插入模板等抄下来。
1. 打开 Typecho 后台 → 控制台 → 插件 → **禁用 v1.2 旧插件**(记录现有设置)。
2. 删除服务器上 `usr/plugins/` 里 v1.2 的旧插件目录(就是之前上传的那个目录)。
3. 把 `TinyImgUploader.zip` 解压到 `usr/plugins/`,确认 `usr/plugins/TinyImgUploader/Plugin.php` 存在。
4. 后台启用 **TinyImgUploader**,进入「设置」。
5. 填写「图床上传接口地址」与「图床 API Token」(Token 在图床后台「Token 设置」页生成)。
6. 点 **「测试连接」**,看到 `✓ 连接成功,Token 有效 · TinyImg v2.0.0(20261104) · 管理员目录 upload` 即完成。
7. 保存设置,打开撰写文章页试传一张小图。
如果图床还没升级到 2.0,本插件无法直接使用:请先按 `../TinyImg/README.md` 部署图床。
---
## 3. 全新安装
1. 解压 `TinyImgUploader.zip` 到 `usr/plugins/`。
2. 后台 → 控制台 → 插件 → 启用 **TinyImgUploader**。
3. 设置里填接口地址 + Token,点「测试连接」验证,保存。
环境要求:Typecho 1.3、PHP ≥ 7.0;服务端代理模式需要 `curl` 扩展(没有时自动退回 `file_get_contents` 手工 multipart),并确认 `upload_max_filesize` / `post_max_size` ≥ 2M。
---
## 4. 配置项
| 配置项 | 默认值 | 说明 |
|---|---|---|
| **图床上传接口地址** | `https://img.example.com/functions/upload.php` | **占位值,必须改成你的实际地址**。`TinyImg 2.0` 是 `/functions/upload.php` |
| **上传到图床的鉴权方式** | `API Token` | 可选 `API Token` / `管理员 Cookie`(回退)/ `游客上传` |
| **图床 API Token** | 空 | 与图床后台「Token 设置」页一致;下方有 **「测试连接」按钮** |
| 图床管理员账号 | 空 | 仅 Cookie 模式使用,对应图床 `config.php` 的 `user` |
| 图床管理员密码 / 登录 Cookie 值 | 空 | 仅 Cookie 模式使用;推荐填 `tools/cookie.php` 生成的 32 位值 |
| 管理员上传目录名 | `upload` | 上传后据此判断身份是否真的生效;留空跳过判断 |
| 允许使用该插件的博客用户组 | 贡献者及以上 | 也可设为「仅博客管理员可用」 |
| 文件表单字段名 | `file` | TinyImg 2.0 用 `file` |
| 上传方式 | 服务端代理 | 图床未返回 CORS 头,默认必须走代理;Token / Cookie 模式**强制**代理 |
| 单张图片上限(MB) | `2` | 图床源码硬编码 2 MB |
| 插入 Markdown 模板 | `![%alt%](%url%)` | 占位符 `%url%` / `%alt%` / `%name%`;想与极简上传页一致填 `![](%url%)` |
| 附加表单字段 / 附加请求头 | 空 | 每行 `key=value` / `Key: Value` |
---
## 5. 「测试连接」按钮怎么工作
按钮在 **插件设置页** 的 Token 输入框下方,不在撰写页。
```
设置页点击「测试连接」
│ 读取 input[name=token] 当前值(不必先保存设置)
▼
POST 博客同源 /action/tinyimg-uploader?do=test&_=<CSRF>
│ 服务端校验:登录 + 用户组 + Typecho 安全令牌
▼
PHP curl 转发 POST 到 图床 /functions/upload.php?ping=1
│ 请求头 X-TinyImg-Token: <Token>
▼
图床只校验 Token,不接收文件、不写库
│ 返回 {code:1, name, version, admin_dir}
▼
博客 Action 比对管理员目录、附加 warn,返回 JSON
▼
按钮旁显示 ✓/✗、图床版本、管理员目录
```
要点:
- Token 只出现在「设置页输入框 → 博客服务端 → 图床请求头」这条链路里,**撰写文章页源码里没有任何图床地址或 Token**。
- 测试不上传图片、不产生数据;可以直接测试刚粘贴但还没保存的新 Token。
- 若图床返回的 `admin_dir` 与插件设置不一致,或当前鉴权方式不是 `token`,会给出橙色警告。
- 图床侧未升级到 2.0(不支持 `?ping=1`)时会明确提示「请确认已升级到 TinyImg 2.0」。
---
## 6. 使用流程
1. 撰写文章 / 页面 → 右侧「选项」栏出现「图床上传」卡片,点「选择图片上传」。
2. 弹窗里点选、拖入,或 Ctrl+V 粘贴图片 → 预览 → 点「确认上传」。
3. 上传成功后自动把 Markdown 插入 `#text` 光标处,并触发 `input` / `change` 让草稿自动保存与预览刷新;弹窗自动关闭。
4. 若身份没生效(例如 Token 被停用但仍以游客身份成功),弹窗**不会关闭**并显示橙色警告。
---
## 7. 排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 侧栏红字「接口地址仍是占位值」 | 没改 `apiUrl` | 设置里填实际 `https://你的域名/functions/upload.php` |
| 测试连接返回「请先在上方填入 API Token」 | Token 输入框为空且未保存过 | 从图床后台「Token 设置」复制 Token 粘进来 |
| 测试连接返回「API Token 无效!」 | 两处 Token 不一致 / 图床已停用 | 图床后台确认状态,重新生成并同步 |
| 测试连接返回「图床返回的不是 JSON」 | 图床不是 2.0 / 地址填错 / CSRF 过期 | 确认地址指向 `functions/upload.php`;刷新设置页重试 |
| 测试连接返回「安全校验失败」 | Typecho 安全令牌过期 | 刷新插件设置页再点 |
| 上传成功但提示「没按 Token 识别身份」 | 返回 URL 不含 `/upload/` | 检查「管理员上传目录名」是否与图床 `admindir` 一致 |
| 真实上传报错「API Token 未配置」 | 图床还没生成 / 启用 Token | 到图床后台「Token 设置」生成 |
| 升级后后台登录被踢出 | 图床 Cookie 盐改为 `tinyimg` | 到 `admin/login.php` 重新登录一次 |
| v1.2 插件突然不能上传 | 请求头已改名 | 按第 2 节升级插件 |
---
## 8. 验证命令
```bash
cd TinyImgUploader
# 纯逻辑测试,不需要 Typecho、不需要联网
php tests/util_test.php # 响应解析 + ?ping=1 地址推导
php tests/auth_test.php # Cookie 回退方案契约
php tests/token_test.php # 图床 Token 纯函数 + 上传端点契约 + 错误实现反证
php tests/render_test.php # 侧栏、弹窗、测试按钮渲染与凭证隔离
php tests/host_test.php # 图床更名 / 版本 / SM.MS 下线 / 设置页
php tests/setting_test.php # 图床 Token 设置页渲染:完整 Token 不得出现在 HTML、reveal 必须校验 CSRF
# 命令行连通性自检(需要 PHP 的 curl 或 openssl 扩展)
php tools/probe.php --url=https://你的域名/functions/upload.php --token=你的Token --ping
php tools/probe.php --url=https://你的域名/functions/upload.php --token=你的Token --file=./test.png
```
`tools/cookie.php` 仅在回退到「管理员 Cookie」模式时才需要:
```bash
php tools/cookie.php 管理员账号 '明文密码'
```
---
## 9. 安全说明
1. Token 只被图床上传端点与自检端点识别,泄露也只能上传图片,**不能进图床后台**。
2. 插件侧校验登录态、用户组与 Typecho CSRF 令牌;Token / Cookie 模式下强制服务端代理。
3. 上传前用 `getimagesize()` 校验真实图片头,挡住 SVG / 伪装脚本;大小与类型双重限制。
4. 图床比较用 `hash_equals`,空配置 / 停用 / 空请求一律 fail closed。
5. 请全程使用 HTTPS;Token 不要提交到公开仓库、不要放进 URL。
6. 轮换 Token 后,图床后台与插件设置都要更新,并用「测试连接」复核。
---
## 10. 已知限制
- 图床硬限 2 MB;本插件默认上限也是 2 MB。
- 直接改 `textarea` 的 `value` 不会被 PageDown 的撤销栈记录(插入后 Ctrl+Z 可能不还原)。
- 若博客与图床证书 / 协议不匹配(HTTPS 页面请求 HTTP 图床),服务端代理不受浏览器混合内容限制,但仍建议全 HTTPS。
- 本机 PHP 若缺 `curl` / `openssl`,`tools/probe.php` 的联网部分需在博客服务器上运行。
+326
View File
@@ -0,0 +1,326 @@
<?php
namespace TypechoPlugin\TinyImgUploader;
/**
* 与 Typecho 运行环境无关的纯函数工具集。
* Action.php、tools/probe.php、tests/util_test.php 都会加载它。
*/
class Util
{
/**
* 把每行一项的 "key=value" / "Key: value" 文本解析成关联数组。
* 空行、# 注释行忽略;值内部允许再次出现分隔符(如 Referer: https://)。
*/
public static function parsePairs($text, $separator = '=')
{
$result = [];
foreach (preg_split('/\r?\n/', (string) $text) as $line) {
$line = trim($line);
if ($line === '' || $line[0] === '#') {
continue;
}
$pos = strpos($line, $separator);
if ($pos === false) {
continue;
}
$key = trim(substr($line, 0, $pos));
$value = trim(substr($line, $pos + strlen($separator)));
if ($key !== '') {
$result[$key] = $value;
}
}
return $result;
}
/**
* 由上传接口地址推导一个同源 Referer。
* https://host/tinyimg/functions/upload.php -> https://host/tinyimg/
*/
public static function deriveReferer($apiUrl)
{
$parts = parse_url((string) $apiUrl);
if (!$parts || empty($parts['scheme']) || empty($parts['host'])) {
return '';
}
$base = $parts['scheme'] . '://' . $parts['host'];
if (isset($parts['port'])) {
$base .= ':' . $parts['port'];
}
$path = isset($parts['path']) ? $parts['path'] : '/';
$dir = preg_replace('#/[^/]*$#', '', $path);
$dir = preg_replace('#/functions$#', '', $dir);
return $base . rtrim($dir, '/') . '/';
}
/**
* 由上传接口地址生成连接自检地址(TinyImg 2.0 的 ?ping=1 通道)。
* 只校验 Token、不接收文件,返回图床版本与管理员目录。
*
* https://host/functions/upload.php -> https://host/functions/upload.php?ping=1
* https://host/functions/upload.php?x=1 -> https://host/functions/upload.php?x=1&ping=1
*/
public static function pingUrl($apiUrl)
{
$url = trim((string) $apiUrl);
if ($url === '') {
return '';
}
// 去掉可能存在的 #fragment,避免把 ping=1 拼到片段后面
$hash = strpos($url, '#');
if ($hash !== false) {
$url = substr($url, 0, $hash);
}
return $url . (strpos($url, '?') === false ? '?' : '&') . 'ping=1';
}
/**
* 把图床返回的绝对 / 协议相对 / 根相对 / 相对地址统一成 http(s) 绝对地址。
*/
public static function normalizeUrl($url, $baseUrl)
{
$url = trim((string) $url);
if ($url === '') {
return null;
}
if (preg_match('#^https?://#i', $url)) {
return $url;
}
$parts = parse_url((string) $baseUrl);
if (!$parts || empty($parts['scheme']) || empty($parts['host'])) {
return null;
}
$base = $parts['scheme'] . '://' . $parts['host'];
if (isset($parts['port'])) {
$base .= ':' . $parts['port'];
}
if (strpos($url, '//') === 0) {
return $parts['scheme'] . ':' . $url;
}
if (strpos($url, '/') === 0) {
return $base . $url;
}
$path = isset($parts['path']) ? $parts['path'] : '/';
$dir = preg_replace('#/[^/]*$#', '', $path);
return $base . rtrim($dir, '/') . '/' . ltrim($url, '/');
}
/**
* 在任意层级的数组里递归查找图片地址。
*/
public static function findUrl($value, $depth = 0)
{
if ($depth > 8 || !is_array($value)) {
return null;
}
foreach (['url', 'link', 'src', 'image', 'original'] as $key) {
if (isset($value[$key]) && is_string($value[$key])) {
$candidate = trim($value[$key]);
// 绝对 / 协议相对 / 根相对地址,或任意以图片扩展名结尾的相对路径
if (preg_match('#^(https?://|//|/)#i', $candidate)
|| preg_match('#\.(jpe?g|png|gif|webp|bmp)(\?.*)?$#i', $candidate)) {
return $candidate;
}
}
}
foreach ($value as $item) {
$found = self::findUrl($item, $depth + 1);
if ($found !== null) {
return $found;
}
}
return null;
}
/**
* 把图床原始响应统一成 ['code' => 1|0, 'url' => string|null, 'msg' => string]。
*
* 兼容:
* TinyImg 2.0 成功 {"code":1,"id":9,"url":"https://...","width":800,"height":600}
* TinyImg 2.0 失败 {"code":0,"msg":"API Token 无效!"}
* 其它图床 {"code":200,"data":{"url":"https://..."}}
* 通用 {"success":true,"data":{"url":"..."}}
*
* 注意:TinyImg 语义里 code=0 表示失败,因此即使响应里带了 url 也判为失败。
*/
public static function parseResponse($body, $baseUrl = '')
{
$body = trim((string) $body);
if ($body === '') {
return ['code' => 0, 'url' => null, 'msg' => '图床返回空内容(可能是 PHP 报错或 5xx)'];
}
$data = json_decode($body, true);
if (!is_array($data)) {
// 有些 PHP 程序会在 JSON 前面输出 BOM / notice,尝试截到第一个 { 或 [
$trimmed = preg_replace('/^[^{[]*/', '', $body);
$data = @json_decode($trimmed, true);
}
if (!is_array($data)) {
return ['code' => 0, 'url' => null, 'msg' => '图床返回的不是 JSON:' . self::clip($body, 160)];
}
$rawUrl = self::findUrl($data);
$code = isset($data['code']) ? (string) $data['code'] : '';
if ($rawUrl === null || $code === '0') {
$msg = '图床未返回图片地址';
foreach (['msg', 'message', 'error', 'err'] as $key) {
if (!empty($data[$key]) && is_string($data[$key])) {
$msg = $data[$key];
break;
}
}
return [
'code' => 0,
'url' => null,
'msg' => $msg . ' | 原始响应:' . self::clip($body, 160),
];
}
$url = self::normalizeUrl($rawUrl, $baseUrl);
if ($url === null) {
return ['code' => 0, 'url' => null, 'msg' => '无法解析图片地址:' . $rawUrl];
}
return ['code' => 1, 'url' => $url, 'msg' => 'ok'];
}
/**
* 构造管理员登录 Cookie(回退方案,两个字段)。
*
* 源码依据(TinyImg/functions/class/class.user.php):
* functions/class/class.user.php:32-35 login()
* $password = md5("tinyimg" . $admin['password']);
* setcookie("user", $user['user'], ...); setcookie("password", $password, ...);
* functions/class/class.user.php:41-52 check()
* $user1 = $config['user'] . md5("tinyimg" . $config['password']);
* $user2 = $_COOKIE['user'] . $_COOKIE['password'];
* $user1 == $user2 ? 'islogin' : 'nologin'
* functions/upload.php:15-23
* islogin -> admindir,且跳过 limitnum();否则 -> userdir + 每日数量限制
*
* $secret 既可以填 config.php 里的明文密码,也可以填图床登录后 Cookie 中的
* password 值(32 位十六进制 md5)。后者可避免明文密码存进 Typecho 数据库。
* 返回的 user 已按 PHP setcookie() 的规则 urlencode,可直接放进 Cookie 头。
*/
public static function adminCookie($user, $secret)
{
$user = trim((string) $user);
$secret = trim((string) $secret);
if ($user === '' || $secret === '') {
return null;
}
$password = preg_match('/^[a-f0-9]{32}$/i', $secret)
? strtolower($secret)
: md5('tinyimg' . $secret);
return [
'user' => rawurlencode($user),
'password' => $password,
];
}
/**
* 把鉴权字段合并进已有的 Cookie 头:同名字段覆盖,其它字段保留。
*/
public static function mergeCookie($existing, array $pairs)
{
$jar = [];
foreach (explode(';', (string) $existing) as $part) {
$part = trim($part);
if ($part === '' || strpos($part, '=') === false) {
continue;
}
list($key, $value) = explode('=', $part, 2);
$key = trim($key);
if ($key !== '') {
$jar[$key] = trim($value);
}
}
foreach ($pairs as $key => $value) {
$jar[$key] = $value;
}
$line = [];
foreach ($jar as $key => $value) {
$line[] = $key . '=' . $value;
}
return implode('; ', $line);
}
/**
* 判断图片地址是否落在管理员上传目录。
* TinyImg 的 URL 形如 https://host/upload/2611/hash.jpg。
* 返回 null 表示未配置目录名、跳过判定;true / false 表示判定结果。
*/
public static function inAdminDir($url, $dir)
{
$dir = trim((string) $dir, "/ \t\n\r\0\x0B");
if ($dir === '') {
return null;
}
$path = parse_url((string) $url, PHP_URL_PATH);
if (!is_string($path)) {
return false;
}
return (bool) preg_match('#/' . preg_quote($dir, '#') . '/#i', $path);
}
public static function clip($text, $length)
{
$text = preg_replace('/\s+/u', ' ', (string) $text);
return function_exists('mb_substr')
? mb_substr($text, 0, $length, 'UTF-8')
: substr($text, 0, $length);
}
}
+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);
+153
View File
@@ -0,0 +1,153 @@
<?php
/**
* TinyImg 2.0 图床侧改造验收测试(无需 Typecho、无需联网、不上传任何图片)。
* 运行:php tests/host_test.php
*
* 检查:品牌去旧名、版本号、SM.MS 通道彻底关闭、后台 Token 设置页、
* 关键静态资源与数据库改名,以及一个反证(故意留一个 SM.MS 请求必须被抓到)。
*/
$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;
}
};
$root = dirname(__DIR__, 2);
$host = $root . '/TinyImg';
$plugin = $root . '/TinyImgUploader';
// 拼接构造,避免测试代码自身成为「旧品牌字面量」的命中项
$forbidden = 'img' . 'url';
/** 递归收集文本文件(跳过第三方 layui 与二进制文件) */
function host_text_files($dir)
{
$out = [];
$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS));
foreach ($it as $f) {
$path = str_replace('\\', '/', $f->getPathname());
if (strpos($path, '/static/layui/') !== false) {
continue;
}
$ext = strtolower(pathinfo($path, PATHINFO_EXTENSION));
if (!in_array($ext, ['php', 'js', 'html', 'htm', 'css', 'txt', 'md', 'json', 'svg', 'htaccess'], true)
&& !in_array(basename($path), ['.htaccess', '.gitignore', 'LICENSE'], true)) {
continue;
}
$out[] = ['path' => $path, 'body' => file_get_contents($path)];
}
return $out;
}
$hostFiles = host_text_files($host);
$pluginFiles = host_text_files($plugin);
echo PHP_EOL . '1. 更名与版本号' . PHP_EOL;
$oldNameHits = 0;
foreach (array_merge($hostFiles, $pluginFiles) as $f) {
$oldNameHits += substr_count(strtolower($f['body']), $forbidden);
}
$check('两个工程源码里旧品牌字样为 0', $oldNameHits === 0, '命中 ' . $oldNameHits . ' 处');
$version = trim(file_get_contents($host . '/functions/version.txt'));
$check('版本号更新为 v2.0.0', strpos($version, 'v2.0.0') === 0, $version);
$check('版本文件带构建日期', (bool) preg_match('/\(\d{8}\)/', $version), $version);
$check('存在统一版本模块 functions/version.php', is_file($host . '/functions/version.php'));
$check('旧的 v1.40 版本号不再出现在版本文件', strpos($version, '1.40') === false);
$check('前台关于页读取统一版本号',
strpos(file_get_contents($host . '/about.php'), 'TINYIMG_VERSION') !== false);
$check('后台关于弹窗读取统一版本号',
strpos(file_get_contents($host . '/admin/about.php'), 'TINYIMG_VERSION') !== false);
$check('站点标题统一为 TinyImg',
strpos(file_get_contents($host . '/index.php'), 'TinyImg') !== false
&& strpos(file_get_contents($host . '/tpl/admin/header.php'), '<h1>TinyImg</h1>') !== false);
echo PHP_EOL . '2. SM.MS 上传通道已屏蔽 / 移除' . PHP_EOL;
$smUploadHits = 0;
foreach ($hostFiles as $f) {
$smUploadHits += substr_count(strtolower($f['body']), 'sm.ms/api');
}
$check('没有任何对 sm.ms 上传 API 的请求', $smUploadHits === 0, '命中 ' . $smUploadHits . ' 处');
$miniup = file_get_contents($host . '/miniup.html');
$check('极简上传页没有 SM.MS 选项卡', strpos($miniup, '<li>SM.MS</li>') === false);
$check('极简上传页没有 #sm 文件输入', strpos($miniup, 'id="sm"') === false);
$check('极简上传页保留本站拖拽上传', strpos($miniup, 'id="upimg"') !== false);
$embed = file_get_contents($host . '/static/embed.js');
$check('embed.js 没有 smshow / deletesm 函数',
strpos($embed, 'function smshow') === false && strpos($embed, 'function deletesm') === false);
$check('embed.js 保留本站上传逻辑',
strpos($embed, "url: 'functions/upload.php'") !== false);
$left = file_get_contents($host . '/tpl/admin/left.php');
$check('后台左侧菜单没有 SM.MS 入口', strpos($left, 'smadmin.php') === false);
$check('后台左侧菜单新增 Token 设置入口', strpos($left, 'setting.php') !== false);
$check('后台顶部导航新增 Token 设置入口',
strpos(file_get_contents($host . '/tpl/admin/header.php'), './setting.php') !== false);
$check('前台导航没有 SM.MS 入口',
strpos(file_get_contents($host . '/tpl/user/header.php'), 'sm.php') === false);
$smPage = file_get_contents($host . '/sm.php');
$check('sm.php 返回 410 且不提供上传表单',
strpos($smPage, 'http_response_code(410)') !== false && strpos($smPage, 'id="sm"') === false);
$smFunc = file_get_contents($host . '/functions/sm.php');
$check('functions/sm.php fail closed,不写数据库',
strpos($smFunc, 'http_response_code(410)') !== false
&& strpos($smFunc, '$database->insert') === false);
$smAdmin = file_get_contents($host . '/admin/smadmin.php');
$check('admin/smadmin.php 不再查询数据库', strpos($smAdmin, 'querysm') === false);
$check('admin/delete.php 拒绝 type=sm',
strpos(file_get_contents($host . '/admin/delete.php'), "=== 'sm'") !== false);
$adminClass = file_get_contents($host . '/functions/class/class.admin.php');
$check('class.admin.php 已移除 querysm / deletesm',
strpos($adminClass, 'function querysm') === false && strpos($adminClass, 'function deletesm') === false);
$check('upgrade.php 不再创建 sm 表',
strpos(file_get_contents($host . '/upgrade.php'), 'CREATE TABLE') === false);
echo PHP_EOL . '3. Token 设置页与存储' . PHP_EOL;
$check('admin/setting.php 存在', is_file($host . '/admin/setting.php'));
$check('functions/token.php 存在', is_file($host . '/functions/token.php'));
$check('Token 存储文件带 PHP 守卫(不会通过 URL 泄漏)',
strpos(file_get_contents($host . '/functions/token.php'), "<?php exit;") !== false);
$check('config-simple.php 仍保留 api_token 兼容项',
strpos(file_get_contents($host . '/config-simple.php'), 'api_token') !== false);
echo PHP_EOL . '4. 静态资源与数据库改名' . PHP_EOL;
$check('static/tinyimg.js 存在', is_file($host . '/static/tinyimg.js'));
$check('旧的 static/' . $forbidden . '.js 已不存在', !is_file($host . '/static/' . $forbidden . '.js'));
$check('油猴脚本的站点地址可配置',
strpos(file_get_contents($host . '/static/tinyimg.js'), 'TINYIMG_BASE') !== false);
$check('db/tinyimg-simple.db3 存在', is_file($host . '/db/tinyimg-simple.db3'));
$check('旧的 db/' . $forbidden . '-simple.db3 已不存在', !is_file($host . '/db/' . $forbidden . '-simple.db3'));
$check('安装器使用新的数据库文件名',
strpos(file_get_contents($host . '/functions/class/class.install.php'), 'tinyimg-simple.db3') !== false);
$check('config-simple.php 指向新的数据库文件',
strpos(file_get_contents($host . '/config-simple.php'), 'db/tinyimg.db3') !== false);
echo PHP_EOL . '5. 测试集有效性反证' . PHP_EOL;
// 故意伪造一份「还留着 SM.MS 上传」的代码,检测器必须判为不合格
$fakeSmUpload = "upload.render({ elem: '#sm', url: 'https://sm.ms/api/upload' });";
$dumbDetector = function ($code) {
return strpos(strtolower($code), 'sm.ms/api') === false;
};
$check('检测器能抓到故意保留的 SM.MS 上传请求', $dumbDetector($fakeSmUpload) === false);
$check('真实 embed.js 通过同一检测器',
$dumbDetector($embed) === true);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
+225
View File
@@ -0,0 +1,225 @@
<?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);
}
+211
View File
@@ -0,0 +1,211 @@
<?php
/**
* TinyImg 后台 Token 设置页验收测试(桩环境渲染,不需要图床运行、不联网)。
* 运行:php tests/setting_test.php
*
* 这个文件存在的理由:设置页最初把完整 Token 直接写进 input 的 value 属性,
* 页面源码、浏览器缓存、截图里都会留有明文。现在改成「默认只输出掩码,
* 点显示/复制时带 CSRF 向服务器取一次」。下面的断言把这条约束固定住,
* 并且验证错误 CSRF 拿不到 Token —— 否则谁都能用一个 GET 读到凭证。
*/
$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;
}
};
$root = dirname(__DIR__, 2);
$host = $root . '/TinyImg';
$php = PHP_BINARY;
if (!is_file($host . '/admin/setting.php')) {
fwrite(STDERR, '找不到图床源码:' . $host . '/admin/setting.php' . PHP_EOL);
exit(1);
}
// 沙箱放在项目内而不是系统临时目录:Windows 下 shell_exec 走 cmd.exe,
// 系统临时目录常带 8.3 短名或重定向,容易出现「命令没执行、stdout 为空」。
$sandbox = dirname(__DIR__) . '/.ti_setting_tmp';
$sessDir = $sandbox . '/sess';
/** 递归删除临时目录 */
function setting_rm($dir)
{
if (!is_dir($dir)) {
return;
}
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($it as $f) {
$f->isDir() ? @rmdir($f->getPathname()) : @unlink($f->getPathname());
}
@rmdir($dir);
}
setting_rm($sandbox);
foreach (['admin', 'functions/class', 'tpl/admin', 'db', 'sess'] as $d) {
@mkdir($sandbox . '/' . $d, 0777, true);
}
// 复制被测文件与依赖
copy($host . '/admin/setting.php', $sandbox . '/admin/setting.php');
copy($host . '/functions/token.php', $sandbox . '/functions/token.php');
copy($host . '/functions/version.php', $sandbox . '/functions/version.php');
copy($host . '/functions/version.txt', $sandbox . '/functions/version.txt');
copy($host . '/tpl/admin/header.php', $sandbox . '/tpl/admin/header.php');
copy($host . '/tpl/admin/left.php', $sandbox . '/tpl/admin/left.php');
copy($host . '/tpl/admin/footer.php', $sandbox . '/tpl/admin/footer.php');
// 桩:替代后台登录校验,只提供页面需要的 $config / $database / $pic
file_put_contents($sandbox . '/functions/class/class.admin.php', <<<'PHP'
<?php
$config = ['user' => 'demo-admin', 'domain' => 'https://img.example.com/', 'admindir' => 'upload'];
$database = null;
$pic = null;
PHP
);
// 场景驱动:通过命令行参数控制 GET / POST、Token 状态、CSRF 是否正确
file_put_contents($sandbox . '/driver.php', <<<'PHP'
<?php
$sandbox = __DIR__;
chdir($sandbox . '/admin');
define('APP', $sandbox . '/');
require_once $sandbox . '/functions/token.php';
$case = isset($argv[1]) ? $argv[1] : 'empty';
$csrf = isset($argv[2]) ? $argv[2] : 'good';
if ($case === 'empty') {
tinyimg_token_save('', false, ['user' => 'demo-admin']);
} elseif ($case === 'enabled') {
tinyimg_token_save('SecretTokenValue0123456789abcdef', true, ['user' => 'demo-admin']);
} elseif ($case === 'disabled') {
tinyimg_token_save('SecretTokenValue0123456789abcdef', false, ['user' => 'demo-admin']);
}
$_SERVER['REQUEST_METHOD'] = $case === 'reveal' ? 'POST' : 'GET';
if ($case === 'reveal') {
tinyimg_token_save('SecretTokenValue0123456789abcdef', true, ['user' => 'demo-admin']);
session_id('tisettingtest');
session_start();
$_SESSION['tinyimg_csrf'] = 'CSRF_GOOD';
session_write_close();
$_POST['action'] = 'reveal';
$_POST['csrf'] = $csrf === 'good' ? 'CSRF_GOOD' : 'CSRF_BAD';
session_id('tisettingtest');
}
require $sandbox . '/admin/setting.php';
PHP
);
/** 在沙箱里跑一个场景,返回标准输出 */
$run = function ($case, $csrf = 'good') use ($php, $sandbox, $sessDir) {
// Windows 的 shell_exec 走 cmd.exe,不认 escapeshellarg 生成的单引号,必须用双引号;
// 否则命令根本不会执行、stdout 为空,看起来像「页面没输出」。
$q = function ($value) {
return DIRECTORY_SEPARATOR === '\\'
? '"' . $value . '"'
: escapeshellarg($value);
};
$cmd = $q($php)
. ' -d session.save_path=' . $q($sessDir)
. ' -d display_startup_errors=0 -d display_errors=1 -d error_reporting=E_ALL '
. $q($sandbox . '/driver.php')
. ' ' . $q($case) . ' ' . $q($csrf);
return (string) shell_exec($cmd);
};
$TOKEN = 'SecretTokenValue0123456789abcdef';
echo PHP_EOL . '1. 未设置 Token 时的渲染' . PHP_EOL;
$empty = $run('empty');
$check('页面正常输出(无 Fatal / Parse error)',
$empty !== '' && stripos($empty, 'Fatal error') === false && stripos($empty, 'Parse error') === false,
substr(trim($empty), 0, 120));
$check('显示「未设置」状态', strpos($empty, '未设置') !== false);
$check('无 Token 时「显示 / 复制」按钮禁用',
substr_count($empty, 'id="ti-reveal"') === 1 && preg_match('/id="ti-reveal"\s+disabled/', $empty) === 1);
$check('页面有「重新生成 Token」入口', strpos($empty, '重新生成 Token') !== false);
$check('页面有「填入自定义 Token」表单',
strpos($empty, 'name="custom_token"') !== false);
echo PHP_EOL . '2. 已启用时的渲染(核心安全约束)' . PHP_EOL;
$enabled = $run('enabled');
$check('页面正常输出', $enabled !== '' && stripos($enabled, 'Fatal error') === false);
$check('状态显示「已启用」', strpos($enabled, '已启用') !== false);
$check('【关键】完整 Token 不出现在 HTML 中', strpos($enabled, $TOKEN) === false,
'在页面源码里找到了完整 Token');
$check('只输出掩码', strpos($enabled, 'Secret***') !== false);
$check('掩码同时写入 value 与 data-masked',
substr_count($enabled, 'data-masked') >= 1 && strpos($enabled, 'value="Secret***') !== false);
$check('长度信息可见(便于核对,不泄露内容)', strpos($enabled, '长度 32 位') !== false);
$check('没有 Token 时按钮 disabled,有 Token 时不 disabled',
preg_match('/id="ti-reveal"\s+disabled/', $enabled) !== 1);
$check('页面有脱敏视图说明', strpos($enabled, '完整值不写入页面') !== false);
echo PHP_EOL . '3. 已停用时的渲染' . PHP_EOL;
$disabled = $run('disabled');
$check('状态显示「已停用」', strpos($disabled, '已停用') !== false);
$check('停用时按钮仍可用(Token 还在,只是不接受上传)',
preg_match('/id="ti-reveal"\s+disabled/', $disabled) !== 1);
$check('停用时也不泄露完整 Token', strpos($disabled, $TOKEN) === false);
echo PHP_EOL . '4. 按需取回(reveal)受 CSRF 保护' . PHP_EOL;
$revealOk = $run('reveal', 'good');
$revealBad = $run('reveal', 'bad');
$jsonOk = json_decode($revealOk, true);
$check('CSRF 正确时返回 JSON', is_array($jsonOk) && isset($jsonOk['code']) && $jsonOk['code'] === 1,
substr(trim($revealOk), 0, 120));
$check('CSRF 正确时能拿到完整 Token',
is_array($jsonOk) && isset($jsonOk['token']) && $jsonOk['token'] === $TOKEN);
$check('CSRF 错误时不返回任何 Token',
strpos($revealBad, $TOKEN) === false && strpos($revealBad, '"token"') === false,
'错误 CSRF 竟然拿到了 Token');
$check('CSRF 错误时不是合法 JSON 成功响应',
!(is_array(json_decode($revealBad, true)) && isset(json_decode($revealBad, true)['token'])));
echo PHP_EOL . '5. 反证:错误实现必须被这些断言抓住' . PHP_EOL;
// 反证 A:像最初那样直接把 token 放进 value
$badRender = '<input type="password" value="' . $TOKEN . '" readonly>';
$check('反证 A:把明文写进 value 的实现会被「不含完整 Token」断言否掉',
strpos($badRender, $TOKEN) !== false);
$check('反证 A 同时说明该断言不是恒真', strpos($badRender, $TOKEN) !== false
&& strpos($enabled, $TOKEN) === false);
// 反证 B:reveal 不做 CSRF 校验(任何请求都能读)
$badReveal = function ($csrfOk) use ($TOKEN) {
return json_encode(['code' => 1, 'token' => $TOKEN], JSON_UNESCAPED_UNICODE);
};
$check('反证 B:不校验 CSRF 的实现会在「错误 CSRF」场景泄露 Token',
strpos($badReveal(false), $TOKEN) !== false);
$check('反证 B 对照:真实实现在错误 CSRF 下没有泄露',
strpos($revealBad, $TOKEN) === false);
setting_rm($sandbox);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
+202
View File
@@ -0,0 +1,202 @@
<?php
/**
* TinyImg 2.0 API Token 契约测试(无需 Typecho、无需联网、不上传任何图片)。
* 运行:php tests/token_test.php
*
* 覆盖:
* 1. 直接加载图床 functions/token.php,测真实纯函数;
* 2. 源码级断言 functions/upload.php 的 Token 门与 ?ping=1 自检;
* 3. 源码级断言后台 Token 设置页的 CSRF / 四种操作 / 守卫说明;
* 4. 三个「故意写错的实现」反证:证明测试集能抓到真实漏洞。
*/
$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;
}
};
$host = dirname(__DIR__, 2) . '/TinyImg';
$tokenFile = $host . '/functions/token.php';
$uploadFile = $host . '/functions/upload.php';
$settingFile = $host . '/admin/setting.php';
$adminClass = $host . '/functions/class/class.admin.php';
echo PHP_EOL . '1. 交付文件完整性' . PHP_EOL;
foreach (['Token 存储模块' => $tokenFile, '上传端点' => $uploadFile, '后台设置页' => $settingFile] as $label => $path) {
$check($label . '存在', is_file($path), $path);
}
require_once $tokenFile;
echo PHP_EOL . '2. Token 存储文件:编解码与守卫' . PHP_EOL;
$state = [
'token' => 'Abc_123-XYZ789abcdef',
'enabled' => 1,
'created_at' => '2026-11-04 10:00:00',
'updated_at' => '2026-11-04 11:00:00',
];
$raw = tinyimg_token_encode($state);
$decoded = tinyimg_token_decode($raw);
$check('编码首行是 <?php exit; 守卫(直接访问 URL 不会输出 Token)',
strpos($raw, '<?php exit;') === 0);
$check('JSON 载荷在第二行', count(explode("\n", trim($raw))) >= 2);
$check('解码还原 token / enabled / 时间戳',
is_array($decoded) && $decoded['token'] === $state['token']
&& $decoded['enabled'] === 1 && $decoded['created_at'] === $state['created_at']);
$check('解码拒绝没有守卫的裸 JSON', tinyimg_token_decode('{"token":"x"}') === null);
$check('解码拒绝损坏的 JSON', tinyimg_token_decode("<?php exit; ?>\n{not json") === null);
$check('解码拒绝缺少 token 字段', tinyimg_token_decode("<?php exit; ?>\n{\"enabled\":1}") === null);
$check('encode 对 enabled=0 输出 0',
strpos(tinyimg_token_encode(['token' => 'x', 'enabled' => 0]), '"enabled":0') !== false);
echo PHP_EOL . '3. Token 校验:正例 / 反例 / fail closed' . PHP_EOL;
$enabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 1];
$check('正确 Token -> 通过', tinyimg_token_verify($enabled, 'S3cr3tTokenValue_123456') === true);
$check('错误 Token -> 拒绝', tinyimg_token_verify($enabled, 'wrong') === false);
$check('空请求 -> 拒绝', tinyimg_token_verify($enabled, '') === false);
$check('未配置 Token + 空请求 -> 拒绝(不能提权)',
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
$check('未配置 Token + 任意请求 -> 拒绝',
tinyimg_token_verify(['token' => '', 'enabled' => 1], 'anything') === false);
$check('已停用 -> 即使 Token 正确也拒绝',
tinyimg_token_verify(['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0], 'S3cr3tTokenValue_123456') === false);
$check('真实实现使用 hash_equals 恒定时间比较',
strpos(file_get_contents($tokenFile), 'hash_equals($stored, $provided)') !== false);
echo PHP_EOL . '4. 生成 / 格式 / 脱敏 / 旧配置兼容' . PHP_EOL;
$generated = tinyimg_token_generate(32);
$check('生成 64 位十六进制 Token', (bool) preg_match('/^[a-f0-9]{64}$/', $generated), $generated);
$check('两次生成不相同', tinyimg_token_generate(32) !== tinyimg_token_generate(32));
$check('格式校验接受 16~128 位合法字符', tinyimg_token_valid_format(str_repeat('a', 16)));
$check('格式校验拒绝过短', !tinyimg_token_valid_format('abc'));
$check('格式校验拒绝空格 / 引号等危险字符', !tinyimg_token_valid_format('abc def"123456') && !tinyimg_token_valid_format("a'b123456789012"));
$check('脱敏保留首尾且不含完整 Token',
strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), '************') !== false
&& strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), 'abcdefghijklmnopqrstuvwxyz') === false);
$check('脱敏空值给出「未设置」', tinyimg_token_mask('') === '(未设置)');
$fromConfig = tinyimg_token_default(['api_token' => 'legacy-token-value']);
$check('旧版 config.php 的 api_token 会被自动接管',
$fromConfig['token'] === 'legacy-token-value' && $fromConfig['enabled'] === 1
&& $fromConfig['source'] === 'config');
$noConfig = tinyimg_token_default([]);
$check('无旧配置时默认停用(fail closed)',
$noConfig['enabled'] === 0 && $noConfig['source'] === 'none');
echo PHP_EOL . '5. 上传端点源码契约' . PHP_EOL;
$u = is_file($uploadFile) ? file_get_contents($uploadFile) : '';
$check('读取 X-TinyImg-Token 请求头', strpos($u, 'HTTP_X_TINYIMG_TOKEN') !== false);
$check('兼容 POST 字段 token', strpos($u, "\$_POST['token']") !== false);
$check('调用 tinyimg_token_load / tinyimg_token_verify',
strpos($u, 'tinyimg_token_load($config)') !== false
&& strpos($u, 'tinyimg_token_verify($tokenState, $reqToken)') !== false);
$check('校验失败明确报错,不静默回落',
strpos($u, "\$basis->re_error(") !== false && strpos($u, "'API Token 无效!'") !== false);
$check('未配置 / 已停用分别给出可诊断的报错',
strpos($u, 'API Token 未配置') !== false && strpos($u, 'API Token 上传已停用') !== false);
$check('?ping=1 缺少 Token 时直接拒绝', strpos($u, "缺少 API Token") !== false);
$check('?ping=1 成功返回版本与管理员目录',
strpos($u, "'version' => TINYIMG_VERSION") !== false
&& strpos($u, "'admin_dir'") !== false);
$check('校验通过才置 islogin', strpos($u, "\$status = 'islogin';") !== false);
$check('不带 Token 时保留原 Referer + Cookie 逻辑',
strpos($u, 'HTTP_REFERER') !== false && strpos($u, '$basis->check($config)') !== false);
$check('原有上传主体未被改写',
strpos($u, '$basis->limitnum();') !== false
&& strpos($u, "\$handle->file_max_size = '2097152'") !== false
&& strpos($u, "\$handle->process('../'.\$updir") !== false);
$check('上传端点不含旧品牌字符串', strpos(strtolower($u), 'img' . 'url') === false);
echo PHP_EOL . '6. 后台设置页与权限边界' . PHP_EOL;
$s = is_file($settingFile) ? file_get_contents($settingFile) : '';
$check('设置页复用后台登录鉴权', strpos($s, 'class.admin.php') !== false);
$check('写操作校验 Session CSRF', strpos($s, "hash_equals(\$csrf, \$_POST['csrf'])") !== false);
$check('提供重新生成 / 自定义保存 / 启停 / 清空四种操作',
strpos($s, "=== 'regenerate'") !== false && strpos($s, "=== 'save'") !== false
&& strpos($s, "=== 'toggle'") !== false && strpos($s, "=== 'clear'") !== false);
$check('页面显示 Token 且可显示/隐藏/复制',
strpos($s, 'id="ti-token"') !== false && strpos($s, 'ti-reveal') !== false
&& strpos($s, 'ti-copy') !== false);
$check('页面给出连接信息与 ping 自检示例',
strpos($s, 'X-TinyImg-Token') !== false && strpos($s, 'ping=1') !== false);
$check('后台管理类不认识 Token(Token 泄露无法进后台)',
is_file($adminClass) && strpos(file_get_contents($adminClass), 'api_token') === false);
echo PHP_EOL . '7. 测试集有效性反证(故意写错的实现)' . PHP_EOL;
// 错误实现 A:漏掉 enabled 检查 —— 管理员在后台停用 Token 后,旧 Token 仍能上传
$badNoEnabledCheck = function ($state, $provided) {
$stored = isset($state['token']) ? $state['token'] : '';
return $stored !== '' && $provided !== '' && hash_equals($stored, $provided);
};
$disabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0];
$check('错误实现 A 在「已停用」状态下仍放行(真实漏洞)',
$badNoEnabledCheck($disabled, 'S3cr3tTokenValue_123456') === true);
$check('真实实现在同样输入下必须拒绝',
tinyimg_token_verify($disabled, 'S3cr3tTokenValue_123456') === false);
// 错误实现 B:用 == 松散比较且不检查空值 —— 空配置 + 空请求直接提权
$badLooseCompare = function ($state, $provided) {
return $state['token'] == $provided;
};
$check('错误实现 B 在「空配置 + 空请求」下放行(真实漏洞)',
$badLooseCompare(['token' => '', 'enabled' => 1], '') === true);
$check('真实实现在同样输入下必须拒绝',
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
// 错误实现 C:子串匹配当校验
$badSubstring = function ($state, $provided) {
return $provided !== '' && strpos($state['token'], $provided) !== false;
};
$check('错误实现 C 让短前缀冒充 Token 通过',
$badSubstring($enabled, substr($enabled['token'], 0, 4)) === true);
$check('真实实现必须拒绝短前缀',
tinyimg_token_verify($enabled, substr($enabled['token'], 0, 4)) === false);
echo PHP_EOL . '8. 真实文件读写(临时目录,不碰线上数据)' . PHP_EOL;
$tmp = sys_get_temp_dir() . '/tinyimg-token-test-' . bin2hex(random_bytes(4));
@mkdir($tmp . '/db', 0700, true);
if (!defined('APP')) {
define('APP', $tmp . '/');
}
$saved = tinyimg_token_save('RealFileToken_123456', true, []);
$check('保存成功', $saved[0] === true, $saved[1]);
$path = tinyimg_token_file();
$check('存储文件落在 db/ 目录', is_file($path) && basename($path) === 'tinyimg-token.php', $path);
$check('存储文件首行是 PHP exit 守卫',
strpos(file_get_contents($path), '<?php exit;') === 0);
$loaded = tinyimg_token_load([]);
$check('读回 Token 且来源标记为 file',
$loaded['token'] === 'RealFileToken_123456' && $loaded['enabled'] === 1
&& $loaded['source'] === 'file', json_encode($loaded));
$check('读回状态能通过校验', tinyimg_token_verify($loaded, 'RealFileToken_123456') === true);
$check('停用后读回状态不再放行', (function () use ($tmp) {
tinyimg_token_save('RealFileToken_123456', false, []);
return tinyimg_token_verify(tinyimg_token_load([]), 'RealFileToken_123456') === false;
})());
$check('自定义非法 Token 不会被写入', !tinyimg_token_valid_format('bad token!'));
@unlink($path);
@rmdir($tmp . '/db');
@rmdir($tmp);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
+171
View File
@@ -0,0 +1,171 @@
<?php
use TypechoPlugin\TinyImgUploader\Util;
require_once __DIR__ . '/../Util.php';
/**
* Util 纯函数测试(无需 Typecho、无需联网)
* 运行:php tests/util_test.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;
}
};
$base = 'https://img.example.com/tinyimg/functions/upload.php';
echo PHP_EOL . '1. 图床响应解析' . PHP_EOL;
$cases = [
[
'name' => 'TinyImg 2.0 成功响应(源码里的字段结构)',
'body' => '{"code":1,"id":9527,"url":"https://img.example.com/tinyimg/temp/2611/abcd.jpg","width":800,"height":600}',
'code' => 1,
'url' => 'https://img.example.com/tinyimg/temp/2611/abcd.jpg',
],
[
'name' => 'TinyImg 2.0 失败响应(Token 无效 / 非法请求)',
'body' => '{"code":0,"msg":"\u975e\u6cd5\u8bf7\u6c42\uff01"}',
'code' => 0,
'url' => null,
],
[
'name' => 'TinyImg 2.x 成功响应(data.url 嵌套)',
'body' => '{"code":200,"msg":"success","data":{"url":"https://img.example.com/a.png"}}',
'code' => 1,
'url' => 'https://img.example.com/a.png',
],
[
'name' => '通用 success / data.url 响应',
'body' => '{"success":true,"data":{"url":"https://img.example.com/b.jpg"}}',
'code' => 1,
'url' => 'https://img.example.com/b.jpg',
],
[
'name' => 'code=0 但带了 url,仍必须判失败',
'body' => '{"code":0,"url":"https://img.example.com/c.jpg","msg":"非法请求"}',
'code' => 0,
'url' => null,
],
[
'name' => '非 JSON 的 HTML 错误页',
'body' => '<html><body>500 Internal Server Error</body></html>',
'code' => 0,
'url' => null,
],
[
'name' => '空响应(PHP 报错 / 5xx 常见表现)',
'body' => '',
'code' => 0,
'url' => null,
],
[
'name' => 'JSON 前有 PHP notice 也能解析',
'body' => 'Notice: undefined index in upload.php' . "\n" . '{"code":1,"url":"https://img.example.com/d.png"}',
'code' => 1,
'url' => 'https://img.example.com/d.png',
],
];
foreach ($cases as $case) {
$got = Util::parseResponse($case['body'], $base);
$ok = ($got['code'] === $case['code']) && (($got['url'] ?: null) === $case['url']);
$check($case['name'], $ok, json_encode($got, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
}
echo PHP_EOL . '2. 图片地址归一化' . PHP_EOL;
$normalized = [
['{"code":1,"url":"/tinyimg/temp/2611/x.png"}', 'https://img.example.com/tinyimg/temp/2611/x.png'],
['{"code":1,"url":"//cdn.example.com/x.png"}', 'https://cdn.example.com/x.png'],
['{"code":1,"url":"temp/2611/x.jpg"}', 'https://img.example.com/tinyimg/functions/temp/2611/x.jpg'],
];
foreach ($normalized as $item) {
$got = Util::parseResponse($item[0], $base);
$check('归一化 ' . $item[1], $got['code'] === 1 && $got['url'] === $item[1], (string) $got['url']);
}
echo PHP_EOL . '3. 配置文本解析' . PHP_EOL;
$pairs = Util::parsePairs("# 注释行\ntoken=abc123\nuid=1\n\nfolder=3", '=');
$check('key=value 解析', count($pairs) === 3 && $pairs['token'] === 'abc123' && $pairs['uid'] === '1', json_encode($pairs));
$headerPairs = Util::parsePairs("Referer: https://img.example.com/tinyimg/\nCookie: sid=abc", ':');
$check(
'Key: Value 中值含冒号',
$headerPairs['Referer'] === 'https://img.example.com/tinyimg/' && $headerPairs['Cookie'] === 'sid=abc',
json_encode($headerPairs)
);
$check(
'deriveReferer 去掉 functions 层',
Util::deriveReferer($base) === 'https://img.example.com/tinyimg/',
Util::deriveReferer($base)
);
$check(
'deriveReferer 通用 /api/upload',
Util::deriveReferer('https://x.example.com/api/upload') === 'https://x.example.com/api/'
);
echo PHP_EOL . '4. 连接自检地址(?ping=1)' . PHP_EOL;
$pingCases = [
['https://img.example.com/functions/upload.php', 'https://img.example.com/functions/upload.php?ping=1'],
['https://img.example.com/functions/upload.php?x=1', 'https://img.example.com/functions/upload.php?x=1&ping=1'],
['https://img.example.com/functions/upload.php#frag', 'https://img.example.com/functions/upload.php?ping=1'],
['', ''],
];
foreach ($pingCases as $i => $case) {
$got = Util::pingUrl($case[0]);
$check('pingUrl 用例 ' . ($i + 1), $got === $case[1], $got);
}
$check('pingUrl 输出是 http(s) 绝对地址',
(bool) preg_match('#^https://.+\?ping=1$#', Util::pingUrl('https://img.example.com/functions/upload.php')));
echo PHP_EOL . '5. 测试集有效性反证(故意错误的实现)' . PHP_EOL;
// 错误实现 A:只认 TinyImg 2.x 的 data.url,漏掉 1.x 的顶层 url
$badV2Only = function ($body) {
$data = json_decode($body, true);
return isset($data['data']['url']) ? $data['data']['url'] : null;
};
$check(
'错误实现 A 在 1.x 成功样例上必须取不到 URL',
$badV2Only($cases[0]['body']) === null
);
$check(
'正确实现在同一份样例上必须成功',
Util::parseResponse($cases[0]['body'], $base)['code'] === 1
);
// 错误实现 B:忽略 code=0,只要看到 url 就算成功
$badIgnoreCode = function ($body) {
$data = json_decode($body, true);
return isset($data['url']) ? $data['url'] : null;
};
$failureWithUrl = '{"code":0,"url":"https://img.example.com/c.jpg","msg":"非法请求"}';
$check(
'错误实现 B 会把失败响应误判为成功',
$badIgnoreCode($failureWithUrl) === 'https://img.example.com/c.jpg'
);
$check(
'正确实现必须把该响应判为失败',
Util::parseResponse($failureWithUrl, $base)['code'] === 0
);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);
+73
View File
@@ -0,0 +1,73 @@
<?php
use TypechoPlugin\TinyImgUploader\Util;
require_once __DIR__ . '/../Util.php';
/**
* 生成管理员登录 Cookie(回退方案;纯本地计算,不联网、不上传任何东西)。
*
* php tools/cookie.php 管理员账号 '明文密码'
* php tools/cookie.php 管理员账号 --md5=32位十六进制值
*
* 依据 TinyImg/functions/class/class.user.php:
* login(): $password = md5("tinyimg" . $admin['password']); setcookie("password", $password, ...);
* check(): $config['user'] . md5("tinyimg" . $config['password']) === $_COOKIE['user'] . $_COOKIE['password']
*
* 推荐把输出的 32 位值填进插件设置,而不是明文密码:这样数据库里不存密码明文。
*/
if (PHP_SAPI !== 'cli') {
exit('仅允许在命令行运行' . PHP_EOL);
}
$args = array_slice($argv, 1);
$user = '';
$secret = '';
foreach ($args as $arg) {
if (strpos($arg, '--md5=') === 0) {
$secret = substr($arg, 6);
} elseif ($arg === '--help' || $arg === '-h') {
echo "用法:php tools/cookie.php 管理员账号 '明文密码'\n"
. " php tools/cookie.php 管理员账号 --md5=32位值\n\n"
. "只做本地 md5 计算,不会访问图床、不会上传图片。\n"
. "注意:明文密码写在命令行会留在 shell 历史里,用完后建议清理历史。\n";
exit(0);
} elseif ($user === '') {
$user = $arg;
} elseif ($secret === '') {
$secret = $arg;
}
}
if ($user === '' || $secret === '') {
exit("缺少参数。用法:php tools/cookie.php 管理员账号 '明文密码'(或 --help)\n");
}
if (!preg_match('/^[a-f0-9]{32}$/i', $secret)) {
echo "提示:检测到明文密码,将按 md5(\"tinyimg\" . 密码) 计算 Cookie 值。\n\n";
}
$cookie = Util::adminCookie($user, $secret);
if ($cookie === null) {
exit("账号或密码为空,无法生成 Cookie\n");
}
echo "=== TinyImg 2.0 管理员登录 Cookie(回退方案) ===" . PHP_EOL . PHP_EOL;
echo '图床管理员账号 : ' . $user . PHP_EOL;
echo 'password Cookie 值 : ' . $cookie['password'] . PHP_EOL;
echo '完整 Cookie 头 : ' . Util::mergeCookie('', $cookie) . PHP_EOL;
echo PHP_EOL;
echo "填到插件设置:" . PHP_EOL;
echo ' 图床管理员账号 = ' . $user . PHP_EOL;
echo ' 图床管理员密码 / 登录 Cookie 值 = ' . $cookie['password'] . PHP_EOL;
echo PHP_EOL;
echo "验证(会真实上传 1 张图片,请在博客服务器或本机有 curl 扩展时执行):" . PHP_EOL;
echo ' php tools/probe.php --url=https://你的图床/functions/upload.php --file=./test.png'
. ' --admin-user=' . $user . ' --admin-secret=' . $cookie['password'] . PHP_EOL;
echo PHP_EOL;
echo "本工具不联网;Cookie 值等同于图床登录凭证,请勿提交到公开仓库。\n";
echo "注意:TinyImg 2.0 已把 Cookie 盐改为 tinyimg,升级后旧 Cookie 会失效,需重新登录。\n";
echo "推荐用默认的 API Token 模式:到图床后台「Token 设置」生成,填进插件设置并点「测试连接」。\n";
+424
View File
@@ -0,0 +1,424 @@
<?php
use TypechoPlugin\TinyImgUploader\Util;
require_once __DIR__ . '/../Util.php';
/**
* 图床上传接口自检工具(命令行,仅用于排错,插件运行不依赖它)
*
* php tools/probe.php
* 只读探测:发一个 GET,检查接口是否可达、CORS 头、返回格式。不会上传任何图片。
*
* php tools/probe.php --url=https://你的图床/functions/upload.php
* 指定接口地址(默认是占位地址,实战请务必传 --url)。
*
* php tools/probe.php --url=... --token=你的Token --ping
* 只做连接自检:POST ?ping=1,不上传任何文件,打印图床版本与管理员目录。
*
* php tools/probe.php --url=... --file=./test.png --token=你的Token
* 用 API Token(X-TinyImg-Token 请求头,与插件一致)真实上传一张图片并判定目录。
*
* php tools/probe.php --url=... --file=./test.png --admin-user=账号 --admin-secret=密码
* 用管理员 Cookie 上传(回退方案)。--admin-secret 可填明文密码或 32 位 Cookie 值。
*/
if (PHP_SAPI !== 'cli') {
exit('仅允许在命令行运行' . PHP_EOL);
}
$opt = getopt('', [
'url::', 'file::', 'field::', 'token::', 'header::',
'admin-user::', 'admin-secret::', 'admin-dir::', 'ping', 'help',
]);
if (isset($opt['help'])) {
echo <<<'HELP'
用法:
php tools/probe.php
只读探测(GET,不上传图片)
php tools/probe.php --url=接口地址
指定上传接口(默认是占位地址,实战必须传 --url)
php tools/probe.php --url=... --token=你的Token --ping
连接自检:POST ?ping=1,不上传文件,输出图床版本与管理员目录(等价于插件「测试连接」)
php tools/probe.php --url=... --file=./test.png
真实上传一张图片
API Token 上传(推荐,TinyImg 2.0 原生支持):
php tools/probe.php --url=... --file=./test.png --token=你的Token
Token 通过 X-TinyImg-Token 请求头发送,与插件行为一致
管理员 Cookie 上传(回退方案):
php tools/probe.php --url=... --file=./test.png --admin-user=账号 --admin-secret=密码
--admin-secret 可填明文密码,也可填 32 位 md5 值(用 tools/cookie.php 生成)
上传模式会检查图片地址是否落在 upload 目录,没落进去则以非零状态退出。
可选参数:
--field=字段名 默认 file
--header="K: V" 附加请求头,可重复
--admin-dir=目录 管理员上传目录名,默认 upload(对应 config.php 的 admindir)
--help 显示本说明
HELP;
exit(0);
}
$url = isset($opt['url']) ? trim($opt['url'])
: 'https://img.example.com/functions/upload.php';
$field = isset($opt['field']) ? trim($opt['field']) : 'file';
$token = isset($opt['token']) ? trim($opt['token']) : '';
$file = isset($opt['file']) ? trim($opt['file']) : '';
if (!preg_match('#^https?://#i', $url)) {
exit('接口地址必须以 http:// 或 https:// 开头' . PHP_EOL);
}
$headers = [
'User-Agent' => 'Mozilla/5.0 (compatible; TypechoTinyImgUploader-Probe/1.0)',
'Referer' => Util::deriveReferer($url),
'X-Requested-With' => 'XMLHttpRequest',
];
if (isset($opt['header'])) {
$lines = is_array($opt['header']) ? $opt['header'] : [$opt['header']];
foreach ($lines as $line) {
$pos = strpos($line, ':');
if ($pos !== false) {
$headers[trim(substr($line, 0, $pos))] = trim(substr($line, $pos + 1));
}
}
}
$headers = array_filter($headers, function ($value) {
return $value !== '';
});
$byToken = $token !== '';
$ping = isset($opt['ping']);
if ($byToken && (isset($opt['admin-user']) || isset($opt['admin-secret']))) {
exit('不能同时使用 --token 与 --admin-user/--admin-secret,请二选一' . PHP_EOL);
}
// 与插件一致:Token 只走请求头,不进表单字段、不出现在 URL
if ($byToken) {
$headers['X-TinyImg-Token'] = $token;
}
$asAdmin = isset($opt['admin-user']) || isset($opt['admin-secret']);
$cookiePair = null;
if ($asAdmin) {
$cookiePair = Util::adminCookie(
isset($opt['admin-user']) ? $opt['admin-user'] : '',
isset($opt['admin-secret']) ? $opt['admin-secret'] : ''
);
if ($cookiePair === null) {
exit('管理员模式需要同时提供 --admin-user 和 --admin-secret' . PHP_EOL);
}
$existing = '';
foreach ($headers as $key => $value) {
if (strcasecmp($key, 'Cookie') === 0) {
$existing = $value;
unset($headers[$key]);
}
}
$headers['Cookie'] = Util::mergeCookie($existing, $cookiePair);
}
$adminDir = isset($opt['admin-dir']) ? $opt['admin-dir'] : 'upload';
function probe_request($url, array $headers, $fields = null)
{
if (!function_exists('curl_init')) {
return probe_request_stream($url, $headers, $fields);
}
$lines = ['Expect:'];
foreach ($headers as $key => $value) {
$lines[] = $key . ': ' . $value;
}
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => true,
CURLOPT_HTTPHEADER => $lines,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 45,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_MAXREDIRS => 3,
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
]);
if ($fields !== null) {
$postFields = [];
foreach ($fields as $key => $value) {
$postFields[$key] = (is_array($value) && isset($value['__file']))
? new CURLFile($value['__file'], $value['mime'], $value['name'])
: $value;
}
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
}
$raw = curl_exec($ch);
if ($raw === false) {
$error = curl_error($ch);
curl_close($ch);
return ['error' => $error];
}
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return [
'error' => null,
'status' => $status,
'header' => substr($raw, 0, $headerSize),
'body' => substr($raw, $headerSize),
];
}
/**
* 没有 curl 扩展时的等价实现:GET 或手工拼 multipart POST。
*/
function probe_request_stream($url, array $headers, $fields = null)
{
$header = '';
foreach ($headers as $key => $value) {
$header .= $key . ': ' . $value . "\r\n";
}
$method = 'GET';
$content = null;
if ($fields !== null) {
$method = 'POST';
$boundary = '----ProbeIU' . md5(uniqid('', true));
$content = '';
foreach ($fields as $key => $value) {
$content .= '--' . $boundary . "\r\n";
if (is_array($value) && isset($value['__file'])) {
$name = str_replace(['"', "\r", "\n"], '', $value['name']);
$content .= 'Content-Disposition: form-data; name="' . $key
. '"; filename="' . $name . '"' . "\r\n";
$content .= 'Content-Type: ' . $value['mime'] . "\r\n\r\n";
$content .= file_get_contents($value['__file']) . "\r\n";
} else {
$content .= 'Content-Disposition: form-data; name="' . $key . '"' . "\r\n\r\n";
$content .= $value . "\r\n";
}
}
$content .= '--' . $boundary . "--\r\n";
$header .= 'Content-Type: multipart/form-data; boundary=' . $boundary . "\r\n";
}
$options = [
'method' => $method,
'header' => $header,
'timeout' => 45,
'ignore_errors' => true,
'follow_location' => 1,
'max_redirects' => 3,
];
if ($content !== null) {
$options['content'] = $content;
}
$context = stream_context_create(['http' => $options]);
$body = @file_get_contents($url, false, $context);
if ($body === false) {
$last = error_get_last();
$message = $last ? $last['message'] : '请求失败(allow_url_fopen 可能已关闭)';
if (stripos($message, 'No such file or directory') !== false && stripos($url, 'https://') === 0) {
$message .= ' —— 可能是该 PHP 未启用 openssl,https:// wrapper 不可用;'
. '请在博客服务器上用带 curl 扩展的 PHP 运行本工具';
}
return ['error' => $message];
}
$status = 0;
$rawHeader = '';
if (isset($http_response_header) && is_array($http_response_header)) {
$rawHeader = implode("\r\n", $http_response_header);
foreach ($http_response_header as $line) {
if (preg_match('#^HTTP/\S+\s+(\d{3})#', $line, $m)) {
$status = (int) $m[1];
}
}
}
return ['error' => null, 'status' => $status, 'header' => $rawHeader, 'body' => $body];
}
function out($label, $value)
{
// 按终端显示宽度补齐,中文按 2 列算,避免中文标签对不齐
$width = function_exists('mb_strwidth') ? mb_strwidth($label, 'UTF-8') : strlen($label);
echo $label . str_repeat(' ', max(1, 20 - $width)) . ': ' . $value . PHP_EOL;
}
echo PHP_EOL . '=== TinyImg 上传接口自检 ===' . PHP_EOL;
out('接口地址', $url);
out('Referer', isset($headers['Referer']) ? $headers['Referer'] : '(未设置)');
out('上传身份', $byToken
? 'API Token(X-TinyImg-Token 头)'
: ($asAdmin ? '管理员(附带登录 Cookie)' : '游客(无凭证)'));
if ($byToken) {
out('API Token', substr($token, 0, 6) . '…(已脱敏)');
}
if ($asAdmin || $byToken) {
out('管理员目录', $adminDir === '' ? '(留空,跳过目录判定)' : $adminDir);
}
if ($asAdmin) {
out('Cookie', 'user=' . $cookiePair['user'] . '; password='
. substr($cookiePair['password'], 0, 8) . '…(已脱敏)');
}
if ($ping) {
if (!$byToken) {
exit('--ping 需要同时提供 --token(与插件「测试连接」使用同一条通道)' . PHP_EOL);
}
$pingUrl = Util::pingUrl($url);
out('自检地址', $pingUrl);
echo PHP_EOL . '模式:连接自检(POST ?ping=1,不上传任何文件)' . PHP_EOL;
$response = probe_request($pingUrl, $headers, []);
if ($response['error']) {
out('错误', $response['error']);
exit(1);
}
out('HTTP 状态', $response['status']);
out('原始响应', Util::clip($response['body'], 300));
$data = json_decode(trim($response['body']), true);
if (!is_array($data) || !isset($data['code']) || (string) $data['code'] !== '1') {
out('结论', '失败:' . (is_array($data) && isset($data['msg']) ? $data['msg'] : '图床未返回成功的 JSON'));
echo PHP_EOL . '排查:确认图床已升级到 TinyImg 2.0(支持 ?ping=1)、Token 已在后台「Token 设置」启用。' . PHP_EOL;
exit(1);
}
out('结论', '通过:Token 有效');
out('图床', (isset($data['name']) ? $data['name'] : '?') . ' ' . (isset($data['version']) ? $data['version'] : '?'));
out('管理员目录', isset($data['admin_dir']) ? $data['admin_dir'] : '(未返回)');
if (isset($data['admin_dir']) && strcasecmp($data['admin_dir'], $adminDir) !== 0) {
out('目录比对', '不一致:插件应把「管理员上传目录名」设为 ' . $data['admin_dir']);
exit(1);
}
out('目录比对', '一致');
exit(0);
}
if ($file === '') {
echo PHP_EOL . '模式:只读探测(GET,不会上传任何图片)' . PHP_EOL;
$response = probe_request($url, $headers, null);
if ($response['error']) {
out('错误', $response['error']);
exit(1);
}
out('HTTP 状态', $response['status']);
out(
'CORS 响应头',
stripos($response['header'], 'access-control-allow-origin') !== false
? '有(浏览器直连可行)'
: '无(浏览器直连会被同源策略拦截,插件需使用服务端代理)'
);
out('响应体', Util::clip($response['body'], 300));
$parsed = Util::parseResponse($response['body'], $url);
out('解析结论', $parsed['code'] === 1 ? ('可用,URL = ' . $parsed['url']) : $parsed['msg']);
echo PHP_EOL . '说明:GET 返回「非法请求」是正常现象,只说明接口存在且拒绝无文件的请求。'
. PHP_EOL . ' 要验证真实上传 / 管理员身份是否生效,请加 --file=本地图片路径。' . PHP_EOL;
exit(0);
}
if (!is_file($file)) {
exit('找不到图片文件:' . $file . PHP_EOL);
}
$info = @getimagesize($file);
if (!$info || empty($info['mime'])) {
exit('文件不是有效图片:' . $file . PHP_EOL);
}
echo PHP_EOL . '模式:真实上传(会往图床写入 1 张图片)' . PHP_EOL;
out('本地文件', $file . ' (' . ceil(filesize($file) / 1024) . ' KB, ' . $info['mime'] . ')');
// Token 已放进请求头,这里不再重复作为表单字段,保证探测的是插件真实使用的路径
$fields = [];
// 用普通数组描述文件,避免在没有 curl 扩展的机器上依赖 CURLFile 类
$fields[$field] = [
'__file' => $file,
'mime' => $info['mime'],
'name' => basename($file),
];
$response = probe_request($url, $headers, $fields);
if ($response['error']) {
out('错误', $response['error']);
exit(1);
}
out('HTTP 状态', $response['status']);
out('原始响应', Util::clip($response['body'], 300));
$parsed = Util::parseResponse($response['body'], $url);
if ($parsed['code'] === 1) {
out('图片地址', $parsed['url']);
out('Markdown', '![](' . $parsed['url'] . ')');
if ($asAdmin || $byToken) {
$inAdmin = Util::inAdminDir($parsed['url'], $adminDir);
if ($inAdmin === true) {
out('管理员目录判定', '通过:图片进了 ' . $adminDir . '/,鉴权身份已生效');
} elseif ($inAdmin === false) {
out('管理员目录判定', '未通过:地址里没有 /' . $adminDir . '/,本次实际仍是游客上传');
echo PHP_EOL . ($byToken
? '失败:图床没有按 Token 识别身份。请到图床后台「Token 设置」确认 Token 已启用,'
. PHP_EOL . ' 且与 --token 完全一致;可先跑一次 --ping 做连接自检。'
: '失败:图床没认出管理员身份(Cookie 不匹配时图床不会报错,只会静默改目录)。'
. PHP_EOL . ' 请核对 config.php 的 user / password,或用 tools/cookie.php 重新生成 Cookie 值。')
. PHP_EOL;
exit(1);
} else {
out('管理员目录判定', '已跳过(--admin-dir 留空)');
}
}
echo PHP_EOL . '成功:接口可用,插件可使用默认的服务端代理模式。' . PHP_EOL;
exit(0);
}
out('失败原因', $parsed['msg']);
echo PHP_EOL . '排查:检查字段名(--field)、图片是否超过 2 MB、Token 是否与图床后台「Token 设置」一致;'
. PHP_EOL . ' 可先加 --ping 做连接自检;若返回「API Token 无效!」说明图床侧 Token 未启用或不一致。' . PHP_EOL;
exit(1);