PHPackages                             litzinger/file-field - 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. litzinger/file-field

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

litzinger/file-field
====================

File Field library for ExpressionEngine

1.1.0(5y ago)12.8kMITPHPPHP >=5.5.9

Since Sep 17Pushed 3y ago1 watchersCompare

[ Source](https://github.com/litzinger/file-field)[ Packagist](https://packagist.org/packages/litzinger/file-field)[ RSS](/packages/litzinger-file-field/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (8)Used By (0)

```
composer require litzinger/file-field

```

This is a wrapper class to generate a fully functioning file field type within the ExpressionEngine 3 control panel (or front-end). It uses the native File\_ft class to generate all the necessary HTML markup and JavaScript to render a fully functioning file field anywhere in the control panel. Its ideal for usage within 3rd party add-ons that need to save images as form options.

So why not use the native [FilePicker](https://docs.expressionengine.com/latest/development/services/filepicker.html "FilePicker") service? Simple. It does not automatically create all of the necessary HTML and JavaScript needed to make a funtioning file field. You will need to register and maintain your own JavaScript callbacks. This class handles all of that for you because it uses the exact same code used to render the file picker in the control panel, which in turn uses the FilePicker service. By piggy backing off of the native File\_ft it will render a working field in the control panel, or in a front-end channel:form tag.

Usage
=====

[](#usage)

$fieldName should be the name of the form field. Can be field\_id\_1, or foo\[something\]\[another\_thing\]

$fieldValue is the saved value in the database, usually {field\_dir\_1}something.png

$settings is an array of settings required for the native EE File\_ft class

```
$fileField = new FileField($fieldName, $fieldValue, $settings);
$options .= 'Image' . $fileField->render();

```

Roadmap
-------

[](#roadmap)

- Add Symfony's OptionsResolver to validate the $settings array
- Add compatibility with the Treasury field type?
- Add compatibility with the Assets field type?

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

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

Recently: every ~363 days

Total

6

Last Release

2120d ago

PHP version history (2 changes)1.0.0PHP >=5.4

1.0.4PHP >=5.5.9

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/53965?v=4)[Brian Litzinger](/maintainers/litzinger)[@litzinger](https://github.com/litzinger)

---

Top Contributors

[![litzinger](https://avatars.githubusercontent.com/u/53965?v=4)](https://github.com/litzinger "litzinger (20 commits)")

### Embed Badge

![Health badge](/badges/litzinger-file-field/health.svg)

```
[![Health](https://phpackages.com/badges/litzinger-file-field/health.svg)](https://phpackages.com/packages/litzinger-file-field)
```

PHPackages © 2026

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