Laravel框架集成UEditor编辑器的方法图文与实例详解

本文实例讲述了Laravel框架集成UEditor编辑器的方法。分享给大家供大家参考，具体如下：

一、 背景

• 在项目开发的过程中，免不了使用修改功能，而富文本编辑器是极为方便的一种推荐，当然，个人认为 MarkDown 更为简单，但是感觉暂时只适合程序猿
• 此文介绍如何在 Laravel5.5 框架中集成使用富文本编辑器 UEditor

ps : 其实编辑器只是一个工具，举一反三可以用在各种代码语言或框架中

二、 探讨

• 通过网上求知，发现主要有两种方法实现

①. 第一种是使用 composer 进行安装，可推荐参考文章 Laravel-u-editor，个人试过，无法上传图片 …

②. 第二种是到 UEditor 官方下载源包自行配置（下文主要为此操作）

• ps : [如果有哪位能够成功实现第一种方案，请告诉鄙人一下，万分感谢！]

三、操作步骤

❶. 下载对应的源码包

• 可点击进入下载地址，本人下载的是最新 PHP(UTF-8) 版本

❷. 放置在 Public 目录下

• 将解压后的文件夹，放置在 Public 目录下，本人只是将文件夹名字改动了一下.

❸. 前端文件配置

• 详情可参考 官方文档
  以本人为例：

①. 首先在当前页面，需要引入 js 文件，注意类比src的正确引用.

<!-- ueditor-mz 配置文件 -->
<script type="text/javascript" src="{{asset('ueditor-mz/ueditor.config.js')}}"></script>
<!-- 编辑器源码文件 -->
<script type="text/javascript" src="{{asset('ueditor-mz/ueditor.all.js')}}"></script>
<!-- 实例化编辑器 -->
<script type="text/javascript">
 var ue = UE.getEditor('ue-container');
 ue.ready(function(){
  ue.execCommand('serverparam', '_token', '{{ csrf_token() }}');
 });
</script>

②. 在需要显示富文本编辑器的位置，补充如下代码

<!-- 加载编辑器的容器 -->
<script id="ue-container" name="content" type="text/plain">
@php
echo htmlspecialchars_decode($article['content']);
@endphp
</script>
<!-- 上述的 php 代码是根据实际需求进行的编写，该处为初始化内容的位置-->

③. 实现效果如下：

❹. 补充

①. 在进行 form 表单提交时，将获得 name="content" 所传输的数据写入数据库即可，而对应在数据库中存储的数据如下所示：

<p><strong style="white-space: normal; padding: 0px; margin: 0px;">        <span style="color: rgb(51, 51, 51);"></span></strong><span style="color: rgb(51, 51, 51);">开场后，第<strong>32秒</strong>，佩顿在朗多投篮时犯规，送给鹈鹕2次罚球机会。第1分35秒，考辛斯妙传，朱-霍勒迪三分远投命中。</span></p><p><span style="color: rgb(51, 51, 51);">        第7分28秒，佩顿手滑丢球，被考辛斯抢断。鹈鹕对篮板发起疯狂进攻，本节共抢下16个篮板，包括6个前场篮板，其中戴维斯一人就贡献4个篮板球。</span></p><p style="text-align: center;"><img src="http://lar5Pro.com/upload/image/20171227/NjUzNDczMDc3ODU2.jpg" title="NjUzNDczMDc3ODU2.jpg" alt="article_3.jpg" width="906" height="450"/><br/></p>

②. 当取得了上述数据，若要在前端进行显示，需要执行类似的转化代码：

echo htmlspecialchars_decode($article['content']);

③. 在富文本编辑器中，图片的大小可自行调整.

四、扩展学习

♩. 图片上传路径

• 其实，如果只是个简单的小网站或者学生的课设项目，无需修改，上传的图片会默认放置在 Public/ueditor/php/upload/image/ 目录下

• 如果需要修改，可进入php/config.json 文件，找到配置项 "imagePathFormat" 进行符合需求的修改,建议可以让文件名较长一些以避免重名:

[注]:
个人初始测试发现，文件命名时的“{rand:6}”定义无法实现,网上却没有类似的解决方法，解决方案请参考后面的 ***【附录】***.

♪. 图片访问前缀

• 如果使用了多个服务器，设置统一的图片访问前缀极有必要，可配置参数“imageUrlPrefix”，例如我的配置路径可以为：“http://lar5Pro.com”

• 这样一来，存入数据库中的图片路径都会加上了此前缀.

五、附录

♭. 图片文件名 {rand:$num} 解决

1. 刚开始想到使用时间戳加文件原名称来作为名字，但是当有中文字符时无法上传。
2. 其实原本的ThinkPHP框架中也集成过UEditor，但是没有这种问题，通过阅读源码，找到正则表达式的匹配位置 Public/ueditor-mz/php/Uploader.class.php

• 大概在 304 行左右，原因是rand() 取值太大可能导致部分环境报错

• 个人觉得数字的命名不如字母好些，于是代码替换为如下的样子：

//TODO 替换随机字符串 数值太大可能导致部分环境报错
$randNum = rand(100000, 10000000) . rand(100000, 10000000);
//也可用使用md5()或两者的组合
$randNum = base64_encode($randNum);

♫. 呵呵

• 真是尴尬了，方案一测试多遍依然不成功，所以钟情于第二种方案 …
• HELP ！HELP！HELP！

【补充问题】（2018-02-06）：

emm楼主第一种上传不了图片的问题我当时也遇到过，最后发现是接口路径没配置好。在laravl-u-editor 目录下 ueditor.config.js文件 中修改33行左右的 serverUrl，改成对应的路径即可。

这个问题，可以参考 相应文章的提示，下次有机会可以尝试一番…

希望本文所述对大家基于Laravel框架的PHP程序设计有所帮助。