Showdoc + PHP8 导致单引号被转义的解决方案

在 ShowDoc 中，如果单引号（'）被自动转义为 '，通常是由于 HTML 转义 或 模板引擎的默认行为 导致的。以下是几种可能的解决方案：

1. 修改 ShowDoc 的模板渲染配置

ShowDoc 可能使用了 Smarty、Twig 或其他模板引擎，默认会对 HTML 特殊字符进行转义。可以尝试：

（1）关闭自动转义

• Smarty 模板引擎（如果 ShowDoc 使用）：

  {$var nofilter}  {* 禁用转义 *}
  

  或全局配置：

  $smarty->setEscapeHtml(false);
  

• Twig 模板引擎：

  {{ var|raw }}  {# 禁用转义 #}
  

（2）修改 ShowDoc 的 PHP 源码

找到 server/Application/Home/Controller/ItemController.class.php（或类似文件），检查是否有 htmlspecialchars() 或 htmlentities() 调用，例如：

// 错误：强制转义
$content = htmlspecialchars($content, ENT_QUOTES);

// 修改为：仅在必要时转义，或直接输出
$content = $content;  // 不转义

2. 修改数据库存储逻辑

如果 ShowDoc 在 存储数据到数据库时 就转义了单引号，可以检查：

（1）禁用 magic_quotes_gpc（旧版 PHP）

在 php.ini 中确保：

magic_quotes_gpc = Off

（但现代 PHP 版本已移除该选项）

（2）修改 addslashes() 或 PDO::quote() 调用

检查是否有类似代码：

$content = addslashes($content);  // 转义单引号

改为：

$content = $content;  // 不主动转义

3. 修改前端 JS 处理逻辑

如果 ShowDoc 在 前端 JavaScript 中处理了数据（如 AJAX 返回），检查是否有：

// 错误：手动转义
let content = response.content.replace(/'/g, "'");

// 修改为：不处理
let content = response.content;

4. 使用 raw 或 htmlspecialchars_decode 输出

如果 ShowDoc 使用了 PHP 输出，可以尝试：

// 错误：默认转义
echo $content;

// 修改为：反转义后输出
echo htmlspecialchars_decode($content);

5. 检查 ShowDoc 插件或扩展

某些 ShowDoc 插件（如 Markdown 解析器）可能会转义字符，例如：

• Parsedown（Markdown 解析器）默认不会转义单引号，但可能被二次处理。
• 自定义过滤器：检查是否有 str_replace("'", "'", $text) 之类的代码。

6. 临时解决方案（前端替换）

如果无法修改源码，可以在 前端 JS 中动态替换：

// 在页面加载后执行
document.addEventListener('DOMContentLoaded', () => {
  document.querySelectorAll('.item-content').forEach(el => {
    el.innerHTML = el.innerHTML.replace(/'/g, "'");
  });
});

总结

推荐步骤

1. 先定位问题：检查是 存储时转义、渲染时转义 还是 前端处理。
2. 优先修改后端：调整模板引擎或 PHP 输出逻辑。
3. 临时前端修复：如果无法改源码，用 JS 替换。