typecho搜索增强插件 搜索时不过滤空格和符号 不改一行核心文件,纯插件实现

typecho搜索增强插件 搜索时不过滤空格和符号 不改一行核心文件,纯插件实现

王忘杰
2026-11-19 / 0 评论 / 23 阅读 / 正在检测是否收录...

mwmv3va6.png

typecho搜索增强插件 · 开发总结

插件名:typecho搜索增强插件
介绍:搜索时不过滤空格和符号
作者:王忘杰 网站:90apt.com 版本:1.0.0 兼容:Typecho 1.3.x 状态:已验证通过

1. 问题现象

原生搜索会吞掉空格与符号,导致本该命中的文章搜不到。

表现
✕ 原生windows 10 系统 → windows10系统,空格消失;.net3.5 → net3 5 / net35,符号与点号被破坏;C++、a/b 几乎无法检索
✓ 修复后空格保留,实现 A + 空格 + B 同时命中;点号、斜杠、加号、百分号原样参与匹配;中英数符混合词均可检索

常见做法是直接改核心文件 var/Widget/Archive.php,把 filter('url','search') 去掉。本插件达成同等效果,但完全不碰核心,升级 Typecho 不受影响。


2. 双重根因

排查发现是两个独立机制叠加破坏关键词,缺一不可。

根因 A · Typecho 核心过滤器

// var/Widget/Archive.php : 搜索关键词读取
$keywords = $this->request->filter('url', 'search')->get('keywords');

// var/Typecho/Common.php
safeUrl()           // 删除空格
filterSearchQuery() // → slugName():只保留 [\w_-],其余全丢

// 实测:.net3.5  →  slug = net3-5  →  filter = net3 5

根因 B · nginx 伪静态截断

# 站点现有 rewrite(官方标准写法,本身没错)
if (!-e $request_filename) {
    rewrite ^(.*)$ /index.php$1 last;
}

# 问题:含点号的 path 被当成带扩展名的文件路径
# /search/.net3.5/  →  PATH_INFO 逐次截断  →  net35  →  35
两处叠加:过滤器先吞符号,nginx 再截断点号后的内容。这正是前几版"改了搜索逻辑却仍搜不到"的原因——原始词在到达插件之前就已经被破坏了。

3. 最终方案:seh + hex 编码

核心思路:不让原文出现在 URL 里。在最早期把词转成纯字母数字的编码,完整穿过过滤器和 nginx,消费端再解码。

用户输入 → begin() 编码 → 核心+nginx 透传 → 插件解码
.net3.5  → seh2e6e6574332e35 → 无点号安全  → hex2bin → .net3.5
// 编码:seh + bin2hex,纯字母数字,slugName 原样保留、nginx 不截断
$encoded = 'seh' . bin2hex($s);   // .net3.5 → seh2e6e6574332e35

// 还原:识别 seh 前缀后 hex2bin
if (preg_match('/^seh([0-9a-f]+)$/i', $keywords, $m)) {
    $plain = hex2bin($m[1]);      // → .net3.5
}

四个官方钩子

钩子职责
index.php :: begin最早 intercept,把 s 改写为 seh 编码
Archive :: search解码原始词,触发核心跳过被破坏的原生 LIKE
Archive :: searchHandle用原始词重建查询条件,自行完成计数与分页
Archive :: pageNav分页链接同样携带 seh 编码,翻页不丢词

4. 关键实现细节

// 多词用 % 连接,与原生的 str_replace(' ','%',$keywords) 语义一致
$pattern = '%' . implode('%', $terms) . '%';
// .net3.5        →  LIKE '%.net3.5%'
// windows 10 系统 →  LIKE '%windows%10%系统%'

$select->where("(title LIKE ? OR text LIKE ?)", $pattern, $pattern)
       ->where("type = ?", 'post');
  • 参数全部绑定(? 占位符),无 SQL 注入风险
  • 复刻核心的密码保护与登录状态判断,行为一致
  • 保留「顺序短语 / 独立多词」与「标题+正文 / 仅标题」两个配置项
  • 标题先转义输出;关键词由 keywords() 自行转义,避免双重转义
  • 空关键词返回空结果,不退化成全量列出

关于「顺序短语」模式:zabbix 8 生成 LIKE '%zabbix%8%',要求同一字段内 zabbix 在前、8 在后。已实测确认这是与原生一致的设计行为,非 bug:

标题phrase 模式
Zabbix 8.0 安装教程✅ 命中
Zabbix 7 升级到 8 指南✅ 命中
8.0 版本 Zabbix 部署❌ 不匹配(8 在 zabbix 前)
Zabbix 监控 / 8 个技巧❌ 不匹配(缺词)

想宽松匹配(8.0 版本 Zabbix 也能搜到)时,在插件配置里切换到「独立多词」即可。


5. 验证结果

用便携 PHP 8.3 实测:编码穿过核心过滤器 → 解码还原的完整链路。

测试关键词seh 编码穿过过滤器还原结果结论
.net3.5seh2e6e6574332e35原样.net3.5通过
windows 10 系统seh77696e…bb9f原样windows 10 系统通过
C++seh432b2b原样C++通过
a/bseh612f62原样a/b通过
100%seh31303025原样100%通过
  • PHP 语法检查:php -l 无错误
  • 线上实测:搜索 .net3.5 命中预期文章
  • URL 形态:/search/seh2e6e6574332e35/,无点号、无符号

6. 安全性审查

结论:不存在 SQL 注入。 按源码追踪 + 载荷实测两侧验证。

已证 · SQL 注入不成立

  • 用户输入关键词从不直接拼接进 SQL,全部通过 ? 占位符传入
  • Typecho Query::where() 把参数登记为 #param:N#,prepare() 时经 adapter->quoteValue()(MySQL 为 real_escape_string)转义后加引号
  • 实测三类注入载荷(' OR '1'='1、') OR 1=1 --、'; DROP TABLE --):单引号均被转义成 \',整体困在 LIKE 字符串内部,无法闭合引号
  • 拼进 SQL 的 LIKE / ILIKE 由数据库驱动硬编码二选一,不来自用户输入;type = 'post'、分页页码也均为参数绑定或强转整数
// 插件:全部用 ? 占位符
$select->where("(table.contents.title LIKE ? OR table.contents.text LIKE ?)", $pattern, $pattern);

// 核心 Query::prepare():占位符 → 转义后的带引号字符串
return preg_replace_callback("/#param:([0-9]+)#/", fn($m) =>
    $adapter->quoteValue($params[$m[1]]), $query);

// 实测注入载荷的最终 SQL:引号被转义,无法逃逸
LIKE '%%\')%OR%1=1%--%%'

已证 · 其他输出安全

  • 搜索标题 setArchiveTitle() 经 htmlspecialchars 转义,杜绝反射型 XSS
  • 关键词经 seh+hex 白名单解码,hex2bin 前用 ^[0-9a-f]+$ 严格校验,非法字符直接丢弃
  • 无文件读写、无外部请求、无 eval/system 等危险函数
说明(非插件引入):核心 Archive.php:1336 存在用 archiveSlug 拼模板文件名的逻辑。本插件只在搜索归档下设置它,主题里未发现直接输出;原生搜索同样如此设置,行为与核心一致,未引入新的攻击面。

7. 安装与使用

  1. 将 usr/plugins/SearchEnhance/ 目录上传到站点相同路径
  2. 后台「插件」页启用,显示名:typecho搜索增强插件
  3. 启用后无需其他配置,搜索框输入含空格/符号的词即可
  4. 可在插件配置中切换多词匹配方式与搜索范围
  5. 不修改任何核心文件,Typecho 升级不受影响
已知限制:Joe 主题搜索框写有 maxlength="16",超过 16 字符的词会被前端截断。如需搜索 .NET Framework 3.5 这类长词,需把 public/header.php 中搜索 input 的 maxlength 调大。

typecho搜索增强插件 v1.0.0 · 王忘杰 · 90apt.com · 搜索时不过滤空格和符号

0

评论

博主关闭了所有页面的评论