README.md

Berlioz Form

Berlioz Form is a PHP library to manage your forms.

Installation

Composer

You can install Berlioz Form with Composer, it's the recommended installation.

$ composer require berlioz/form

Dependencies

• PHP ^8.0
• Packages:
  • berlioz/helpers
  • psr/http-message

Description

3 types of elements exists in Berlioz Form:

• AbstractType: it's a form control
• Group: represents an object in OOP
• Collection: represents a collection of AbstractType or Group

Input types available:

• Button
• Checkbox
• Choice
• Date
• DateTime
• Email
• File
• Hidden
• Month
• Number
• Password
• Range
• Reset
• Search
• Submit
• Tel
• Text
• TextArea
• Time
• Url
• Week

Usage

Form creation

Constructor of Form object accept 3 parameters:

• Name of form
• Mapped object
• Array of options

Example:

$form = new Form('my_form', null, ['method' => 'post']);

Declare form control

add method accept 3 parameters:

• Name of control (must be the same that the mapped element)
• Type (class name or object)
• Array of options

Options are different between controls.

Example:

$form->add('my_control', Text::class, ['label' => 'My control']);

Handle

Berlioz Form implements PSR-7 (HTTP message interfaces). You must give the server request to the handle method.

$form = new Form('my_form', null, ['method' => 'post']);
// ...

$form->handle($request);

if ($form->isSubmitted() && $form->isValid()) {
    // ...
}

Group

Example for an postal address:

$addressGroup = new Group(['type' => 'address']);
$addressGroup
    ->add('address', Text::class, ['label' => 'Address'])
    ->add(
        'address_next',
        Text::class,
        ['label' => 'Address (next)',
         'required' => false]
    )
    ->add('postal_code', Text::class, ['label' => 'Postal code'])
    ->add('city', Text::class, ['label' => 'City']);

$form->add('address', $addressGroup);

Collection

Example for a list of addresses:

// Create group
$addressGroup = new Group(['type' => 'address']);
$addressGroup
    ->add('address', Text::class, ['label' => 'Address'])
    ->add(
        'address_next',
        Text::class,
        ['label' => 'Address (next)',
         'required' => false]
    )
    ->add('postal_code', Text::class, ['label' => 'Postal code'])
    ->add('city', Text::class, ['label' => 'City']);

// Create collection
$collection = new Collection([
    'prototype' => $addressGroup,
    'data_type' => ArrayObject::class
]);

// Add collection to form
$form->add('addresses', $collection);