datingvip / codeguy-upload
Handle file uploads with extensible validation and storage strategies
1.3.4
2023-02-14 08:45 UTC
Requires
- php: >=5.3.0
- ext-fileinfo: *
Requires (Dev)
- phpunit/phpunit: 3.7.*
This package is auto-updated.
Last update: 2024-10-14 12:37:29 UTC
README
This component simplifies file validation and uploading.
Usage
Assume a file is uploaded with this HTML form:
<form method="POST" enctype="multipart/form-data"> <input type="file" name="foo" value=""/> <input type="submit" value="Upload File"/> </form>
When the HTML form is submitted, the server-side PHP code can validate and upload the file like this:
<?php $storage = new \Upload\Storage\FileSystem('/path/to/directory'); $file = new \Upload\File('foo', $storage); // Optionally you can rename the file on upload $new_filename = uniqid(); $file->setName($new_filename); // Validate file upload // MimeType List => http://www.iana.org/assignments/media-types/media-types.xhtml $file->addValidations(array( // Ensure file is of type "image/png" new \Upload\Validation\Mimetype('image/png'), //You can also add multi mimetype validation //new \Upload\Validation\Mimetype(array('image/png', 'image/gif')) // Ensure file is no larger than 5M (use "B", "K", M", or "G") new \Upload\Validation\Size('5M') )); // Access data about the file that has been uploaded $data = array( 'name' => $file->getNameWithExtension(), 'extension' => $file->getExtension(), 'mime' => $file->getMimetype(), 'size' => $file->getSize(), 'md5' => $file->getMd5(), 'dimensions' => $file->getDimensions() ); // Try to upload file try { // Success! $file->upload(); } catch (\Exception $e) { // Fail! $errors = $file->getErrors(); }
How to Install
Install composer in your project:
curl -s https://getcomposer.org/installer | php
Require the package with composer:
php composer.phar require codeguy/upload
Author
License
MIT Public License