本文实例讲述了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="https://www.atool.online/article/{{asset('ueditor-mz/ueditor.config.js')}}"></script> <!-- 编辑器源码文件 --> <script type="text/javascript" src="https://www.atool.online/article/{{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"
所传输的数据写入数据库即可,而对应在数据库中存储的数据如下所示:
②. 当取得了上述数据,若要在前端进行显示,需要执行类似的转化代码:
echo htmlspecialchars_decode($article['content']);
四、扩展学习
♩. 图片上传路径
-
其实,如果只是个简单的小网站或者学生的课设项目,无需修改,上传的图片会默认放置在
Public/ueditor/php/upload/image/
目录下 -
如果需要修改,可进入
php/config.json
文件,找到配置项"imagePathFormat"
进行符合需求的修改,建议可以让文件名较长一些以避免重名:
[注]:
个人初始测试发现,文件命名时的“{rand:6}”定义无法实现,网上却没有类似的解决方法,解决方案请参考后面的 ***【附录】***.
♪. 图片访问前缀
-
如果使用了多个服务器,设置统一的图片访问前缀极有必要,可配置参数“imageUrlPrefix”,例如我的配置路径可以为:“http://lar5Pro.com”
-
这样一来,存入数据库中的图片路径都会加上了此前缀.
五、附录
♭. 图片文件名 {rand:$num}
解决
- 刚开始想到使用时间戳加文件原名称来作为名字,但是当有中文字符时无法上传。
- 其实原本的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相关内容感兴趣的读者可查看本站专题:《Laravel框架入门与进阶教程》、《php优秀开发框架总结》、《php面向对象程序设计入门教程》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》
希望本文所述对大家基于Laravel框架的PHP程序设计有所帮助。