Download the PHP package sirmekus/elu without Composer
On this page you can find all versions of the php package sirmekus/elu. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package elu
Short Description Simple and easy file uploader for Laravel-based apps
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 elu
Elu
Elu is a Laravel-powered file uploader that leaverages on the existing strength of Laravel's strong validation to add power to an exisitng web app. One of the additional benefits include enforcing (or constraining) image dimension. For instance, imagine your application expects image dimension to be 300/300px (height/width) and a user uploads an image with a dimension of 500/200px. Strictly constraining the dimension (using traditional approach) may result in low quality and a not-too-nice image. This library takes care of this effectively without sacrificing quality of the uploaded image.
Please note that this package is not limited to image upload; It takes care of any type of file upload in general - pdf, doc, audio, video, image, etc.
Installation
To get started all you need to do is:
Once installed you may publish the package's elu config file which you can then customise to your taste by running:
Please note that this package stores uploaded files/images in the
storagefolder and expects that symbolic link must have already been created. If you haven't, no problem. Simply run:
That's all.
Elu, in Igbo language, means "Up"; I bet you know how the name relates to this package now...#winks.
Usage
Receiving/Accepting file/image from client
Example:
Just that single line of code is what is needed to use this package. The package assumes the name (parameter) of the incoming file from the client is image. If it isn't then you can specify the name as the first argument. Example:
It doesn't matter if the file is an array or a single file, the package takes care of that, stores the uploaded file in disk and returns the new file name. If an array was detected the returned value will be an array containing the uploaded file names else a string that contains the file which you will want to save in the database.
You can set the configuration during runtime (if you choose to not use the configuration settings at any point in time) or overwrite the public properties of the class. The properties are:
-
docParentFolder: This is typically the public directory in the storage folder. If you want the file to be saved outside this directory then specify it in the configuration file or overwrite this property. -
sub_folder: In thedocParentFolderfolder if there is another folder there where you'll like the image to be uploaded you can specify it here. You can specify it as like a file path (subfolder/path/folder) or just a single entry like (subfolder). -
width: The allowed width for this image. -
height: The allowed height for this image. -
valid_mimes: The allowed mime types for this image. -
max_file_upload_size: The max allowed size for this image in bytes. -
max_no_of_file_to_upload: The maximum number of file that can be uploaded for this image. This is useful if your users can upload multiple images. name_of_file: If specified, instead of randomly generated names this particular name will be used to rename the file. Be careful when setting this cause in a case of multiple file upload the files may be overwritten.
By default the upload() method checks if the specified key exists in the incoming request and is filled. If it is not it throws an error. In certain cases image upload may be optional, thus the application should still continue with the request processing. To enable this the method takes a second argument that suppresses the error. Example
or, if you use use PHP 8.0 and above and the parameter name from the request is image.
Displaying the image
Because the file is stored in the storage directory and a symbolic link has already been created you can simply do (in your blade file):
Or, if the image is saved in a sub-directory (in storage/public/):
Deleting Image/File
To delete an image it follows the same logic and configuration as if uploading the image/file. Simply pass the image/file name(s) - string or array - to the remove() method and the job is done. Example:
Meanwhile
You can connect with me on LinkedIn for insightful tips and so we can grow our networks together.
Patronise us on Webloit.
And follow me on Twitter.
I encourage contribution even if it's in the documentation. Thank you, and I really hope you find this package helpful.
