Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
iamdual committed Jul 24, 2022
1 parent ff6b9e8 commit e4d550e
Showing 1 changed file with 29 additions and 27 deletions.
56 changes: 29 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down

0 comments on commit e4d550e

Please sign in to comment.