tentwofour/sf2-form

Provides data transformers for Symfony2 Forms

1.2.1 2021-02-25 21:45 UTC

Requires

• php: ^7.0
• symfony/form: ^3.0|^4.0
• tentwofour/formatter: ^1.1

Requires (Dev)

• phpunit/phpunit: ^6.0

MIT

• Blair D. Patterson

• symfony
• form
• ten24
• tentwofour
• datatransformer

README

Symfony2 Form extensions

DataTransformers

PhoneNumberViewTransformer

Transforms phone numbers from human-formatted (ie. [phone]) to db-formatted (ie. [phone]) values. Database field (MySQL) of varchar(15) is sufficient to store phone numbers

Transform

$pn = '[phone]';
$f = new PhoneNumberViewTransformer();
$formatted = $f->transform($pn);
echo $formatted;
// Outputs: '[phone]'

ReverseTransform

$pn = '+(11) 123-456-7890';
$f = new PhoneNumberViewTransformer();
$formatted = $f->reverseTransform($pn);
echo $formatted;
// Outputs: '[phone]';

Use with Symfony2 Form

// src/AppBundle/Form/ProfileType.php

use Symfony\Component\Form\AbstractType;
use Ten24\Component\Form\Extension\DataTransformer;

class ProfileType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder,
                              array $options)
    {
        $transformer = new PhoneNumberViewTransformer();
        // Optionally change the display format, see PhoneNumberFormatter for all possible values
        // $transformer->setDisplayFormat(PhoneNumberFormtter::FORMAT_DOTTED)

        $builder->add($builder
                              ->create('phoneNumber1',
                                       null,
                                       [
                                           'required' => true,
                                           'attr'     => [
                                               'placeholder' => 'eg. 1.123.456.7890 or 1 [phone]'
                                           ]
                                       ])
                              ->addViewTransformer($transformer)
        );

        // ...
    }

PostalCodeViewTransformer

Transforms a postal code from human-formatted (ie. S4T 3P9) to db-formatted (ie. S4T3P9) values. Database field (MySQL) of varchar(15) is sufficient to store postal codes (North America)

Supports North America postal codes only.

Transform

$postalCode = 'S4p0H0';
$formatter = new PostalCodeViewTransformer();
$formatted = $formatter->transform($postalCode);
echo $formatted;
// Outputs: 'S4P 0H0'

Reverse Transform

$postalCode = 'S4p 0H0 ';
$formatter = new PostalCodeViewTransformer();
$formatted = $formatter->reverseTransform($postalCode);
echo $formatted;
// Outputs: 'S4P0H0'

Use with Symfony2 Form

// src/AppBundle/Form/ProfileType.php

use Symfony\Component\Form\AbstractType;
use Ten24\Component\Form\Extension\DataTransformer;

class ProfileType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder,
                              array $options)
    {
        $transformer = new PostalCodeViewTransformer();

        $builder->add($builder
                              ->create('postalCode',
                                       null,
                                       [
                                           'required' => true,
                                       ])
                              ->addViewTransformer($transformer)
        );

        // ...
    }