riverslei/laravel-ueditor

支持laravel5的UEditor,同时支持本地与七牛文件上传

Installs: 409

Dependents: 0

Suggesters: 0

Stars: 13

Watchers: 0

Forks: 2

Open Issues: 0

Language:JavaScript

v1.1.0 2015-06-30 04:06 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 下面配置对应的中文语言包