PHPackages                             vkr/symfony-web-uploader - 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. vkr/symfony-web-uploader

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

vkr/symfony-web-uploader
========================

PHP library that simplifies file uploading process to external APIs

1.2.1(9y ago)01311MITPHPPHP >=5.6

Since Aug 8Pushed 9y ago1 watchersCompare

[ Source](https://github.com/wladislavk/SymfonyWebUploader)[ Packagist](https://packagist.org/packages/vkr/symfony-web-uploader)[ Docs](https://github.com/wladislavk/SymfonyWebUploader)[ RSS](/packages/vkr-symfony-web-uploader/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependencies (3)Versions (6)Used By (1)

About
=====

[](#about)

This small library (not a bundle!) simplifies uploading files to an external resource via an API. Since version 1.2, this library depends on Symfony.

This library does not do anything by itself, it is designed to be extended by other bundles or libraries.

Installation
============

[](#installation)

Nothing to install here, really.

Usage
=====

[](#usage)

In Symfony projects
-------------------

[](#in-symfony-projects)

First, you need to create a concrete service implementation of `AbstractUploader` class. This service needs to have a single method called `upload()` that does not accept arguments and by convention should return `$this`.

Here are the properties that can be accessed from inside that method:

- `$this->file` - `Symfony\Component\HttpFoundation\File\File` object acting as a handler for original file
- `$this->uploadURL` - full path to the remote destination folder without trailing slash
- `$this->filename` - the name that will be given for your newly uploaded file - see name changers

If you register this service inside Symfony service container, you will need to install VKRSettingsBundle and add it as an argument to `services.yml`:

```
my_uploader:
    class: AppBundle\MyUploader
    arguments:
        - "@vkr_settings.settings_retriever"

```

Then, you will need to create three settings either as parameters or inside your DB:

- `allowed_upload_types` - an array of MIME types
- `allowed_upload_size` - max size in bytes that can be uploaded
- a setting with arbitrary name with full URL to remote destination folder, with or without trailing slash

See VKRSettingsBundle manual on how settings can be defined.

Here is how you access this service from your controller:

```
$uploader->setUploadDir('my_upload_dir_setting_name');
$file = new Symfony\Component\HttpFoundation\File\File('path/to/file/filename');
$uploader->setFile($file);
$uploader->upload()->checkIfSuccessful();

```

Here `checkIfSuccessful()` checks if the uploaded file exists, has same size and MIME type as the original file and throws exception on error.

If you want to disable checks for size and MIME type, you can call:

```
$uploader->setFile($file, null, false);

```

Name changers
-------------

[](#name-changers)

The second argument to `setFile()` is a name changer object. It defines what name will the new file have. If no name changer is present, the new file will have the same name as the original. Name changers must implement `NameChangerInterface`.

Suppose that you want all files to be renamed with current Unix timestamps, in this case your name changer will look like this:

```
class MyNameChanger implements VKR\SymfonyWebUploader\Interfaces\NameChangerInterface
    public function changeName($originalFilename)
    {
        return time();
    }

    public function setParameters(array $parameters)
    {
    }

```

Then in your controller:

```
$nameChanger = new MyNameChanger();
$uploader->setFile($file, $nameChanger);

```

You do not need to create a name changer if your file was just uploaded by a client and you want to keep the client filename in this case the default new name will correspond to the client filename, not to the PHP temporary name.

Outside of Symfony
------------------

[](#outside-of-symfony)

Things are not that different outside of Symfony, however you cannot use VKRSettingsBundle and must pass your settings as an array:

```
$settings = [
    'allowed_upload_size' => 10000,
    'allowed_upload_types' => ['image/jpeg, 'image/png'],
    'upload_dir' => 'http://my-upload-domain.com/upload-folder/',
];
$uploader = new VKR\SymfonyWebUploader\Uploader(null, $settings);

```

Also, if you are forwarding a file that was just uploaded from a form, you need to initialize it manually:

```
$file = new Symfony\Component\HttpFoundation\File\UploadedFile($_FILES['file']['tmp_name'], $_FILES['file']['name']);
$uploader->setFile($file);

```

###  Health Score

28

—

LowBetter than 51% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity62

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

Total

5

Last Release

3430d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11371476?v=4)[Vladislav Kryshtanovskiy](/maintainers/wladislavk)[@wladislavk](https://github.com/wladislavk)

---

Top Contributors

[![wladislavk](https://avatars.githubusercontent.com/u/11371476?v=4)](https://github.com/wladislavk "wladislavk (6 commits)")

---

Tags

phpapilaravelSymfony2uploadsymfony3drupal8

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vkr-symfony-web-uploader/health.svg)

```
[![Health](https://phpackages.com/badges/vkr-symfony-web-uploader/health.svg)](https://phpackages.com/packages/vkr-symfony-web-uploader)
```

###  Alternatives

[api-platform/core

Build a fully-featured hypermedia or GraphQL API in minutes!

2.6k52.2M371](/packages/api-platform-core)[vich/uploader-bundle

Ease file uploads attached to entities

1.9k28.1M161](/packages/vich-uploader-bundle)[moonshine/moonshine

Laravel administration panel

1.3k268.2k88](/packages/moonshine-moonshine)[api-platform/http-cache

API Platform HttpCache component

275.1M23](/packages/api-platform-http-cache)[sopamo/laravel-filepond

Laravel backend module for filepond uploads

215320.1k3](/packages/sopamo-laravel-filepond)[bitrix24/b24phpsdk

An official PHP library for the Bitrix24 REST API

10250.3k6](/packages/bitrix24-b24phpsdk)

PHPackages © 2026

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