Done with first draft 🚧

Author: unicodeveloper

database/migrations/2020_06_14_000001_create_media_table.php

@@ -0,0 +1,21 @@
+<?php
+
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+class CreateMediaTable extends Migration
+{
+    public function up()
+    {
+        Schema::create('media', function (Blueprint $table) {
+            $table->bigIncrements('id');
+            $table->morphs('medially');
+            $table->text('file_url');
+            $table->string('file_name');
+            $table->string('file_type')->nullable();
+            $table->unsignedBigInteger('size');
+            $table->timestamps();
+        });
+    }
+}

src/CloudinaryServiceProvider.php

@@ -25,6 +25,7 @@ public function boot()
     {
         $this->bootMacros();
         $this->bootResources();
+        $this->bootMigrations();
         $this->bootDirectives();
         $this->bootComponents();
         $this->bootCommands();
@@ -42,6 +43,8 @@ public function register()
         $this->app->singleton(CloudinaryEngine::class, function ($app) {
             return new CloudinaryEngine;
         });
+
+        //$this->app->alias('cloudinary.engine', CloudinaryEngine::class);
     }
 
 
@@ -89,6 +92,20 @@ protected function bootResources()
         $this->loadViewsFrom(__DIR__.'/../resources/views', 'cloudinary');
     }
 
+    /**
+     * Boot the package migrations.
+     *
+     * @return void
+     */
+    protected function bootMigrations()
+    {
+        if ($this->app->runningInConsole()) {
+            $this->loadMigrationsFrom(__DIR__.'/../database/migrations');
+        }
+    }
+
+
+
     /**
      * Boot the package directives.
      *
@@ -121,7 +138,11 @@ protected function bootMacros()
         $engine = new CloudinaryEngine;
 
         UploadedFile::macro('storeOnCloudinary', function ($folder = null) use ($engine) {
-            return $engine->uploadFile($this->getRealPath())->getSecurePath();
+            return $engine->uploadFile($this->getRealPath(), ['folder' => $folder])->getSecurePath();
+        });
+
+        UploadedFile::macro('storeOnCloudinaryAs', function ($folder = null, $publicId = null) use ($engine) {
+            return $engine->uploadFile($this->getRealPath(), ['folder' => $folder, 'public_id' => $publicId])->getSecurePath();
         });
     }
 }

src/MediaAlly.php

@@ -0,0 +1,122 @@
+<?php
+
+namespace Unicodeveloper\Cloudinary;
+
+use Exception;
+use Unicodeveloper\Cloudinary\Model\Media;
+
+
+/**
+ * MediaAlly
+ *
+ * Provides functionality for attaching Cloudinary files to an eloquent model.
+ * Whether the model should automatically reload its media relationship after modification.
+ *
+ *
+ */
+trait MediaAlly
+{
+
+    /**
+     * Relationship for all attached media.
+     */
+    public function medially()
+    {
+        return $this->morphMany(Media::class, 'medially');
+    }
+
+
+    /**
+     * Attach Media Files to a Model
+     */
+    public function attachMedia($file)
+    {
+        if(! file_exists($file)) {
+            throw new Exception('Please pass in a file that exists');
+        }
+
+        $response = resolve(CloudinaryEngine::class)->uploadFile($file->getRealPath());
+
+        $media = new Media();
+        $media->file_name = $response->getFileName();
+        $media->file_url = $response->getSecurePath();
+        $media->size = $response->getSize();
+        $media->file_type = $response->getFileType();
+
+        $this->medially()->save($media);
+    }
+
+    /**
+     * Attach Rwmote Media Files to a Model
+     */
+    public function attachRemoteMedia($remoteFile)
+    {
+        $response = resolve(CloudinaryEngine::class)->uploadFile($remoteFile);
+
+        $media = new Media();
+        $media->file_name = $response->getFileName();
+        $media->file_url = $response->getSecurePath();
+        $media->size = $response->getSize();
+        $media->file_type = $response->getFileType();
+
+        $this->medially()->save($media);
+    }
+
+    /**
+    * Get all the Media files relating to a particular Model record
+    */
+    public function fetchAllMedia()
+    {
+        return $this->medially()->get();
+    }
+
+    /**
+    * Get the first Media file relating to a particular Model record
+    */
+    public function fetchFirstMedia()
+    {
+        return $this->medially()->first();
+    }
+
+    /**
+    * Delete all files associated with a particular Model record
+    */
+    public function detachMedia()
+    {
+
+       $items = $this->medially()->get();
+
+        foreach($items as $item) {
+            resolve(CloudinaryEngine::class)->destroy($item->getFileName());
+        }
+
+        return $this->medially()->delete();
+    }
+
+    /**
+    * Get the last Media file relating to a particular Model record
+    */
+    public function fetchLastMedia()
+    {
+        return $this->medially()->get()->last();
+    }
+
+    /**
+    * Update the Media files relating to a particular Model record
+    */
+    public function updateMedia($file)
+    {
+        $this->detachMedia();
+        $this->attachMedia($file);
+    }
+
+    /**
+    * Update the Media files relating to a particular Model record (Specificially existing remote files)
+    */
+    public function updateRemoteMedia($file)
+    {
+        $this->detachMedia();
+        $this->attachRemoteMedia($file);
+    }
+
+}

src/Model/Media.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace Unicodeveloper\Cloudinary\Model;
+
+use Illuminate\Support\Facades\Facade;
+use Unicodeveloper\Cloudinary\CloudinaryEngine;
+
+use Carbon\Carbon;
+use Illuminate\Contracts\Filesystem\Filesystem;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\MorphToMany;
+use Illuminate\Database\Eloquent\Relations\Pivot;
+use Illuminate\Database\Eloquent\SoftDeletingScope;
+
+class Media extends Model
+{
+
+    protected $table = 'media';
+
+    /**
+    * Create the polymorphic relation.
+    *
+    * @return \Illuminate\Database\Eloquent\Relations\MorphTo
+    */
+    public function medially()
+    {
+        return $this->morphTo();
+    }
+
+    /**
+    * Get the file url / path of a Media File
+    * @return string
+    */
+    public function getSecurePath()
+    {
+        return $this->file_url;
+    }
+
+    /**
+    * Get the file name of a Media File
+    * @return string
+    */
+    public function getFileName()
+    {
+        return $this->file_name;
+    }
+
+    /**
+    * Get the mime type of a Media File
+    * @return string
+    */
+    public function getFileType()
+    {
+        return $this->file_type;
+    }
+
+    /**
+    * Get the Size of a Media File
+    * @return Integer
+    */
+    public function getSize()
+    {
+        return $this->size;
+    }
+
+    /**
+     * Get the Readable Size of a Media File
+     * @return string
+     */
+    public function getReadableSize()
+    {
+        return resolve(CloudinaryEngine::class)->getHumanReadableSize($this->size);
+    }
+}