Download the PHP package coding-socks/laravel-upload-handler without Composer
On this page you can find all versions of the php package coding-socks/laravel-upload-handler. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download coding-socks/laravel-upload-handler
More information about coding-socks/laravel-upload-handler
Files in coding-socks/laravel-upload-handler
Package laravel-upload-handler
Short Description This package helps integrate a Laravel application with chunk uploader libraries eg. DropzoneJS and Resumable.js
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-upload-handler
Laravel Upload Handler
Upload Handler Package For Laravel
This package helps integrate a Laravel application with chunk uploader libraries eg. DropzoneJS and jQuery-File-Upload from blueimp.
Uploading a large file in chunks can help reduce risks.
- PHP from 5.3.4 limits the number of concurrent uploads and by uploading a file in one request can limit the availability of a service. (max_file_uploads)
- For security reasons many systems limit the payload size, and the uploadable file size. PHP is not an exception. (upload_max_filesize)
- It can be useful to check the meta information of a file and decline an upload upfront, so the user does not have to wait for minutes or seconds to upload a large file and then receive an error message for an invalid the file type or mime type.
- Can include resume functionality which means an upload can be continued after a reconnection.
However, there is not a single RFC about chunked uploads and this caused many implementations. The most mature project at the moment is tus.
Similar projects:
- Multiple library support: 1up-lab/OneupUploaderBundle, pionl/laravel-chunk-upload
- Single library support: ankitpokhrel/tus-php, flowjs/flow-php-server, jildertmiedema/laravel-plupload, OneOffTech/laravel-tus-upload
Table of contents
- Installation
- Requirements
- Usage
- Events
- Changing the driver
- Adding your own drivers
- Drivers
- Monolith
- Blueimp
- DropzoneJS
- Flow.js
- ng-file-upload
- Plupload
- Resumable.js
- simple-uploader.js
- Identifiers
- Session identifier
- Auth identifier
- NOP identifier
- Contribution
- License
Installation
You can easily install this package using Composer, by running the following command:
Requirements
This package has the following requirements:
- PHP
^7.3 - Laravel
^6.10 || ^7.0 || ^8.0
Usage
-
Register a route
-
Retrieve the upload handler. (The chunk upload handler can be retrieved from the container in two ways.)
-
Using dependency injection
- Resolving from the app container
-
The handler exposes the following methods:
| Method | Description |
|---|---|
handle |
Handle the given request |
"Handle" is quite vague but there is a reason for that. This library tries to provide more functionality than just saving the uploaded chunks. It is also adds functionality for resumable uploads which depending on the client side library can differ very much.
Events
Once a file upload finished a \CodingSocks\UploadHandler\Event\FileUploaded is triggered. This event contains
the disk and the path of the uploaded file.
You can also add a Closure as the second parameter of the handle method to add an inline listener. The listener
is called with the disk and the path of the uploaded file.
Changing the driver
You can change the default driver by setting an UPLOAD_DRIVER environment variable or publishing the
config file and changing it directly.
Adding your own drivers
Much like Laravel's core components, you can add your own drivers for this package. You can do this by adding the following code to a service provider.
If you are adding a driver you need to extend the \CodingSocks\UploadHandler\Driver\BaseHandler abstract class, for
which you can use the shipped drivers (e.g. \CodingSocks\UploadHandler\Driver\BlueimpUploadDriver) as an example as to
how.
If you wrote a custom driver that others might find useful, please consider adding it to the package via a pull request.
Drivers
Below is a list of available drivers along with their individual specs:
| Service | Driver name | Chunk upload | Resumable |
|---|---|---|---|
| Monolith | monolith |
no | no |
| Blueimp | blueimp |
yes | yes |
| DropzoneJS | dropzone |
yes | no |
| Flow.js | flow-js |
yes | yes |
| ng-file-upload | ng-file-upload |
yes | no |
| Plupload | plupload |
yes | no |
| Resumable.js | resumable-js |
yes | yes |
| simple-uploader.js | simple-uploader-js |
yes | yes |
Monolith driver
This driver is a fallback driver as it can handle normal file request. Save and delete capabilities are also added.
Blueimp driver
This driver handles requests made by the Blueimp jQuery File Upload client library.
DropzoneJS driver
This driver handles requests made by the DropzoneJS client library.
Flow.js driver
This driver handles requests made by the Flow.js client library.
Because of Issue #44 you must use forceChunkSize
option.
ng-file-upload driver
This driver handles requests made by the ng-file-upload client library.
Plupload driver
This driver handles requests made by the Plupload client library.
Resumable.js driver
This driver handles requests made by the Resumable.js client library.
Because of Issue #44 you must use forceChunkSize
option.
simple-uploader.js driver
This driver handles requests made by the simple-uploader.js client library.
Because of Issue #44 you must use forceChunkSize
option.
Identifiers
In some cases an identifier is needed for the uploaded file when the client side library does not provide one. This identifier is important for resumable uploads as the library has to be able to check the status of the given file for a specific client. Without the identifier collisions can happen.
| Service | Driver name |
|---|---|
| Session identifier | session |
| Auth identifier | auth |
| NOP identifier | nop |
Session identifier
This identifier uses the client session and the original file name to create an identifier for the upload file.
Auth identifier
This identifier uses the id of the authenticated user and the original file name to create an identifier for the upload file.
It will throw UnauthorizedException when the user is unauthorized. However, it is still recommended using the auth middleware.
NOP identifier
This identifier uses the original file name to create an identifier for the upload file. This does not abstract the file identifier which can be useful for testing.
Contribution
All contributions are welcomed for this project, please refer to the CONTRIBUTING.md file for more information about contribution guidelines.
License
This product is licensed under the MIT license, please refer to the License file for more information.
All versions of laravel-upload-handler with dependencies
illuminate/support Version ^9.0 || ^10.0 || ^11.0
illuminate/http Version ^9.0 || ^10.0 || ^11.0