riverslei / laravel-ueditor
支持laravel5的UEditor,同时支持本地与七牛文件上传
Installs: 410
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 0
Forks: 3
Open Issues: 0
Language:JavaScript
Requires
- php: >=5.4.0
- ext-fileinfo: *
- illuminate/support: 5.0.*|5.1.x
- qiniu/php-sdk: 7.0.*
This package is auto-updated.
Last update: 2024-10-29 03:48:20 UTC
README
UEditor是由百度web前端研发部开发所见即所得富文本web编辑器 本项目,是为了支持laravel5,使用的UEditor是php版本的1.4.3 支持本地和七牛云存储(在配置文件中配置),默认为本地上传 public/uploads
修改日志
- 增加配置文件配置说明及七牛云存储使用说明
- v1.1.0 增加了测试视图文件,修改了head视图错误路径
- v1.0.1 修改了其中路径错误,将其中所有幻数全部使用常量
- v1.0.0 依据参考项目,实现了功能
重要提示
本项目,受益并参考于stevenyangecho/laravel-u-editor项目。 而我,仅仅是做了锦上添花的事情
增加及修改功能
- 项目需要Fileinfo的支持,因此将此约束明文写进composer。(请大家在使用laravel5进行文件上传操作时,打开php.ini中的此扩展)
- 在riverslei\laravel-ueditor\resources\public\themes目录下,补充了iframe.css内容,使之能够将上传的图片,自适应屏幕
- 修改了对于项目不是部署于根目录时,上传图片回显路径不正确
- 将配置文件命名为:ueditor.php,并在其中新增变量baseurl,以及对部分变量的说明
安装
前提条件: php版本>=5.4,项目已安装composer,将php.ini中的extension=php_fileinfo.dll前分号去掉
"riverslei/laravel-ueditor": "*"
然后运行composer install或者composer update
安装完成后,打开config/app.php配置服务提供者
Riverslei\UEditor\UEditorServiceProvider::class,
最后记得运行
php artisan vendor:publish
配置文件说明
若以上安装没问题,自定义项目配置文件会在 config/ueditor.php (会自动生成)
'core' => [ 'route' => [ // 'middleware' => 'auth', ], 'mode'=>'local',//上传方式,local 为本地 qiniu 为七牛 'baseurl'=>'http://localhost/llaravel/public',// 设置网站的根路由(可访问到index.php的路由) //七牛配置,若mode='qiniu',以下为必填. 'qiniu'=>[ 'accessKey'=>'',// 可在七牛中查看到 'secretKey'=>'',// 可在七牛中查看到 'bucket'=>'',// 使用的七牛空间名称 'url'=>'http://xxxx.qiniucdn.com',//七牛分配的CDN域名,注意带上http:// ] ],
middleware 相当重要,请根据自己的项目设置,比如如果在后台使用,请设置为后台的auth middleware.
如果是单纯本机测试,请将
// 'middleware' => 'auth',
直接注释掉,如果留 'middleware'=>''
空值,会产生bug,原因不详.
所有UEditor 的官方资源,会放在 public/laravel-ueditor/ ,可以根据自己的需求,更改.(我已重新写了iframe.css,已让上传的内容自适应)
这里需要重点说明的是 core.baseurl
这个配置项,必须正确配置,否则上传的图片路径无法正确显示,当然如果使用七牛,这个可留空不做设置
如何使用测试文件
执行完以后步骤后,会在resources/views/vendor/UEditor中看到test.blade.php文件, 现在需要做以下几步操作
- 写一个控制器,在里边添加显示该视图的操作,我使用HomeController,代码
public function index() { return view('vendor.UEditor.test'); }
- 添加路由,访问该控制器
Route::get('/', 'HomeController@index');
- 在浏览器中运行项目的根目录,即可。
注意
- 这里UEditor界面显示的语言文件,与
config/app.php
中的locale
相关,默认显示为英文,请将其修改为'locale' => 'zh-CN'
。同时,请在resources/lang
下面配置对应的中文语言包