larva/laravel-ueditor

为 Laravel 集成的 UEditor。

1.0.1 2021-03-09 02:44 UTC

This package is auto-updated.

Last update: 2024-09-09 10:21:23 UTC


README

为 Laravel 集成的 UEditor。基于超哥的 Laravel-UEditor 修改。

使用

视频教程:https://www.laravist.com/series/awesome-laravel-packages/episodes/7

安装

$ composer require "larva/laravel-ueditor:~1.0"

配置

  1. 将以下行添加到 config/app.phpproviders 部分:

    Larva\UEditor\UEditorServiceProvider::class,
  2. 发布配置文件与资源

    $ php artisan vendor:publish --provider='Larva\UEditor\UEditorServiceProvider'
  3. 模板引入编辑器

    这行的作用是引入编辑器所需的 css、js 等文件,因此您无需手动引入。

    @include('vendor.ueditor.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. 请不要忘记执行 php artisan storage:link
  2. 如果您使用的是 Laravel 5.3 以下版本,请先创建软链接:
    # 请在项目根目录执行以下命令
    $ ln -s `pwd`/storage/app/public `pwd`/public/storage
  3. config/ueditor.php 中将 disk 配置为 'public' 时,上传路径位于:public/uploads/,请确保该目录存在并可写。
  4. 如果要修改上传路径,请在 config/ueditor.php 中配置各种类型的上传路径,但它们都在 public 目录下。
  5. 请在 .env 中正确配置 APP_URL 为您的当前域名,否则可能上传成功但无法正确显示。

七牛支持

如果您想使用七牛云存储,需要进行以下几个简单的操作:

1.安装和配置 laravel-filesystem-qiniu

2.将 config/ueditor.phpdisk 配置为 qiniu

'disk' => 'qiniu'

3.接下来时间打局 LOL,已经完事了。

七牛的 access_keysecret_key 可以在这里找到:https://portal.qiniu.com/user/key,在创建 bucket(空间)时,建议大家使用公开的空间。

事件

您肯定有一些朋友肯定会有一些比较特殊的场景,那么你可以使用本插件提供的事件来支持:

请按照 Laravel 事件的文档来使用: https://laravel.net.cn/docs/5.4/events#registering-events-and-listeners

上传中事件

Larva\UEditor\Events\Uploading

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

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

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

上传完成事件

Larva\UEditor\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,

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

许可证

MIT