PHPackages                             cohensive/upload - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. cohensive/upload

ActiveLibrary[File & Storage](/categories/file-storage)

cohensive/upload
================

Handle file uploading.

v2.5.2(8y ago)3729BSD-3-ClausePHP >=5.3.0

Since Oct 16Compare

[ Source](https://github.com/KaneCohen/upload)[ Packagist](https://packagist.org/packages/cohensive/upload)[ RSS](/packages/cohensive-upload/feed)WikiDiscussions Synced today

READMEChangelogDependencies (2)Versions (13)Used By (0)

Upload
======

[](#upload)

Handle file uploading via standard HTML multipart form or via XHR data stream.

Usage
-----

[](#usage)

Upload can be used alone as any class or as a package for Laravel 4 framework (if you'd like to add support to any other frameworks, write to the issues or make a pull request with required changes).

First, add following line to the list of requirements in composer.json:

```
    "cohensive/upload": "dev-master"
```

Run `composer install` or `composer update` to download it and autoload.

### Laravel 4/5

[](#laravel-45)

Get package config file - not required, but maybe handy if you have a lot of various upload fields and you want to change default Upload options.

```
// Laravel 4
php artisan config:publish cohensive/upload
// Laravel 5
php artisan vendor:publish
```

In `providers` array you need to add new package:

```
'providers' => array(
    //...
    'Cohensive\Upload\UploadServiceProvider',
    //...
)
```

In aliases add Upload facade:

```
'aliases' => array(
    //...
    'Upload' => 'Cohensive\Upload\Facades\Laravel\Upload'
    //...
)
```

#### Using in the code

[](#using-in-the-code)

```
// Create new Upload instance.
// Both params are optional arrays. Description of allowed array items below.
$upload = Upload::make($rules, $options);
if ($upload->passes()) {
    // If file is valid, save it in the uploads (set in options) directory.
    $file = $upload->save();
    // $file - is an instance of Cohensive\Upload\File class with various file-related attributes and methods.
} else {
    // Get array of errors - simple list of failed validation rules.
    $upload->getErrors();
}
```

What to do with uploaded files next is out of the scope of Upload.

---

### Standalone

[](#standalone)

As a standalone package you'll have to instantiate several classes that Upload depends on. Namely:

- Validator - will validate files agains a set of rules.
- Sanitizer - will keep filename safe for web (transliteration to ascii). It has one required parameter - instantiated class that will do the file sanitization. Various framework has own versions of such class often called Transliterator or Inflector. You just use its instance as a first argument and as a second parameter include method name that will be used for sanitization. Alternatively, you can create a wrapper for you Inflector which implements \\Cohensive\\Upload\\Sanitizer\\SanitizerInterface
- FileHandlerFactory - will create FileHandlers based on the method of uploading

```
$validator = new \Cohensive\Upload\Validator([
    'maxSize' => 2097152 // Set maximum allowed filesize to 2MB (set in bytes)
]);

$sanitizer = new \Cohensive\Upload\Sanitizer\AbstractSanitizer($sanitizerClass, $sanitizerMethod);

$fileFactory = new \Cohensive\Upload\FileHandlerFactory();

$options = [...]; // An array of options for Upload, such as upload directory etc.
$upload = new \Cohensive\Upload\Upload($validator, $sanitizer, $fileFactory, $options);
```

#### Using in the code

[](#using-in-the-code-1)

```
$rules = [...]; // An array of validation rules. Optional.
if ($upload->passes($rules)) {
    // If file is valid, save it in the uploads (set in options) directory.
    $file = $upload->save();
} else {
    // Get array of errors - simple list of failed validation rules.
    $errors = $validator->getErrors();
}
```

#### Handling file post-save.

[](#handling-file-post-save)

After file has been successfully validated and saved, Upload will return `File`class instance which contains number of methods:

```
$file->move($destination);           // Move file to another directory. Returns boolean.
$file->delete();                     // Delete file.
$file->getFileinfo();                // Returns array containing file information.
$file->getFilepath();                // Returns path to the file.
$file->getMimetype();                // Returns file MIME.
$file->getExtension();               // Returns file extension.
$file->isExists();                   // Checks if files exists. Returns boolean.
```

### Options

[](#options)

Uploader accets an array of options on instantiation:

```
    'uploadDir'   => 'uploads/',     // Folder where all uploaded files will be saved to.
    'tmpDir'      => 'uploads/tmp/', // Folder to keep files temporary for operations.
    'param'       => 'file',         // Parameter to access the file on.
    'name'        => '',             // Set new filename. Blank to use original name.
    'nameLength'  => 32,             // Set maximum length of the name. Will be cut if longer.
    'prefix'      => '',             // Add prefix to the filename..
    'suffix'      => '',             // Add suffix to the filename.
    'case'        => '',             // Convert file name to the case: 'lower', 'upper' or falsy to keep original.
    'overwrite'   => false,          // If file already exists, overwrite it.
    'autoRename'  => true,           // In case if file with the same name exists append counter to the new file.
    'randomize'   => false,          // Generate random filename. Boolean or integer for string length. Default length is 10.
    'sanitize'    => true            // Sanitize filename - remove whitespaces and convert utf8 to ascii.
```

#### Rules

[](#rules)

An array of rules that could be used while validation uploaded files:

```
    'minSize'   => 0,        // Minimum filesize.
    'maxSize'   => 10485760, // Maximum filesize: 10MB.
    'maxWidth'  => 0,        // Maximum image width if file is an image.
    'maxHeight' => 0,        // Maximum image height if file is an image.
    'minWidth'  => 0,        // Minimum image width if file is an image.
    'minHeight' => 0,        // Minimum image height if file is an image.
    'width'     => [],       // Image must have exact width (use array to set multiple).
    'height'    => [],       // Image must have exact height (use array to set multiple).
    'whiteExt'  => ['jpg', 'jpeg', 'gif', 'png'], // Array of allowed extensions.
    'blackExt'  => []                             // Array of disallowed extensions.
```

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity65

Established project with proven stability

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~94 days

Recently: every ~133 days

Total

12

Last Release

3241d ago

Major Versions

v1.0.0 → v2.0.02015-03-09

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/578455?v=4)[Kane Cohen](/maintainers/KaneCohen)[@KaneCohen](https://github.com/KaneCohen)

---

Tags

HTML5fileupload

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cohensive-upload/health.svg)

```
[![Health](https://phpackages.com/badges/cohensive-upload/health.svg)](https://phpackages.com/packages/cohensive-upload)
```

###  Alternatives

[kartik-v/bootstrap-fileinput

An enhanced HTML 5 file input for Bootstrap 5.x, 4.x, and 3.x with features for file preview for many file types, multiple selection, ajax uploads, and more.

5.4k8.2M13](/packages/kartik-v-bootstrap-fileinput)[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.5M85](/packages/unisharp-laravel-filemanager)[sonata-project/media-bundle

Symfony SonataMediaBundle

4625.6M73](/packages/sonata-project-media-bundle)[kartik-v/yii2-widget-fileinput

An enhanced FileInput widget for Bootstrap 3.x, 4.x & 5.x with file preview, multiple selection, and more features (sub repo split from yii2-widgets)

2357.1M97](/packages/kartik-v-yii2-widget-fileinput)[servocoder/richfilemanager

RichFilemanager - highly customizable open-source file manager

90964.5k2](/packages/servocoder-richfilemanager)[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

191192.5k18](/packages/fof-upload)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)