PbootCMS V3.2.27 版本更新公告

PbootCMS V3.2.27 版本已正式发布。本次更新将前后台 jQuery 从 1.12.4 升级至 3.7.1，前台默认模板的 bootstrap-fileinput 上传组件从 4.4.7 升级至 5.5.4，修复旧版本已知安全漏洞并兼容现代浏览器；后台系统日志页新增蜘蛛日志与 AI 日志分页签查看，AI 调用日志归档到 data/log/ai 并按年月分目录；同时修复会员中心上传回调重复执行、PHP 8 下无顶级栏目时 {pboot:nav} 整页报错等问题。本次涉及 jQuery 大版本升级与前台模板文件变更，二次开发站点请按下方注意事项核对后升级。

一、功能升级与调整
序号 功能 更新说明
1 后台 jQuery 升级 后台 jQuery 由 1.12.4 升级至 3.7.1，修复旧版本已知安全漏洞并兼容现代浏览器；内容编辑页的置顶、推荐、头条复选框在 Layui 2.13 下保持块状标签外观。
2 前台 jQuery 升级 前台默认模板 jQuery 由 1.12.4 升级至 3.7.1，模板 head.html 引用路径同步更新为 js/jquery-3.7.1.min.js。
3 前台上传组件升级 前台默认模板 bootstrap-fileinput 由 4.4.7 升级至 5.5.4，主题目录调整为 explorer-fa4 与 fa4，移除不再使用的 DOMPurify 死文件；upload.html 已按新版组件重写初始化逻辑。
4 系统日志页签化 后台 系统 → 系统日志 新增“蜘蛛日志”与“AI 日志”页签，可按年、月、日直接在后台查看 data/log 下的文本日志，无需再登录服务器翻文件。
5 AI 调用日志归档 AI 调用日志由 runtime/log/ai_YYYYMMDD.log 迁移到 data/log/ai，并按年、年月分目录存放，写入时加文件锁，与蜘蛛日志、系统日志归档方式保持一致。

二、功能问题修复

会员中心上传：修复上传弹窗多次打开后上传回调被重复绑定，导致失败提示重复弹出、上传异常的问题；每个弹窗的上传按钮只绑定一次，且只作用于所在弹窗的文件框。

{pboot:nav} PHP 8 报错：修复 PHP 8 环境下没有启用的顶级栏目、但存在启用子栏目时，{pboot:nav} 触发 TypeError 导致前台整页报错的问题。

三、升级建议与注意事项

本次更新涉及前后台 jQuery 大版本升级及前台模板文件变更，不涉及数据库结构调整。升级前请务必备份网站文件、数据库及自定义模板；升级完成后建议清理系统缓存与浏览器缓存，并检查后台页面交互、前台页面脚本、会员上传及导航输出是否正常。

升级注意

后台二次开发：jQuery 3.x 已移除 .live()、.size()、.andSelf()、$(document).on(‘ready’) 等旧 API。自定义或二开过后台页面并依赖上述写法的站点，请升级后逐页检查控制台报错并按新版 API 调整。

前台模板不会被在线升级覆盖：在线升级不会改动 template 目录，本版前台 jQuery 与 fileinput 升级只随全包生效。使用自定义模板的站点，可继续沿用模板内原有 jQuery，不受影响；如需同步升级，请从全包中复制 template/default/js/jquery-3.7.1.min.js、template/default/fileinput 目录及 html/comm/head.html、html/comm/upload.html 并自行合并。

前台上传组件主题：fileinput 5.5.4 的主题目录由 explorer-fa、fa 改为 explorer-fa4、fa4，且需在 fileinput.js 加载后显式声明 $.fn.fileinputBsVersion。自行改造过 upload.html 的站点请参照默认模板调整引用。

AI 日志目录变更：新 AI 调用日志写入 data/log/ai，原 runtime/log 下的历史 AI 日志不会自动迁移，可按需自行归档后删除。请确认 data 目录访问拒绝规则已生效，避免日志文件被直接下载。

方式一：后台在线升级（推荐）：支持跨版本升级，系统将自动完成代码升级，操作路径：后台 → 系统 → 在线升级。

方式二：全包升级：下载最新版本源码包，保留 config、data、static、template 目录，其余文件用新版全部替换；本版无数据库变更，若从 V3.2.25 及更早版本跨版本升级，请对照 /script/ 目录下中间版本的 SQL 升级脚本手动执行。

如升级过程中遇到问题，欢迎前往官方社区或提交 Issue 反馈，我们会第一时间响应处理。