php UEditor百度编辑器安装与使用方法分享

先说说UEditor这个百度出品的富文本编辑器，在PHP项目中用得挺多。它的安装部署其实并不复杂，跟着步骤走，几分钟就能搞定。下面咱们就一步步来看。

一、官网上下载完整源码包，解压到任意目录，解压后的源码目录结构如下所示：

_examples：编辑器完整版的示例页面

_demos：编辑器的各种使用案例

dialogs：弹出对话框对应的资源和JS文件

themes：样式图片和样式文件

server：涉及到服务器端操作的PHP、JSP等文件

third-party：第三方插件

editor_all.js：_src目录下所有文件的打包文件

editor_all_min.js：editor_all.js文件的压缩版，建议在正式部署时才采用

editor_config.js：编辑器的配置文件，建议和编辑器实例化页面置于同一目录

二、部署UEditor到实际项目（UETest）中的步骤：

第一步：在项目的任一文件夹中建立一个用于存放UEditor相关资源和文件的目录，此处在项目根目录下建立，起名为ueditor。

第二步：拷贝源码包中的dialogs、themes、third-party、editor_all.js和editor_config.js到ueditor文夹中。其中，除了ueditor目录之外的其余文件均为具体项目文件，此处所列仅供示例。

第三步：为简单起见，此处将以根目录下的index.php页面作为编辑器的实例化页面，用来展示UEditor的完整版效果。在index.php文件中，首先导入编辑器需要的三个入口文件，示例代码如下：

第四步：然后在index.php文件中创建编辑器实例及其DOM容器。具体代码示例如下：

最后一步：在编辑器实例的顶部加上如下代码：

上面的是用的相对路径，也可以使用相对于网站根目录的绝对路径，如：

建议使用相对于网站根目录的绝对路径。

至此，一个完整的编辑器实例就已经部署到咱们的项目中了！

最后一步也可以通过修改以下地方来实现（不建议不懂js的人员使用）：

在/UETest/ueditor/ editor_config.js中查找"URL= window.UEDITOR_HOME_URL||"并修改为相应路径，当然如果修改这里的话，window.UEDITOR_HOME_URL就不用在实例页面设置了。

//强烈推荐以这种方式进行绝对路径配置URL= window.UEDITOR_HOME_URL||"/UETest/ueditor/";

三、具体使用

1. 提交编辑器内容至后端

场景一：在编辑器所在的Form中存在提交按钮，提交动作由点击此按钮完成。

这是最普通的场景，没什么特别需要注意的，不过有几点说明：

1) 默认情况下提交到后台的表单名称是 “editorValue”，在editor_config.js中可以配置，参数名为textarea。

2) 可以在容器标签（即script标签）上设置name属性，以覆盖editor_config.js中的默认配置。实例代码如下，此处的myContent将成为新的提交表单名称：

3）后端接收程序可以通过如下几种方式来获取编辑器中的富文本内容。

//PHP获取：$_POST["myContent"]   //JSP获取：request.getParameter("myContent");   //ASP获取：request("myContent");   //NET获取:context.Request.Form["myContent"];

场景二：编辑器所在的Form中不存在提交按钮，提交动作由外部事件触发。

这种场景在站点前端交互较多时比较常见，核心要点是在触发form提交动作之前，先执行编辑器内容同步操作。一般的代码模式如下：

//满足提交条件时同步内容并提交，此处editor为编辑器实例if(editor.hasContent()){ //此处以非空为例 editor.sync();  //同步内容 someForm.submit(); //提交Form}

这里的editor是编辑器实例对象。

场景三：编辑器不在任何Form中，提交动作由外部事件触发。

这个场景用得不多，但特殊时候可能会需要。UEditor提供了对应的处理方案，基本逻辑跟场景二一样，只是执行同步操作时需要传入提交form的id，比如editor.sync(myFormID)即可。其他操作同场景二。

2. 从数据库读取内容

这里采用script标签作为编辑器容器对象，并设置类型为纯文本，这样既能避免标签内部JS代码执行，也解决了使用传统textarea标签时可能带来的额外转码问题。

3. 编辑器内容初始化（即往编辑器中设置富文本）

写新文章时，经常需要在编辑器中预置一些提示或问候内容。在editor_config.js文件中找到initialContent参数，设置其值为需要的提示或问候语即可，比如initialContent:'欢迎使用UEditor!'。

4. 图片上传

如果是新站，图片路径采用编辑器本身的路径，那就无需更改。但如果老站已经有自己的图片文件夹，则需要修改ueditor/php文件夹中的相关文件。