Weave Code
Reform Bundle Laravel Package
ruvents/reform-bundle
Symfony bundle that integrates the Reform form library, letting you build, render, and validate complex forms through a clean PHP API. Adds form types, entity binding, and Twig helpers to simplify form handling in Symfony applications.
At a glance
Frequently asked questions about Reform Bundle
- Is ruvents/reform-bundle a Laravel package?
- No. ruvents/reform-bundle is a Symfony bundle that integrates the Reform form library, and it is distributed on Packagist under the ruvents vendor name for Symfony applications. It does not ship a Laravel service provider, facade, or config file, so it is not a drop-in dependency for a Laravel app. Laravel developers evaluating it should instead look at Laravel-native options such as Laravel's own form requests and validation, Livewire, Filament, or Inertia-based form handling.
- How do I install ruvents/reform-bundle with Composer?
- Install it with Composer using composer require ruvents/reform-bundle, then register the bundle in your Symfony application's bundle configuration so its form types and Twig extensions are loaded. Because the package is a Symfony bundle rather than a Laravel package, it expects Symfony's kernel and bundle registration rather than a Laravel service provider. Check the repository README and the package's composer.json for the exact registration snippet and supported framework versions.
- What does the Reform bundle actually add on top of Symfony Forms?
- According to its overview, the bundle integrates the Reform form library so you can build, render, and validate complex forms through a clean PHP API. It adds form types, entity binding, and Twig helpers intended to simplify form handling in Symfony applications. In practice that means less boilerplate when wiring up large forms, mapping them to Doctrine entities, and rendering them in templates.
- Which Symfony and PHP versions does ruvents/reform-bundle support?
- The supported Symfony and PHP version ranges are declared in the package's composer.json, so check the require section on Packagist or in the repository before upgrading. Because the bundle builds on Symfony's form and Twig components, its constraints usually track the Symfony major versions it was tested against. If your project runs an older or newer Symfony release than the declared range, verify compatibility with a test branch before relying on it.
- How do the Twig helpers in Reform bundle work?
- The bundle registers Twig helpers so forms defined through the Reform PHP API can be rendered directly in your templates without hand-writing every widget. You define the form in PHP, pass it to the template, and call the provided helper to output the markup. This keeps form structure in PHP while leaving presentation in Twig, which is the usual Symfony separation of concerns.
- Can I bind Doctrine entities to forms built with Reform?
- Yes, entity binding is one of the advertised features of the bundle, so forms can be mapped to Doctrine entities instead of plain arrays. That lets you populate a form from an existing record and write submitted data back to the entity. Exact API details, such as how the data class is declared, are documented in the repository README rather than in the package blurb.
- How is validation handled in Reform forms?
- Validation goes through the Reform form library's submission handling, which works alongside Symfony's validator component and its constraints. You define constraints on your data class or form and let the form report errors back to the rendered output. Since the package description only states that it validates complex forms, confirm the precise error-handling API in the README before designing your flow.
- Is ruvents/reform-bundle actively maintained and safe for production?
- That depends on the repository's current state, so check the last commit date, tagged releases, open issues, and whether the composer.json constraints still match the Symfony version you run. The package is a smaller vendor bundle rather than a first-party Symfony component, which usually means a narrower support surface. Run your own test suite against it and pin the version in composer.json before shipping to production.
- What are the alternatives to Reform bundle for building complex forms?
- In Symfony, the closest alternatives are plain Symfony Forms with form types and events, EasyAdmin for admin-side forms, and API Platform for input DTO validation on APIs. In Laravel, comparable ground is covered by FormRequest validation, Livewire or Filament form components, and Inertia with Vue or React form libraries. Choose based on whether your application is Symfony- or Laravel-based, since this bundle only serves the former.
- How do I test forms built with ruvents/reform-bundle?
- Test them the way you would test any Symfony form: extend KernelTestCase or WebTestCase, boot the kernel so the bundle is registered, and submit data through the form factory or an HTTP request. Assert on the resulting entity state, validation errors, and rendered Twig output. Because the bundle wires itself into the container, functional tests are usually more reliable than isolated unit tests for form behaviour.
Weaver
How can I help you explore Laravel packages today?