PHPCMS v9.5.6 整合 UEditor 1.4.2 完整配置指南

版本對應

• PHPCMS v9.5.6
• UEditor 1.4.2 PHP UTF-8 版
• 下載：官網

整合步驟

1. 文件部署

# 解壓重命名為 ueditor
# 放入 PHPCMS
statics/js/ueditor/

2. 修改上傳路徑配置 (關鍵：適配 PHPCMS 規則)

編輯 statics/js/ueditor/php/config.json：

// 原路徑格式
/ueditor/php/upload/image/{yyyy}{mm}{dd}/{time}{rand:6}

// 改為 PHPCMS 風格
/phpcms/uploadfile/{yyyy}/{mm}{dd}/{yyyy}{mm}{dd}{rand:6}

// 列表目錄同步修改
"imageManagerListPath": "/phpcms/uploadfile/",
"fileManagerListPath": "/phpcms/uploadfile/"

3. 前端配置優化

編輯 statics/js/ueditor/ueditor.config.js：

// 工具欄精簡 (按需保留)
toolbars: [[
    'fullscreen', 'source', '|',
    'undo', 'redo', '|',
    'bold', 'italic', 'underline', 'strikethrough', '|',
    'forecolor', 'backcolor', '|',
    'insertorderedlist', 'insertunorderedlist', '|',
    'link', 'unlink', '|',
    'simpleupload', 'insertimage', 'insertvideo', 'attachment', '|',
    'inserttable', 'deletetable', '|',
    'preview', 'searchreplace', 'help'
]],

// 編輯器尺寸
initialFrameWidth: 700,
initialFrameHeight: 350,

4. 核心整合：修改 form.class.php

文件：phpcms/libs/classes/form.class.php

// 找到編輯器初始化邏輯，替換為 UEditor
if (!defined('EDITOR_INIT')) {
    $str .= '<script type="text/javascript" src="'.JS_PATH.'ueditor/ueditor.config.js"></script>';
    $str .= '<script type="text/javascript" src="'.JS_PATH.'ueditor/ueditor.all.js"></script>';
    $str .= '<script type="text/javascript" src="'.JS_PATH.'ueditor/ueditor.parse.js"></script>';
    $str .= '<link rel="stylesheet" href="'.JS_PATH.'ueditor/themes/default/css/ueditor.css"/>';
    define('EDITOR_INIT', 1);
}

$str .= "<script type=\"text/javascript\">\r\n";
$str .= "var editor = UE.getEditor('$textareaid');";
$str .= '</script>';

5. CSS 修復：編輯器自適應寬度

statics/js/ueditor/themes/default/css/ueditor.css

/* UI工具欄、編輯區域、底部樣式 */
.edui-default .edui-editor-iframeholder {
    width: auto !important; /* 新增：自適應容器寬度 */
}

6. 移除多餘「子標題」區塊

刪除 form.class.php 中 $ext_str 相關代碼 (約 30 行)，含 page_title_div 表格結構。

7. 解決固定底部按鈕遮擋編輯器

statics/css/zh-cn-system.css

.fixed-bottom .fixed-but {
    z-index: 2000; /* 確保按鈕在編輯器上層 */
}

驗證清單

• 後台內容發布頁編輯器正常加載
• 工具欄按鈕功能正常 (上傳圖片/視頻/附件)
• 上傳文件落入 phpcms/uploadfile/年/月日/ 目錄
• 編輯器寬度隨容器自適應，無橫向滾動條
• 固定發布按鈕不遮擋編輯器底部

遷移建議

UEditor 已停止維護 (百度 2016 年停更)。新項目建議：

• CKEditor 5：現代架構、模塊化、TypeScript、活躍社區
• TinyMCE 6：商業級、功能全、付費高級功能
• TipTap：Headless、Vue/React 深度整合、基於 ProseMirror

老項目維護用此方案，新項目請選現代編輯器。