juice/attachments

Juice Attachments Plugin.

0.0.2 2020-07-27 06:12 UTC

Requires

• php: ^7.2
• hashids/hashids: ~3.0|~4.0
• illuminate/cache: ~5.7|~6.0|~7.0|~8.0
• illuminate/console: ~5.7|~6.0|~7.0|~8.0
• illuminate/database: ~5.7|~6.0|~7.0|~8.0
• illuminate/filesystem: ~5.7|~6.0|~7.0|~8.0
• illuminate/support: ~5.7|~6.0|~7.0|~8.0
• intervention/image: ~2.4
• ralouphie/mimey: ~2.0

Requires (Dev)

• ext-json: *
• mockery/mockery: ~1.2
• orchestra/testbench: ~3.7|~4.0|~5.0
• phpunit/phpunit: ~7.4|~8.0|~9.0

proprietary

• laravel
• attachments
• lumen
• juice.codes

README

Provide attachment controller and just use it in your application routes. We take care rest of things.

Installation

1. run composer require command composer require juice/attachments

2. register \Juice\Attachments\AttachmentsServiceProvider::class service provider

3. copy config file and set it up

   • Laravel - php artisan vendor:publish --provider="Juice\Attachments\AttachmentsServiceProvider"

   • Lumen - cp vendor/juice/attachments/config/juice-attachments.php config/

     (make sure config directory exist)

4. run setup command php artisan attachment:setup

5. run database migration php artisan migrate

6. setup your application routes

7. done

Controller Methods

＊：Assume route namespace is \Juice\Attachments\Controllers

Upload Attachments

• end point

  AttachmentController@upload

• method parameters

  none

• query string

  none

• form data

  field	type	required
  ja_file[]	array of files	✓

• return value

  array of successfully uploaded files' name, e.g.

  ["sjdwd.png", "pweog.pdf", "msptw.jpeg"]

• route example

  Route::post('/attachments', 'AttachmentController@upload');

Download Attachment

• end point

  AttachmentController@download

• method parameters

  field	type	required
  $filename	string	✓

• query string

  field	type	required	default	remark
  d	boolean		0	true: attachment false: inline

• form data

  none

• return value

  Symfony\Component\HttpFoundation\BinaryFileResponse

• route example

  Route::get('/attachments/{id}', 'AttachmentController@download'); // https://example.com/attachments/sjdwd.png

Trash Attachment

• end point

  AttachmentController@trash

• method parameters

  field	type	required
  $filename	string	✓

• query string

  none

• form data

  none

• return value

  json response contain success key, e.g.

  {
      "success": true
  }

• route example

  Route::delete('/attachments/{id}', 'AttachmentController@trash'); // https://example.com/attachments/sjdwd.png