PbootCMS V3.2.29 版本更新公告

PbootCMS V3.2.29 版本已正式发布。本次更新将内置 UEditorPlus 编辑器前端资源升级至 v4.5.0，抓取远程图片支持配置本地域名白名单；后台 Font Awesome 由 4.7.0 升级至 6.7.2，标题颜色选择改用 Layui colorpicker，多图排序改用 SortableJS，栏目与菜单树形展开改为自有实现，移除 jscolor、dragsort 与 jquery.treetable；内置 Excel 读取扩展替换为 SimpleXLSX 1.1.19。同时修复前台并发访问偶发空白页、并发建目录失败、多分页列表变量错乱及栏目 URL 名称含下划线时分页 404 等问题。本次 Excel 读取扩展不再支持 .xls 文件，后台移除了多个旧版前端组件，二次开发过后台页面或调用过 Excel 读取扩展的站点，请按下方注意事项核对后升级。

一、功能升级与调整
序号 功能 更新说明
1 UEditorPlus 升级 内置编辑器 UEditorPlus 前端资源升级至 v4.5.0，弹窗内错误提示改用 Layui 消息框；抓取远程图片时支持通过本地域名白名单跳过本站及可信域名的图片，并修复简单上传失败时回调不生效的问题。
2 后台 Font Awesome 升级 后台 Font Awesome 由 4.7.0 升级至 6.7.2，改用 all.min.css，并加载官方 v4-shims.min.css 兼容层，后台原有 fa fa-xxx 写法的图标可继续显示。
3 标题颜色选择器 内容新增与修改页的标题颜色改用 Layui 内置 colorpicker，支持点击输入框直接取色，手动输入 6 位十六进制颜色值时同步更新取色器；移除旧版 jscolor。
4 多图拖动排序 内容与单页的多图拖动排序改用 SortableJS，拖动更流畅且带动画效果，移除旧版 jquery.dragsort。
5 栏目与菜单树形展开 后台栏目管理与菜单管理的树形展开/收缩改为系统自有实现，移除 jquery.treetable 脚本与样式。
6 Excel 读取扩展替换 内置 Excel 读取扩展（core/extend/excel）由旧版 Spreadsheet_Excel_Reader 替换为 SimpleXLSX 1.1.19，提升对现代 .xlsx 文件的解析兼容性；不再支持 .xls 文件读取。

二、功能问题修复

前台并发空白页：修复前台高并发访问时，配置缓存、模板编译文件或页面缓存被其他请求读到空文件或半截文件，导致偶发空白、截断页面，且残缺页面可能被写入缓存的问题；相关缓存文件现改为原子替换写入。

并发建目录失败：修复 PHP 8.1 以下多进程并发递归创建多级目录时偶发失败，导致访问计数丢失、日志写入失败的问题。

多分页列表变量错乱：修复同一页面存在多个分页列表时，分页常量重复定义报错、分页变量被后一个列表覆盖，以及后一个列表沿用前一个列表起始偏移的问题。

栏目 URL 名称含下划线分页 404：修复栏目自定义 URL 名称包含下划线时，列表分页提示页面不存在的问题；后台新建栏目遇 URL 名称重复时，自动追加的后缀改为短横线连接。

三、升级建议与注意事项

本次更新主要涉及后台前端组件、编辑器与核心缓存写入机制，不涉及数据库结构调整。升级前请务必备份网站文件与数据库；升级完成后建议清理系统缓存与浏览器缓存，并检查后台内容编辑（编辑器、标题颜色、多图排序）、栏目与菜单树形展开、前台列表分页是否正常。

*重要——升级注意!

Excel 读取不再支持 .xls：core/extend/excel 下的 excelreader.php、oleread.php 已移除，类 Spreadsheet_Excel_Reader 不再可用。二次开发中调用过该扩展的站点，请改用 core\extend\excel\SimpleXLSX::parse() 读取 .xlsx 文件，原有 .xls 文件需先另存为 .xlsx。

远程抓图白名单配置：本地域名白名单在 core/extend/ueditor/php/config.json 的 catcherLocalDomain 中配置，白名单内域名的图片不会被抓取到本地。该文件不在在线升级的保留目录内，自行改过该文件的站点升级后请重新核对并补回自定义配置。

后台旧组件已移除：jscolor.js、jquery.dragsort-0.5.2.min.js、jquery.treetable.js 与 jquery.treetable.css 已删除。二次开发过后台页面并引用了这些文件或 jscolor 类名、.treetable()、.dragsort() 调用的，请参照默认后台模板改用 Layui colorpicker 与 SortableJS。

后台 Font Awesome 路径变化：后台 Font Awesome 样式由 font-awesome/css/font-awesome.min.css 改为 font-awesome/css/all.min.css，字体目录由 fonts 改为 webfonts。自定义后台页面单独引用了旧样式文件的，请同步调整路径；图标类名可继续使用旧写法。

编辑器自定义改动：UEditorPlus 的 ueditor.all.js、ueditor.config.js 及 webuploader 等资源已整体更新，旧版 webuploader 的 flashonly、html5only 等变体文件已移除。自行改造过编辑器源码或配置的站点，请在升级后重新合并改动。

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

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