From e4d550e8980c8f33a90d8f66fc190fc37ef9cb42 Mon Sep 17 00:00:00 2001 From: iamdual Date: Sun, 24 Jul 2022 12:15:00 +0300 Subject: [PATCH] update readme --- README.md | 56 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 29 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index c4fe2c3..ec6d315 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ Safe, simple and useful file upload class for PHP 5.4+ ### Installing ``` -composer require iamdual/uploader +composer require iamdual/uploader "^0.2.0" ``` ### Examples @@ -45,33 +45,35 @@ if (isset($_FILES["file"])) { More examples in the "[examples](/examples)" directory. ### Methods -| Name | Description | -|---|---| -| `allowed_extensions(array $extensions)` | Allowed file extensions (example: png, gif, jpg) | -| `disallowed_extensions(array $extensions)` | Disallowed file extensions (example: html, php, dmg) | -| `allowed_types(array $types)` | Allowed mime types (example: image/png, image/jpeg) | -| `disallowed_types(array $types)` | Disallowed mime types | -| `max_size(int $size)` | Maximum file size (as MB) | -| `min_size(int $size)` | Minimum file size (as MB) | -| `override()` | Override the file with the same name | -| `path(string $path)` | Set the path where files will be uploaded | -| `name(string $name)` | Rename the uploaded file (example: foo) | -| `encrypt_name()` | Encrypt file name to hide the original name | -| `must_be_image()` | Check the file is image | -| `max_dimensions(int $width, int $height)` | Maximum image dimensions | -| `min_dimensions(int $width, int $height)` | Minimum image dimensions | -| `aspect_ratios(array $aspect_ratios)` | Image aspect ratios that has to be (example: 1:1, 4:3, 16:9) | -| `error_messages(array $errors)` | Custom error messages | +| Name | Description | +|--------------------------------------------|--------------------------------------------------------------| +| `allowed_extensions(array $extensions)` | Allowed file extensions (example: png, gif, jpg) | +| `disallowed_extensions(array $extensions)` | Disallowed file extensions (example: html, php, dmg) | +| `allowed_types(array $types)` | Allowed mime types (example: image/png, image/jpeg) | +| `disallowed_types(array $types)` | Disallowed mime types | +| `max_size(int $size)` | Maximum file size (as MB) | +| `min_size(int $size)` | Minimum file size (as MB) | +| `override()` | Override the file with the same name | +| `path(string $path)` | Set the path where files will be uploaded | +| `name(string $name)` | Rename the uploaded file (example: foo) | +| `encrypt_name()` | Encrypt file name to hide the original name | +| `must_be_image()` | Check the file is image | +| `max_dimensions(int $width, int $height)` | Maximum image dimensions | +| `min_dimensions(int $width, int $height)` | Minimum image dimensions | +| `aspect_ratios(array $aspect_ratios)` | Image aspect ratios that has to be (example: 1:1, 4:3, 16:9) | +| `error_messages(array $errors)` | Custom error messages | -| Name | Description | Return | -|---|---|---| -| `upload()` | Upload the file and return output of the check() | boolean | -| `check()` | Check the file can be uploaded | boolean | -| `get_name()` | Get the uploaded file name | string | -| `get_path()` | Get the uploaded file name with full path | string | -| `get_tmp_name()` | Get the temporary file path | string | -| `get_data_url()` | Get the file as base64 encoded data URL | string | -| `get_error()` | Get error message if an error occurred | string | +| Name | Description | Return | +|------------------|--------------------------------------------------|---------| +| `upload()` | Upload the file and return output of the check() | boolean | +| `check()` | Check the file can be uploaded | boolean | +| `get_name()` | Get the uploaded file name | string | +| `get_path()` | Get the uploaded file name with full path | string | +| `get_tmp_name()` | Get the temporary file path | string | +| `get_size()` | Get the uploaded file size in bytes | string | +| `get_type()` | Get the uploaded file mime type | string | +| `get_data_url()` | Get the file as base64 encoded data URL | string | +| `get_error()` | Get error message if an error occurred | string | ### Notes `exif` and `fileinfo` extensions must be enabled.