Download the PHP package struktal/struktal-file-uploads without Composer
On this page you can find all versions of the php package struktal/struktal-file-uploads. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package struktal-file-uploads
File Upload Handler for PHP
This is a helper library for PHP that helps to process uploaded files.
PHP stores uploaded files in the $_FILES
array. However, this array is not very trivial to use for multiple file uploads. This library provides an easy way to check whether a file upload should be allowed and to get the files in a more convenient way.
Installation
To install this library, include it in your project using composer:
Usage
Upload a single file
The following example shows how to allow the upload of a single file. Let's assume you have a form with a file input named `fileInputName`: In your PHP script that is called when the form is submitted, use the `FileUpload` class to check whether the file upload should be allowed and to get the uploaded files: If the file upload was successful, the `$uploadedFile` will be an array with the following structure:Upload multiple files
The following example shows how to allow the upload of multiple files. Let's assume you have a form with a file input named `fileInputName`, with the `multiple` attribute set: In your PHP script that is called when the form is submitted, use the `FileUpload` class to check whether the file upload should be allowed and to get the uploaded files: If the file upload was successful, the `$uploadedFiles` will be an array with the following structure:File upload options
The following options can be set for the file upload: | Option | Description | Default | |------------------------------------------------|------------------------------------------------|-------------------------------------| | `setInputName(string $inputName)` | Sets the name of the file input. | - | | `setMultiple(bool $multiple)` | Sets whether multiple files should be allowed. | `false` | | `setAllowedMimeTypes(array $allowedMimeTypes)` | Sets the allowed mime types. | `[]` (All uploads will be rejected) | | `setMaxSize(int $maxSize)` | Sets the maximum size of the file in MiB. | `∞` (No maximum size) |Upload errors
You can check whether there were errors during the file upload with the `successful()` method. It returns `true` if there were no errors and `false` if there was at least one error. Errors that occur during the file upload can be retrieved with the `getErrors()` method. It returns them as Enum values of the `UploadError` class. There are the following errors: | Error | Code | Description | |---------------------------|------|----------------------------------------------------------------------------------------| | `UPLOAD_ERR_NOT_UPLOADED` | `0` | The file was not uploaded via HTTP POST or the PHP upload error is not `UPLOAD_ERR_OK`. | | `UPLOAD_ERR_TYPE` | `1` | The file type is not allowed. | | `UPLOAD_ERR_SIZE` | `2` | The file size is too large. | | `UPLOAD_ERR_MULTIPLE` | `3` | Multiple files were uploaded, but only a single file is allowed. |All versions of struktal-file-uploads with dependencies
PHP Build Version
Package Version
Requires
php Version
>=8.1.0
The package struktal/struktal-file-uploads contains the following files
Loading the files please wait ....