https://github.com/mintyphp/forms
PHP Form builder with Bulma support
https://github.com/mintyphp/forms
bulma form-builder form-handling form-validation forms-generator php-form php-form-builder php-forms
Last synced: 7 months ago
JSON representation
PHP Form builder with Bulma support
- Host: GitHub
- URL: https://github.com/mintyphp/forms
- Owner: mintyphp
- License: mit
- Created: 2025-05-16T10:12:01.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-06-04T23:35:04.000Z (7 months ago)
- Last Synced: 2025-06-05T04:58:26.963Z (7 months ago)
- Topics: bulma, form-builder, form-handling, form-validation, forms-generator, php-form, php-form-builder, php-forms
- Language: PHP
- Homepage:
- Size: 130 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# MintyPHP Forms
MintyPHP Forms is a powerful PHP form builder that enables you to create and validate forms without having to write a lot of boilerplate code.
## Features
- Bulma renderer, easily creating good looking forms
- Validation rules, such as validating email, string length and numeric comparisons
- Support checkbox arrays and multi selects
- Best practices: follows best practices, well-tested, object oriented code
- Extensible: create support for your favorite framework or form rendering style
## Installation
Run the following command to install MintyPHP Forms with Composer.
```bash
composer require mintyphp/forms
```
The package has no dependencies on other packages.
## Quick Start
Add the following to alias the most used classes in your PHP file:
```php
use MintyPHP\Form\Elements as E;
use MintyPHP\Form\Validator\Validators as V;
```
Now ensure all classes are (auto)loaded:
```php
require_once 'vendor/autoload.php';
```
And create a simple login form using:
```php
$form = E::form([
E::field(E::text('username'),E::label('Username'),[V::required('Username is required')]),
E::field(E::password('password'),E::label('Password')),
E::field(E::submit('Login')),
]);
```
Now render the form using:
```php
$form->render();
```
And the output is:
```html
Username
Password
```
Easy as that.
## Frontend frameworks
MintyPHP Forms has support for the Bulma framework right out of the box.
Just tell MintyPHP Forms that you want to use Bulmas style forms using:
```php
E::$style = 'bulma';
// create and render the login form
$form = E::form([
E::field(E::text('username')->required(), E::label('Username')),
E::field(E::password('password'), E::label('Password')),
E::field(E::submit('Login')),
]);
$form->render(true);
```
And the output will be form in the familiar Bulma style:
```html
Username
Password
```
In the future we will add support for other frameworks, such as bootstrap 5.
## Backend frameworks
This package has been tested with the MintyPHP backend framework. It can also be used with other frameworks as this package has no dependencies at all.
Although we don't recommend you to use MintyPHP Forms without a backend (or frontend) framework, it is certainly possible, see the full example.
## Full example
The Form object has the following data methods:
- **fill**: Fill the form with an array of data (e.g. $_POST)
- **validate**: Validate the form and add errors where needed
- **addErrors**: Add custom errors (after validation)
- **extract**: Extract the filled in form values
- **render**: Output the form with or without root element
These data methods are typically used on GET:
- GET:
- fill (with default values or from database)
- render
- POST:
- fill (from POST data)
- validate
- on success: extract
- on errors: render
You can see how these are used in the following full example:
[Full example - PHP code - Click here](example.php)
After filling in a password and clicking "Login" it renders as:
Interested? Read the rest of the [documentation](docs/overview.md).