PHPackages                             mindscreen/fal\_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. mindscreen/fal\_upload

ActiveTypo3-cms-extension[File & Storage](/categories/file-storage)

mindscreen/fal\_upload
======================

Handling file uploads via Extbase, inspired by upload\_example of helhum

0.1.1(7y ago)03.4k3GPL-2.0+PHP

Since Aug 3Pushed 6y ago2 watchersCompare

[ Source](https://github.com/mindscreen/t3ext-fal_upload)[ Packagist](https://packagist.org/packages/mindscreen/fal_upload)[ Docs](https://github.com/mindscreen/t3ext-fal_upload)[ RSS](/packages/mindscreen-fal-upload/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

File Upload using Extbase and FAL in TYPO3 > 6.2
===================================================

[](#file-upload-using-extbase-and-fal-in-typo3--62)

```
.. post::
   :tags: TYPO3, Extbase

```

Project:TYPO3 CMS extension ext:fal\_upload for TYPO3 >= 6.2.4

Author:[Michael Telgkamp](mailto:michael.telgkamp@mindscreen.de)

Repository:At Github [mindscreen/t3ext-fal\_upload](https://github.com/mindscreen/t3ext-fal_upload)

Credit:- [Helmut Hummel](mailto:helmut.hummel@typo3.org) - for his extension [upload\_example](https://github.com/helhum/upload_example) as inspiration

**Overview:**

- [What does it do?](#what-does-it-do)
- [How does it work?](#how-does-it-work)
- [What needs to be done?](#what-needs-to-be-done)
    - [TypeConverter](#typeconverter)
    - [Error handling](#error-handling)
    - [Configurability](#configurability)
    - [Handle validation errors and already attached resources](#handle-validation-errors-and-already-attached-resources)
        - [Case: A file is already attached](#case-a-file-is-already-attached)
        - [Case: Upload succeeds, validation fails](#case-upload-succeeds-validation-fails)
    - [Security](#security)
- [Install](#install)
- [Adaptation](#adaptation)
- [Contribute](#contribute)

What does it do?
----------------

[](#what-does-it-do)

This is an extension simplifying the addition of file upload functionality in other extensions.

How does it work?
-----------------

[](#how-does-it-work)

- The heart of the extension is the UploadedFileReferenceConverter
- an extended FileReference model is needed
- an extended ObjectStorageConverter is needed
- an extended UploadViewHelper is needed

What needs to be done?
----------------------

[](#what-needs-to-be-done)

### TypeConverter

[](#typeconverter)

We want to have a custom TypeConverter to:

- evaluate the file upload array
- move the uploaded file to a FAL storage using the FAL API
- and have the result persisted in the database using the Extbase persistence.

### Error handling

[](#error-handling)

We don't want to just throw exceptions but use the TypeConverter API to return useful error messages to the user.

### Configurability

[](#configurability)

Things should be configurable, especially the TypeConverter. It needs to know about

1. the folder to upload to
2. what to do in case of a name conflict for the uploaded file
3. the allowed file extensions
4. how to deal with an already attached resource.

The actual configuration is done through by PropertyMappingConfiguration.

Some configuration options:

```