PHPackages                             xis/easy-forms-bundle - 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. xis/easy-forms-bundle

ActiveSymfony-bundle

xis/easy-forms-bundle
=====================

Easy forms bundle

0.1.2(11y ago)121MITPHPPHP >=5.4

Since Jan 11Pushed 11y ago1 watchersCompare

[ Source](https://github.com/thanek/easy-forms-bundle)[ Packagist](https://packagist.org/packages/xis/easy-forms-bundle)[ RSS](/packages/xis-easy-forms-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (4)Used By (0)

Easy Forms Bundle for Symfony
=============================

[](#easy-forms-bundle-for-symfony)

Easy form flow handling in Symfony controllers.

Why?

- use really thin controllers
- make your controller unit-testable easier
- Do not Repeat Yourself implementing the boring form-subbmission code!

All you need is to use the @Form class annotation, for example:

`@Form("new_form",method="createCreateForm")`

With this annotation you can list all the forms used in current controller. The `method` attribute points to method that creates this particular form.

Now, you can annotate methods which "starts" form-flow with the `@FormStarter` and the methods which accepts form submission using the `@FormAcceptor` annotation.

The FormListener will handle the flow, it will create the form and inject it into the template parameters in form-starter methods, so you don't have to do it manually. Also, it will handle the acceptor; bind and validate the form. Note that the form-acceptor method is executed only if the form is valid, so the only thing you need to do in your form-acceptor method is to persist your fresh created/updated entity.

If the form submission fails, the flow stops at starter method - it will show the bound form with error message.

You can also "decorate" the form-acceptor behavior for failed forms. Use the `rejector` property to point a method which will be executed when form submission fails. This may be useful when you need to show some flash-messages or use some logging.

You may want to access the form in the form-acceptor method. To do this, use the `param` property of `@FormAcceptor` annotation and then, the form will be passed as the input parameter of form-acceptor method.

See the [`PostController`](Resources/example/Controller/PostController.php) class for example how to use those annotations. If you want to see how it works, check out the [example symfony-project](https://github.com/thanek/easy-forms-bundle-example) that uses this bundle.

*Note that you need to use the `@Template` annotations in your form-starter controller, because FormListener needs to act before the view is rendered.*

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

[](#installation)

Just add the following line to the `"require"` section in your composer.json file:

```
"xis/easy-forms-bundle": "~0.1"

```

Don't forget to update composer dependencies:

```
composer.phar update

```

Then you need to update your `AppKernel.php` file and enable the bundle by adding the folowing entry to the `$bundles` array in `registerBundles` method:

```
new Xis\EasyFormsBundle\XisEasyFormsBundle(),

```

And that's it.

MIT License
-----------

[](#mit-license)

The bundle is distributed under the [MIT](http://opensource.org/licenses/MIT) license.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

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

Total

3

Last Release

4144d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/40d103b796119bb4231072357dca83aec34a0863369c328aa37e8fd64eb25007?d=identicon)[xis](/maintainers/xis)

---

Top Contributors

[![thanek](https://avatars.githubusercontent.com/u/3183489?v=4)](https://github.com/thanek "thanek (10 commits)")

### Embed Badge

![Health badge](/badges/xis-easy-forms-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/xis-easy-forms-bundle/health.svg)](https://phpackages.com/packages/xis-easy-forms-bundle)
```

###  Alternatives

[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[pumukit/pumukit

Media Portal

5714.0k37](/packages/pumukit-pumukit)[ed/blog-bundle

Symfony EDBlogBundle

348.4k](/packages/ed-blog-bundle)[yosimitso/workingforumbundle

A complete forum bundle

425.3k](/packages/yosimitso-workingforumbundle)[ecentria/ecentria-rest-bundle

Goal of this bundle is to simplify process of creating APIs with Symfony. We use already well-coded libraries, combine them together to simplify process and not to re-invent the wheel. We've chose REST and HATEOS to have unified standards of API requests and responses.

142.4k](/packages/ecentria-ecentria-rest-bundle)

PHPackages © 2026

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