sanlilin/laravel-ueditor-plus

集成ueditor-plus

2.0.6 2023-05-30 09:54 UTC

Requires

• php: ^7.3|^8.0
• predis/predis: ^2.0

MIT

• 王宏彬

README

UEditor integration for Laravel 5.

安装

```shell
$ composer require "sanlilin/laravel-ueditor-plus"
```

配置

1. 添加下面一行到 config/app.php 中 providers 部分：

   Sanlilin\LaravelUEditorPlus\UEditorPlusServiceProvider::class,

2. 发布配置文件与资源

   $ php artisan vendor:publish --provider='Sanlilin\LaravelUEditorPlus\UEditorPlusServiceProvider'

3. 模板引入编辑器

   这行的作用是引入编辑器需要的 css,js 等文件，所以你不需要再手动去引入它们。

   @include('vendor.ueditor-plus.assets')

4. 编辑器的初始化

   <!-- 实例化编辑器 -->
   <script type="text/javascript">
       var ue = UE.getEditor('container');
       ue.ready(function() {
           ue.execCommand('serverparam', '_token', '{{ csrf_token() }}'); // 设置 CSRF token.
       });
   </script>
   
   <!-- 编辑器容器 -->
   <script id="container" name="content" type="text/plain"></script>

说明

1. laravel5+ 请不要忘记 php artisan storage:link
2. 在 config/ueditor-plus.php 配置 disk 为 'public' 情况下，上传路径在：public/uploads/ 下，确认该目录存在并可写。
3. 如果要修改上传路径，请在 config/ueditor-plus.php 里各种类型的上传路径，但是都在 public 下。
4. 请在 .env 中正确配置 APP_URL 为你的当前域名，否则可能上传成功了，但是无法正确显示。

S3支持

1. 配置 config/ueditor-plus.php 的 disk 为 s3:

'disk' => 's3'

事件

上传中

Sanlilin\LaravelUEditorPlus\Events\Uploading

在保存文件之前，你可以拿到一些信息：

• $event->file 这是请求的已经上传的文件对象，Symfony\Component\HttpFoundation\File\UploadedFile 实例。
• $event->filename 这是即将存储时用的新文件名
• $event->config 上传配置，数组。

你可以在本事件监听器返回值，返回值将替换 $filename 作为存储文件名。

上传完成

Sanlilin\LaravelUEditorPlus\Events\Uploaded

它有两个属性：

• $event->file 与 Uploading 一样，上传的文件

• $event->result 上传结构，数组，包含以下信息：

  'state' => 'SUCCESS',
  'url' => 'http://xxxxxx.qiniucdn.com/xxx/xxx.jpg',
  'title' => '文件名.jpg',
  'original' => '上传时的源文件名.jpg',
  'type' => 'jpg',
  'size' => 17283,

你可以监听此事件用于一些后续处理任务，比如记录到数据库。

License

MIT