PHP集成百度Ueditor 1.4.3
下载安装
1.首先到官网下载最新版的UE1.4.3
UE官方下载地址:http://ueditor.baidu.com/website/download.html#ueditor
这里我下载的是1.4.3PHP版本。下载你所使用的版本就行。
解压文件到你的项目
2.部署.在前端Html页面引入UE 所需的JS文件,然后使用getEditor 实例化
<body> <!-- 加载编辑器的容器 --> <script id="container" name="content" type="text/plain"> 这里写你的初始化内容 </script> <!-- 配置文件 --> <script type="text/javascript" src="ueditor.config.js"></script> <!-- 编辑器源码文件 --> <script type="text/javascript" src="ueditor.all.js"></script> <!-- 实例化编辑器 --> <script type="text/javascript"> var ue = UE.getEditor('container'); </script> </body>
浏览你的页面,即可见Ueditor 。是不是很简单的说。
配置Ueditor
UEditor 的配置项分为两类:前端配置项 和 后端配置项。
前后端的配置统一写在后端(PHP版本的config在php/config.json),编辑器实例化时,异步读取后端配置信息,覆盖到前端的配置里。
后端获取的配置项 > 实例化传入的配置项 > ueditor.config.js文件的配置项
前端配置项:官方提供了两种配置方法,静态配置、动态配置。
静态配置:即配置ueditor 目录下的 ueditor.config.js 具体配置项就参考 http://fex-team.github.io/ueditor/#start-config
动态配置:即在实例化UE的时候,通过动态传入配置参数。
var ue = UE.getEditor('container', { //这里写你的自定义配置项 toolbars: [ ['fullscreen', 'source', 'undo', 'redo', 'bold'] ], autoHeightEnabled: true, autoFloatEnabled: true });
后端配置项:
在这里先说一下UE的请求:UE所有的操作都是通过get方式请求serverUrl传递action变量的值来进行下一步操作。获取配置、上传图片、获取图片等等其它的操作。
UE默认是通过读取目录下的ueditor.config.js 中的serverUrl 参数然后通过get方法传递action=config来获取后端的配置项的。默认请求是:serverUrl?action=config 来获取配置项的。serverUrl 可以在前端页面动态配置和ueditor.config.js静态配置都是可以的。
你可以测试你的网站下的路径 ueditor/php/controller.php?action=config 是否正常返回了json格式(其它格式也可以,具体请看官方文档)的后端配置内容,格式大致如下。如果这个请求出错,出现400、500等错误,编辑器上传相关的功能将不能正常使用。
{ "imageUrl": "http://localhost/ueditor/php/controller.php?action=uploadimage", "imagePath": "/ueditor/php/", "imageFieldName": "upfile", "imageMaxSize": 2048, "imageAllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"] "其他配置项...": "其他配置值..." }
集成
前面已经说过了UE所有的操作都是通过get方式请求serverUrl传递action变量的值来进行下一步操作。获取配置、上传图片、获取图片等等其它的操作。了解了这一点,对于集成PHP。或者其它的语言都很简单了。具体代码可以参考官方提供的Demo。
htmlspecialchars_decode() 函数把预定义的 HTML 实体转换为字符。
会被解码的 HTML 实体是:
- & 解码成 & (和号)
- " 解码成 " (双引号)
- ' 解码成 ' (单引号)
- < 解码成 < (小于)
- > 解码成 > (大于)
htmlspecialchars_decode() 函数是 htmlspecialchars() 函数的反函数。
把预定义的 HTML 实体转换为字符:
<?php $str = "Bill & 'Steve'"; echo htmlspecialchars_decode($str, ENT_COMPAT); // 只转换双引号 echo "<br>"; echo htmlspecialchars_decode($str, ENT_QUOTES); // 转换双引号和单引号 echo "<br>"; echo htmlspecialchars_decode($str, ENT_NOQUOTES); // 不转换任何引号 ?>
以上代码的 HTML 输出如下(查看源代码):
<!DOCTYPE html> <html> <body> Bill & 'Steve'<br> Bill & 'Steve'<br> Bill & 'Steve' </body> </html>