Baidu UEditor for Laravel 5
A laravel 5 package of UEditor,which is an open source WYSIWYG editor maintained by Baidu FE team, (*1)
这个package主要是为了方便自己的项目，本打算找个现成的，参考了现有的两个package，但是考虑到能否有长期的更新维护和灵活性的问题，
再考虑到自己也曾是Baidu FE UEditor Team的一员(只待了3周就被调走:D)，最终还是决定自己打包一个。, (*2)
示例演示
先上个demo再说，ueditor for laravel5, (*3)
请不要乱传图片，我服务器很脆弱的，谢了啊。, (*4)
由于开了登陆检查，所以未登录的话上传图片功能还是不可用的，登陆之后就正常了。, (*5)
顺便打个广告，喜欢旅游的可以聊聊，搞搞基什么的，有兴趣也可以参与到项目中来，交流下看法，思路也可以的。, (*6)
参考列表
主要参考了stevenyangecho/laravel-u-editor，能用的基本上都是直接拿过来用的，部分按自己的喜好调整了下，里面有用到七牛存储的代码，虽然目前项目中没有用到，
暂时也保留了下来，如果以后用到可以省点事。
另外这个貌似图片上传有问题，应该就是路由的问题，下面会提到。, (*7)
对以上作者表示感谢。, (*8)
Install
Via Composer, (*9)
``` bash
$ composer require "ender/laravel-ueditor:0.8.*", (*10)
有时候可能忘了修改这里的版本号，尽量安装最新稳定版。
## Usage
首先在laravel 配置文件app.php中增加对应的provider和alias
```php
'Ender\UEditor\UEditorServiceProvider'
'UEditor' => 'Ender\UEditor\UEditor'
然后在你的项目根目录执行, (*11)
php artisan vendor:publish --provider='Ender\UEditor\UEditorServiceProvider'
UEditor所需要的资源文件、配置文件会分别发布到对应目录，之后你可以根据需要修改这些文件，当然也可以使用默认配置, (*12)
你也可以选择通过tag参数指明只发布特定内容，如, (*13)
php artisan vendor:publish --provider='Ender\UEditor\UEditorServiceProvider' --tag=config
为了方便，共分为config js css dialog third_party lang theme 七个tag，除了third_party最好是全部发布，除非你真的很想用自己的替换掉默认的, (*14)
如果有了较大的改动需要强制覆盖已有的内容可以加上--force 参数, (*15)
php artisan vendor:publish --provider='Ender\UEditor\UEditorServiceProvider' --force
所有的资源文件会发布到/public/ueditor 目录下,由于文件量比较大，如果不希望加入git，可以在.gitignore里面加一行 /public/ueditor, (*16)
php部分增加了lang的配置，会发布到默认的lang目录下，目前包括en zh_Cn zh_TW, (*17)
基本配置文件包括一个php的配置文件ueditor.php,会发布到laravel的默认config目录中
前端的config.js会跟其他前端资源文件一样发布到/public/ueditor目录下, (*18)
前端部分的使用可以参考UEditor官方文档，这里不再赘述, (*19)
为了方便，定义了几个辅助方法, (*20)
{!! UEditor::css() !!} 输出UEditor的css
{!! UEditor::content() !!}
{!! UEditor::js() !!}
实例化编辑器js代码
<script type="text/javascript">
var ue = UE.getEditor('ueditor'); //用辅助方法生成的话默认id是ueditor
/* 自定义路由 */
/*
var serverUrl=UE.getOrigin()+'/ueditor/test'; //你的自定义上传路由
var ue = UE.getEditor('ueditor',{'serverUrl':serverUrl}); //如果不使用默认路由，就需要在初始化就设定这个值
*/
ue.ready(function() {
ue.execCommand('serverparam', '_token', '{{ csrf_token() }}');
});
</script>
至此一个可用的编辑器已经有了，注意ue.execCommand是用来提交csrf token 参数的，这是laravel的特殊需要，不是UEditor本身的需要。, (*21)
图片、视频等的上传
默认的处理上传的route是/ueditor/server，可以通过修改config.js的serverUrl值来修改这个值，, (*22)
注意：, (*23)
UEditor官方文档此值为, (*24)
serverUrl: URL + "xxx"
这里改成了, (*25)
serverUrl: origin+"ueditor/server"
区别在于去掉了前面的URL变量,换成了origin,加了 getOrigin 这个函数,否则图片上传时向server发出的请求会多出当前页面的path部分，
导致route不对，无法完成图片等的上传。这样处理之后就可以基于域名自由定义route了。, (*26)
图片、视频等的默认上传目录为是在ueditor.php的配置文件中设定的，以图片为例具体配置项是, (*27)
"imagePathFormat" => "/uploads/ueditor/image/{yyyy}{mm}{dd}/{time}{rand:6}",
这里做了一点调整，UEditor官方的默认路径是/uploads/ueditor/php/upload/image/{yyyy}{mm}{dd}/{time}{rand:6},路径比较深，
我们这里只针对php，所以去掉了php/upload 这两层。, (*28)
上传路径大家可以根据需要自行修改，另外要保证你的public目录有写权限。, (*29)
ueditor.php配置文件中的可以指定middleware来进行认证授权等的检查，默认是auth,大部分情况下是需要登陆才能上传文件的。, (*30)
多编辑器实例与多上传路径
很多时候多个功能都需要用到编辑器，又要求不同的编辑器实例把图片等上传到不同的目录下，为了满足这种需要，config.php中增加了upload_routes_config_map节点，
用来设定不同的上传路由与不同的上传配置节点的对应关系。, (*31)
每个路由可以有自己的配置，也可以多个路由共享一个配置节点，配置节点数量可根据需要自行增加，上传路由的设定由config.js的serverUrl决定，有个默认值，
如果要使用不同的上传路由可以在编辑器初始化时设定,之后把自定义的route加入到这里，并制定对应的配置节点，如此便可以方便的支持不同的编辑器实例上传到不同的目录。, (*32)
如何指定自定义路由？, (*33)
var serverUrl=UE.getOrigin()+'/ueditor/test'; //你的自定义上传路由
var ue = UE.getEditor('ueditor',{'serverUrl':serverUrl}); //如果不使用默认路由，就需要在初始化就设定这个值
存储图片名称，路径，用户等信息到数据库
'storage' => true,
Change log
Please see CHANGELOG for more information what has changed recently., (*34)
Testing
bash
$, (*35)
Contributing
Please see CONTRIBUTING for details., (*36)
Security
If you discover any security related issues, please email :author_email instead of using the issue tracker., (*37)
Credits
License
The MIT License (MIT). Please see License File for more information., (*38)
Wallogit.com
