PHPackages                             it-blaster/uploadable-behavior - 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. it-blaster/uploadable-behavior

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

it-blaster/uploadable-behavior
==============================

The UploadableBehavior helps you handle uploaded files with Propel

v1.1.0(9y ago)08.6k↓43.6%1MITPHPPHP >=5.3.2

Since Apr 24Pushed 9y ago7 watchersCompare

[ Source](https://github.com/it-blaster/uploadable-behavior)[ Packagist](https://packagist.org/packages/it-blaster/uploadable-behavior)[ Docs](https://github.com/it-blaster/uploadable-behavior)[ RSS](/packages/it-blaster-uploadable-behavior/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (5)Used By (1)

UploadableBehavior
==================

[](#uploadablebehavior)

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/cf7187e9c02c6dd541b3ef11e0470b25dbc485aeb64b437fd36cfb285277d6bb/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69742d626c61737465722f75706c6f616461626c652d6265686176696f722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/it-blaster/uploadable-behavior/?branch=master) [![Build Status](https://camo.githubusercontent.com/e0f0209db61209395ef433ddce0c494aa6ff16357e8d018aba98e44ab3135a62/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69742d626c61737465722f75706c6f616461626c652d6265686176696f722f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/it-blaster/uploadable-behavior/build-status/master) [![License](https://camo.githubusercontent.com/7d41f106cfe33caea345ce993fae1a5ac3fd4befc23513fedbf366efe044ed4b/68747470733a2f2f706f7365722e707567782e6f72672f69742d626c61737465722f75706c6f616461626c652d6265686176696f722f6c6963656e73652e737667)](https://packagist.org/packages/it-blaster/uploadable-behavior) [![Total Downloads](https://camo.githubusercontent.com/7168bbfc3dbd1da898e1d3ea02a3a05fc18b6c0c92d3c3cc851d1623709c9dc4/68747470733a2f2f706f7365722e707567782e6f72672f69742d626c61737465722f75706c6f616461626c652d6265686176696f722f646f776e6c6f616473)](https://packagist.org/packages/it-blaster/uploadable-behavior) [![Latest Unstable Version](https://camo.githubusercontent.com/c814e0819d9123f8514930e73bafbd8584a099c5d6c917b404a6f4ff601ad0ba/68747470733a2f2f706f7365722e707567782e6f72672f69742d626c61737465722f75706c6f616461626c652d6265686176696f722f762f756e737461626c652e737667)](https://packagist.org/packages/it-blaster/uploadable-behavior) [![Latest Stable Version](https://camo.githubusercontent.com/c4b39cf288ad0542e52f09f957a151e033cc065df9863f3557515ba77b5878ad/68747470733a2f2f706f7365722e707567782e6f72672f69742d626c61737465722f75706c6f616461626c652d6265686176696f722f762f737461626c652e737667)](https://packagist.org/packages/it-blaster/uploadable-behavior)

The UploadableBehavior helps you handle uploaded files with Propel.

Installation
------------

[](#installation)

Add it-blaster/uploadable-behavior to your `composer.json` file and run `composer`

```
...
"require": {
    "it-blaster/uploadable-behavior": "1.0.*"
}
...
```

Register the behavior in your `config.yml`

```
...
propel:
    behaviors:
        uploadable: Fenrizbes\UploadableBehavior\Behavior\UploadableBehavior
...
```

Usage
-----

[](#usage)

Add the behavior to your table:

```
...

...
```

By default it finds or creates a varchar column named `file`, but you can configure your own columns:

```
...

...
```

Extending
---------

[](#extending)

The behavior adds a few methods to the base class that help it, and you can override and extend any of them.

- `getUploadRoot` returns an absolute path to the web directory of your project. By default it returns the most common path, but the best way is setting this path to a model in your controller.
- `getUploadDir` returns a relative path from the root dir to the file's folder. By default it's `/uploads////`.
- `makeFileName` generates the name for the file randomly.
- `moveUploadedFile` moves the file and sets new value to its column. If you're overriding this method, remember that it has to return a web path to the uploaded file (of course if you don't want to change its behavior).

Notes
-----

[](#notes)

Remember that this behavior handles uploaded files (moves them and sets columns' values) and does nothing more. So:

- if you don't have a view transformer or overridden getters that convert string file paths to `File` objects, set `null` to the `data_class` option of form fields;
- if you send an empty value for file field and don't want to erase column's value, handle it yourself;
- if you want to have a way to delete uploaded files, do it yourself;
- if you need anything else... well, you know.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~245 days

Total

3

Last Release

3553d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11211873?v=4)[Iaroslav Gashuk](/maintainers/fenrizbes)[@fenrizbes](https://github.com/fenrizbes)

---

Top Contributors

[![selezenev](https://avatars.githubusercontent.com/u/3917621?v=4)](https://github.com/selezenev "selezenev (1 commits)")

---

Tags

symfonyuploadBehaviorpropel

### Embed Badge

![Health badge](/badges/it-blaster-uploadable-behavior/health.svg)

```
[![Health](https://phpackages.com/badges/it-blaster-uploadable-behavior/health.svg)](https://phpackages.com/packages/it-blaster-uploadable-behavior)
```

###  Alternatives

[thrace-project/media-bundle

The `ThraceMediaBundle` handles file, video, audio and image upload plus some image manipulations.

112.2k](/packages/thrace-project-media-bundle)[liyunfang/yii2-upload-behavior

Upload behavior for Yii 2

161.7k](/packages/liyunfang-yii2-upload-behavior)

PHPackages © 2026

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