非常完整 PHPCMS v9整合百度编辑器UEditor步骤

作者：袖梨 2022-06-25

所有写文章的乐趣会被一个蹩脚的ckeditor打消，PC论坛多次呼声官方替换默认的编辑器为UEditor，但是至今没下文，百度一大堆整合1.2几版的，基于程序员的用新版的强迫症，还是觉得自己搞一搞。

具体记录如下,并不定期更新。

在此之前的教程可能不适用最新版本的百度编辑器，他多次升级很多地方也改了，包括一些主要js文件名，所有看准了下手。

1、下载官方的最新版的，我这里使用的是UEditor 1.4.2 php版的，下载本地后解压，新建一个目录uediter （ps：一定得是这个名称吗，最好是这个后面不用改什么配置），把解压后的文件主目录里文件全复制到目录uediter。

2、把目录uediter整个上传到网站/statics/js/目录下，如图：

3、修改配置ueditor.config.js编辑器高度，去掉高宽前面的注释。

变更为：
,initialFrameWidth:655 //初始化编辑器宽度,默认1000
,initialFrameHeight:400 //初始化编辑器高度,默认320

这里补充说明下，网上之前教程都需要修改

window.UEDITOR_HOME_URL = “/statics/js/ueditor/”;

var URL = window.UEDITOR_HOME_URL || getUEBasePath();

但是从我目前实践来看，新版本好像不需要再设置了，缘由后面的getUEBasePath();函数能自动获取编辑器的根目录路径了。

4、修改/statics/js/ueditor/php/config.json为如下：

代码如下

复制代码

/* 前后端通信相关的配置,注释只允许使用多行方式 */
{
    /* 上传图片配置项 */
    "imageActionName": "uploadimage", /* 执行上传图片的action名称 */
    "imageFieldName": "upfile", /* 提交的图片表单名称 */
    "imageMaxSize": 2048000, /* 上传大小限制，单位B */
    "imageAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], /* 上传图片格式显示 */
    "imageCompressEnable": true, /* 是否压缩图片,默认是true */
    "imageCompressBorder": 1600, /* 图片压缩最长边限制 */
    "imageInsertAlign": "none", /* 插入的图片浮动方式 */
    "imageUrlPrefix": "", /* 图片访问路径前缀 */
    "imagePathFormat": "/uploadfile/{yyyy}/{mm}{dd}/{yyyy}{mm}{dd}{rand:6}", /* 上传保存路径,可以自定义保存路径和文件名格式 */
                                /* {filename} 会替换成原文件名,配置这项需要注意中文乱码问题 */
                                /* {rand:6} 会替换成随机数,后面的数字是随机数的位数 */
                                /* {time} 会替换成时间戳 */
                                /* {yyyy} 会替换成四位年份 */
                                /* {yy} 会替换成两位年份 */
                                /* {mm} 会替换成两位月份 */
                                /* {dd} 会替换成两位日期 */
                                /* {hh} 会替换成两位小时 */
                                /* {ii} 会替换成两位分钟 */
                                /* {ss} 会替换成两位秒 */
                                /* 非法字符＼ : * ? " < > | */
                                /* 具请体看线上文档: fex.baidu.com/ueditor/#use-format_upload_filename */

    /* 涂鸦图片上传配置项 */
    "scrawlActionName": "uploadscrawl", /* 执行上传涂鸦的action名称 */
    "scrawlFieldName": "upfile", /* 提交的图片表单名称 */
    "scrawlPathFormat": "/uploadfile/{yyyy}/{mm}{dd}/{time}{rand:6}", /* 上传保存路径,可以自定义保存路径和文件名格式 */
    "scrawlMaxSize": 2048000, /* 上传大小限制，单位B */
    "scrawlUrlPrefix": "", /* 图片访问路径前缀 */
    "scrawlInsertAlign": "none",

    /* 截图工具上传 */
    "snapscreenActionName": "uploadimage", /* 执行上传截图的action名称 */
    "snapscreenPathFormat": "/uploadfile/{yyyy}/{mm}{dd}/{time}{rand:6}", /* 上传保存路径,可以自定义保存路径和文件名格式 */
    "snapscreenUrlPrefix": "", /* 图片访问路径前缀 */
    "snapscreenInsertAlign": "none", /* 插入的图片浮动方式 */

    /* 抓取远程图片配置 */
    "catcherLocalDomain": ["127.0.0.1", "localhost", "img.baidu.com"],
    "catcherActionName": "catchimage", /* 执行抓取远程图片的action名称 */
    "catcherFieldName": "source", /* 提交的图片列表表单名称 */
    "catcherPathFormat": "/uploadfile/{yyyy}/{mm}{dd}/{yyyy}{mm}{dd}{rand:6}", /* 上传保存路径,可以自定义保存路径和文件名格式 */
    "catcherUrlPrefix": "", /* 图片访问路径前缀 */
    "catcherMaxSize": 2048000, /* 上传大小限制，单位B */
    "catcherAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], /* 抓取图片格式显示 */

    /* 上传视频配置 */
    "videoActionName": "uploadvideo", /* 执行上传视频的action名称 */
    "videoFieldName": "upfile", /* 提交的视频表单名称 */
    "videoPathFormat": "/uploadfile/{yyyy}/{mm}{dd}/{yyyy}{mm}{dd}{rand:6}", /* 上传保存路径,可以自定义保存路径和文件名格式 */
    "videoUrlPrefix": "", /* 视频访问路径前缀 */
    "videoMaxSize": 102400000, /* 上传大小限制，单位B，默认100MB */
    "videoAllowFiles": [
        ".flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg",
        ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid"], /* 上传视频格式显示 */

    /* 上传文件配置 */
    "fileActionName": "uploadfile", /* controller里,执行上传视频的action名称 */
    "fileFieldName": "upfile", /* 提交的文件表单名称 */
    "filePathFormat": "/uploadfile/{yyyy}/{mm}{dd}/{yyyy}{mm}{dd}{rand:6}", /* 上传保存路径,可以自定义保存路径和文件名格式 */
    "fileUrlPrefix": "", /* 文件访问路径前缀 */
    "fileMaxSize": 51200000, /* 上传大小限制，单位B，默认50MB */
    "fileAllowFiles": [
        ".png", ".jpg", ".jpeg", ".gif", ".bmp",
        ".flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg",
        ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid",
        ".rar", ".zip", ".tar", ".gz", ".7z", ".bz2", ".cab", ".iso",
        ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt", ".md", ".xml"
    ], /* 上传文件格式显示 */

    /* 列出指定目录下的图片 */
    "imageManagerActionName": "listimage", /* 执行图片管理的action名称 */
    "imageManagerListPath": "/uploadfile/", /* 指定要列出图片的目录 */
    "imageManagerListSize": 20, /* 每次列出文件数量 */
    "imageManagerUrlPrefix": "", /* 图片访问路径前缀 */
    "imageManagerInsertAlign": "none", /* 插入的图片浮动方式 */
    "imageManagerAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"], /* 列出的文件类型 */

    /* 列出指定目录下的文件 */
    "fileManagerActionName": "listfile", /* 执行文件管理的action名称 */
    "fileManagerListPath": "/uploadfile/", /* 指定要列出文件的目录 */
    "fileManagerUrlPrefix": "", /* 文件访问路径前缀 */
    "fileManagerListSize": 20, /* 每次列出文件数量 */
    "fileManagerAllowFiles": [
        ".png", ".jpg", ".jpeg", ".gif", ".bmp",
        ".flv", ".swf", ".mkv", ".avi", ".rm", ".rmvb", ".mpeg", ".mpg",
        ".ogg", ".ogv", ".mov", ".wmv", ".mp4", ".webm", ".mp3", ".wav", ".mid",
        ".rar", ".zip", ".tar", ".gz", ".7z", ".bz2", ".cab", ".iso",
        ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".pdf", ".txt", ".md", ".xml"
    ] /* 列出的文件类型 */

}

主要修改上传的路径符合phpcms的路径规则，修改后的规则如下：

/uploadfile/{yyyy}/{mm}{dd}/{yyyy}{mm}{dd}{rand:6}

记得将原来的{time}修改为{yyyy}{mm}{dd}否则上传文件名是时间戳形式，而不是具体的数字时间。

5、修改/phpcms/libs/classes下的form.class.php

修改原来的

代码如下

复制代码

if(!defined('EDITOR_INIT')) {
            $str = '';
            define('EDITOR_INIT', 1);
        }

为

if(!defined('EDITOR_INIT')) {
        $str .= '';
        $str .= '';
        $str .= '';
        $str .= '';
        define('EDITOR_INIT', 1);}
        $str .= "';

6、进phpcms 后台更新缓存，ok，完成，经测试上传图片，多图上传，附件上传都正常，其他细节完善待续。

BUG修改及功能完善：
1、解决编辑器浮动在发布按钮上方的问题。

phpcms-ueditor

修改＼statics＼css＼zh-cn-system.css 下.fixed-bottom .fixed-but{}属性，添加z-index: 2000;

2、修复上传图片及附件后在phpcms后台附件管理处看不到记录及无法管理的BUG

（待完善补充）

3、修改文章发布页面编辑器自适应宽度。/statics/js/ueditor/themes/default/css/ueditor.css

代码如下	复制代码
/UI工具栏、编辑区域、底部/ .edui-default .edui-editor { border: 1px solid #d4d4d4; background-color: white; position: relative; overflow: visible; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; width: auto !important; 增加此行，强制自适应 }