PHPackages                             ichhabrecht/filefill - 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. ichhabrecht/filefill

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

ichhabrecht/filefill
====================

Find and fetch missing local files from different remotes

5.0.0(1y ago)671.4M—9.4%44[11 issues](https://github.com/IchHabRecht/filefill/issues)[8 PRs](https://github.com/IchHabRecht/filefill/pulls)1GPL-2.0-or-laterPHPPHP ^8.2CI failing

Since Mar 10Pushed 1y ago8 watchersCompare

[ Source](https://github.com/IchHabRecht/filefill)[ Packagist](https://packagist.org/packages/ichhabrecht/filefill)[ Docs](https://github.com/IchHabRecht/filefill)[ RSS](/packages/ichhabrecht-filefill/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (5)Versions (52)Used By (1)

TYPO3 Extension filefill
========================

[](#typo3-extension-filefill)

[![Latest Stable Version](https://camo.githubusercontent.com/88f07df0aa9e8ffaa3c7dfa7bd1779c6083ad85ace24235b8718cbc34bbdb265/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f69636868616272656368742f66696c6566696c6c2e737667)](https://packagist.org/packages/ichhabrecht/filefill)[![StyleCI](https://camo.githubusercontent.com/a1908fdbd2e753617ca984c39122ec432d9201d68cd0bc7070baa15bf255589c/68747470733a2f2f7374796c6563692e696f2f7265706f732f3132333632383132322f736869656c643f6272616e63683d6d61696e)](https://styleci.io/repos/123628122)[![GitHub Actions](https://github.com/IchHabRecht/filefill/actions/workflows/test.yml/badge.svg?event=push)](https://github.com/IchHabRecht/filefill/actions/workflows/test.yml/badge.svg?event=push)

Find and fetch missing local files from different remotes.

Ever tried to set up a new system as copy from an existing one? Wondered if all the files (in fileadmin) are really needed? Ever run into the problem that a local file was missing?

Filefill fetches missing files from one or multiple remote servers to ensure you have all the files you need for the new system.

Once the configuration is set up, fetching can be triggered by loading a page with missing files in the frontend.

The extension requires the usage of FAL api to fetch missing files. Files are stored directly in the (local) storage folder (e.g. fileadmin). You can re-run filefill at any time by deleting the local files in the storage folder.

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

[](#installation)

Simply install the extension with Composer as development dependency or the Extension Manager.

`composer require --dev ichhabrecht/filefill`

Usage
-----

[](#usage)

You need to configure resources for one or more existing file storages.

*Prerequisite: Only storages with a "Local filesystem" driver are currently supported.*

Resources for file storages can be configured using one of the two following options where the database record configuration is preferred if set. If not set, the `TYPO3_CONF_VARS` configuration is used.

### Database record configuration

[](#database-record-configuration)

- go to the root of your TYPO3 page tree (id=0)
- change to the list module (Web -> List on the left side)
- find the "File Storage" section and edit a record
- change to the tab "File Fill" and select the enable checkbox
- define the resource chain that should be used to fetch missing files

### TYPO3\_CONF\_VARS configuration

[](#typo3_conf_vars-configuration)

- given a file storage with uid 1, the configuration might look like this

```
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['filefill']['storages'][1] = [
    [
        'identifier' => 'domain',
        'configuration' => 'https://example.com',
    ],
    [
        'identifier' => 'domain',
        'configuration' => 'https://another-example.com',
    ],
    [
        'identifier' => 'placehold',
    ],
    [
        'identifier' => 'imagebuilder',
        'configuration' => [
            'backgroundColor' => '#FFFFFF',
            'textColor' => '#000000',
        ],
    ],
    [
        'identifier' => 'static',
        'configuration' => [
            'path/to/example/file.txt' => 'Hello world!',
            'another' => [
                'path' => [
                    'to' => [
                        'anotherFile.txt' => 'Lorem ipsum',
                        '*.youtube' => 'yiJjpKzCVE4',
                    ],
                    '*' => 'This file was found in /another/path folder.',
                ],
            ],
            '*.vimeo' => '143018597',
            '*' => 'This is some static text for all other files.',
        ],
    ],
];
```

- you don't need to configure resources that you don't want to use
- the ordering in your configuration defines the ordering of processing

Resources
---------

[](#resources)

Resources define the places (url / services) where filefill tries to fetch missing files from. You can use multiple resources to build some kind of fallback chain.

### Single domain

[](#single-domain)

Fetch missing files from a fixed url.

Configuration:

- Url: Enter a valid url (incl http/https scheme)

You can use multiple single domains within one resources configuration.

### Placehold.co

[](#placeholdco)

Fetch a missing image from the [placehold.co](https://placehold.co) service. This fetches an image with the correct resolution of the original file.

Configuration:

- no configuration required (the checkbox is just a field placeholder)

There is no need for multiple usage. This resource can be the last one in the chain but can handle image files only.

### Image builder

[](#image-builder)

Create an empty image with the correct resolution of the original file. The height and width is added as a text layer.

Configuration:

- Background color: Enter a valid hex code as background color
- Text color: Enter a valid hex code as text color

### Static file

[](#static-file)

Ensure missing files will be available. By default, an empty file will be created.

Configuration:

- You can configure the content of a file by its path or extension

Please use *TypoScript syntax* for **record configuration**.

```
path/to/example/file.txt = Hello world!
another {
    path {
        to {
            anotherFile\.txt = Lorem ipsum
            *\.youtube => yiJjpKzCVE4
        }
        * = This file was found in /another/path folder.
    }
}
*\.vimeo = 143018597
* = This is some static text for all other files.

```

Additional resources
--------------------

[](#additional-resources)

You can add own resource handlers to fetch files from additional services.

### Registration

[](#registration)

```
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['filefill']['resourceHandler']['identifierName'] = [
    'title' => 'Name of the resource',
    'handler' => \Vendor\Extension\Resource\ResourceHandler::class,
    'config' => [
        'label' => 'Name of the resource',
        'config' => [
            'type' => 'check',
            'default' => 1,
        ],
    ],
];

```

- title: name of the resource that is taken as backend (flex) button label
- handler: name of the class that handels the actual implementation
- config: TCA configuration for the backend (flex) field

### Handler

[](#handler)

```
namespace Vendor\Extension\Resource;
class ResourceHandler implements \IchHabRecht\Filefill\Resource\RemoteResourceInterface
{
    public function hasFile($fileIdentifier, $filePath, ?FileInterface $fileObject = null)
    {
        return true;
    }

    public function getFile($fileIdentifier, $filePath, ?FileInterface $fileObject = null)
    {
        return 'file content';
    }
}

```

The handler needs to implement the interface `\IchHabRecht\Filefill\Resource\RemoteResourceInterface` and therefore has to add both functions `hasFile` and `getFile`.

Debugging
---------

[](#debugging)

You can enable additional log information by configuring a filefill logger.

```
$GLOBALS['TYPO3_CONF_VARS']['LOG']['IchHabRecht']['Filefill'] = [
    'writerConfiguration' => [
        \TYPO3\CMS\Core\Log\LogLevel::DEBUG => [
            \TYPO3\CMS\Core\Log\Writer\FileWriter::class => [
                'logFileInfix' => 'filefill',
            ],
        ],
    ],
];

```

Known issues
------------

[](#known-issues)

### 1509741907 TYPO3Fluid\\Fluid\\Core\\ViewHelper\\Exception

[](#1509741907-typo3fluidfluidcoreviewhelperexception)

*Folder "\[...\]" does not exist.*

Filefill tries to fetch the existing file from any resource. However, due to the FAL api the exception cannot be prevented nor handled by filefill. Try to reload the page again, the exception (for this specific file) should not occur anymore. Please note that there might be a new exception for a new file. In this case you need to reload your page until all files were properly created on your current system.

Community
---------

[](#community)

- Thanks to [in2code](https://www.in2code.de/) that sponsored parts of the TYPO3 13 update
- Thanks to [b13](https://b13.com) that sponsored the maintenance of this extension with a sponsorship
- Thanks to [Wolfgang Wagner](https://wwagner.net) who sponsored the maintenance of this extension with a sponsorship
- Thanks to [Marcus Schwemer](https://twitter.com/MarcusSchwemer) who wrote about filefill in his blog [TYPO3worx](https://typo3worx.eu/2018/03/eight-typo3-extensions-making-developers-happy/)
- Thanks to [Thomas Löffler](https://spooner-web.de) for his support as [Patron](https://www.patreon.com/IchHabRecht)

###  Health Score

59

—

FairBetter than 99% of packages

Maintenance46

Moderate activity, may be stable

Popularity55

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity89

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 90.3% 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 ~53 days

Recently: every ~22 days

Total

50

Last Release

377d ago

Major Versions

1.5.0 → 2.x-dev2020-03-12

2.x-dev → 3.2.02020-04-02

1.6.0 → 3.2.12020-04-22

3.x-dev → 4.0.02021-10-25

4.x-dev → 5.0.02025-05-06

PHP version history (5 changes)3.3.0PHP >= 7.0, < 7.5

4.0.0PHP >= 7.2, < 7.5 || >= 8.0, < 8.1

4.1.0PHP ^7.2 || ^8.0

4.2.0PHP ^7.4 || ^8.0

4.3.3PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1453345?v=4)[Nicole Hummel](/maintainers/IchHabRecht)[@IchHabRecht](https://github.com/IchHabRecht)

---

Top Contributors

[![IchHabRecht](https://avatars.githubusercontent.com/u/1453345?v=4)](https://github.com/IchHabRecht "IchHabRecht (186 commits)")[![spoonerWeb](https://avatars.githubusercontent.com/u/1793083?v=4)](https://github.com/spoonerWeb "spoonerWeb (3 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (2 commits)")[![randomresult](https://avatars.githubusercontent.com/u/4463384?v=4)](https://github.com/randomresult "randomresult (2 commits)")[![julianhofmann](https://avatars.githubusercontent.com/u/25646388?v=4)](https://github.com/julianhofmann "julianhofmann (2 commits)")[![kaywalker](https://avatars.githubusercontent.com/u/1043613?v=4)](https://github.com/kaywalker "kaywalker (1 commits)")[![koehnlein](https://avatars.githubusercontent.com/u/16088567?v=4)](https://github.com/koehnlein "koehnlein (1 commits)")[![linawolf](https://avatars.githubusercontent.com/u/48202465?v=4)](https://github.com/linawolf "linawolf (1 commits)")[![mbrodala](https://avatars.githubusercontent.com/u/5037116?v=4)](https://github.com/mbrodala "mbrodala (1 commits)")[![schliesser](https://avatars.githubusercontent.com/u/11655823?v=4)](https://github.com/schliesser "schliesser (1 commits)")[![bjo3rnf](https://avatars.githubusercontent.com/u/1183009?v=4)](https://github.com/bjo3rnf "bjo3rnf (1 commits)")[![sypets](https://avatars.githubusercontent.com/u/13206455?v=4)](https://github.com/sypets "sypets (1 commits)")[![dogawaf](https://avatars.githubusercontent.com/u/381969?v=4)](https://github.com/dogawaf "dogawaf (1 commits)")[![franzkugelmann](https://avatars.githubusercontent.com/u/11320147?v=4)](https://github.com/franzkugelmann "franzkugelmann (1 commits)")[![georgringer](https://avatars.githubusercontent.com/u/1905663?v=4)](https://github.com/georgringer "georgringer (1 commits)")[![helhum](https://avatars.githubusercontent.com/u/904370?v=4)](https://github.com/helhum "helhum (1 commits)")

---

Tags

fileextensionmissingtypo3placeholder

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ichhabrecht-filefill/health.svg)

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

###  Alternatives

[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)

2286.8M95](/packages/kartik-v-yii2-widget-fileinput)[hmmh/solr-file-indexer

Solr file indexer for Typo3

13217.4k3](/packages/hmmh-solr-file-indexer)[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)