Add events.

Author: overtrue

.gitignore

@@ -4,3 +4,4 @@
 sftp-config.json
 .subsplit
 .php_cs.cache
+composer.lock

README.md

@@ -76,6 +76,45 @@ $ composer require "overtrue/laravel-ueditor:~1.0"
 
 > 七牛的 `access_key` 和 `secret_key` 可以在这里找到：https://portal.qiniu.com/user/key ,在创建 `bucket` （空间）的时候，推荐大家都使用公开的空间。
 
+# 事件
+
+你肯定有一些朋友肯定会有一些比较特殊的场景，那么你可以使用本插件提供的事件来支持：
+
+> 请按照 Laravel 事件的文档来使用：
+> https://laravel.com/docs/5.4/events#registering-events-and-listeners
+
+## 上传中事件
+
+> Overtrue\LaravelUEditor\Events\Uploading
+
+在保存文件之前，你可以拿到一些信息：
+
+- `$event->file` 这是请求的已经上传的文件对象，`Symfony\Component\HttpFoundation\File\UploadedFile` 实例。
+- `$event->filename` 这是即将存储时用的新文件名
+- `$event->config` 上传配置，数组。
+
+你可以在本事件监听器返回值，返回值将替换 `$filename` 作为存储文件名。
+
+## 上传完成事件
+
+> Overtrue\LaravelUEditor\Events\Uploaded
+
+它有两个属性：
+
+- `$event->file` 与 Uploading 一样，上传的文件
+- `$event->result` 上传结构，数组，包含以下信息：
+
+   ```php
+   'state' => 'SUCCESS',
+   'url' => 'http://xxxxxx.qiniucdn.com/xxx/xxx.jpg',
+   'title' => '文件名.jpg',
+   'original' => '上传时的源文件名.jpg',
+   'type' => 'jpg',
+   'size' => 17283,
+   ```
+
+你可以监听此事件用于一些后续处理任务，比如记录到数据库。
+
 # License
 
 MIT

src/Events/Uploaded.php

@@ -0,0 +1,47 @@
+<?php
+
+/*
+ * This file is part of the overtrue/laravel-ueditor.
+ * (c) overtrue <i@overtrue.me>
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Overtrue\LaravelUEditor\Events;
+
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+use Symfony\Component\HttpFoundation\File\UploadedFile;
+
+/**
+ * Class Uploading.
+ *
+ * @author overtrue <i@overtrue.me>
+ */
+class Uploaded
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * @var \Symfony\Component\HttpFoundation\File\UploadedFile
+     */
+    public $file;
+
+    /**
+     * @var array
+     */
+    public $result;
+
+    /**
+     * Uploaded constructor.
+     *
+     * @param \Symfony\Component\HttpFoundation\File\UploadedFile $file
+     * @param array                                               $result
+     */
+    public function __construct(UploadedFile $file, array $result)
+    {
+        $this->file = $file;
+        $this->result = $result;
+    }
+}

src/Events/Uploading.php

@@ -0,0 +1,54 @@
+<?php
+
+/*
+ * This file is part of the overtrue/laravel-ueditor.
+ * (c) overtrue <i@overtrue.me>
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Overtrue\LaravelUEditor\Events;
+
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+use Symfony\Component\HttpFoundation\File\UploadedFile;
+
+/**
+ * Class Uploading.
+ *
+ * @author overtrue <i@overtrue.me>
+ */
+class Uploading
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * @var \Symfony\Component\HttpFoundation\File\UploadedFile
+     */
+    protected $file;
+
+    /**
+     * @var string
+     */
+    protected $filename;
+
+    /**
+     * @var array
+     */
+    protected $config;
+
+    /**
+     * Uploading constructor.
+     *
+     * @param \Symfony\Component\HttpFoundation\File\UploadedFile $file
+     * @param                                                     $filename
+     * @param array                                               $config
+     */
+    public function __construct(UploadedFile $file, $filename, array $config)
+    {
+        $this->file = $file;
+        $this->filename = $filename;
+        $this->config = $config;
+    }
+}

src/StorageManager.php

@@ -12,6 +12,8 @@
 use Illuminate\Contracts\Filesystem\Filesystem;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Storage;
+use Overtrue\LaravelUEditor\Events\Uploaded;
+use Overtrue\LaravelUEditor\Events\Uploading;
 use Symfony\Component\HttpFoundation\File\UploadedFile;
 
 /**
@@ -59,7 +61,9 @@ public function upload(Request $request)
 
         $filename = $this->getFilename($file, $config);
 
-        $this->store($file, $filename);
+        $modifiedFilename = event(new Uploading($file, $filename, $config));
+
+        $this->store($file, !is_null($modifiedFilename) ? $modifiedFilename : $filename);
 
         $response = [
             'state' => 'SUCCESS',
@@ -70,6 +74,8 @@ public function upload(Request $request)
             'size' => $file->getSize(),
         ];
 
+        event(new Uploaded($file, $response));
+
         return response()->json($response);
     }