simettric/simple-form

A simple way to working with forms in php.

SimpleForm

, _(*1)

, _(*2)

A simple way to working with forms in php., _(*3)

Install

composer require simettric/simple-form

Creating Forms

With the FormBuilder

$builder = new FormBuilder($config);

$builder->create("message")
        ->add("firstName")
        ->add("lastName")
        ->add("email",   new InputTypeField(array("type"=>"email", "validators"=> new Email() )))
        ->add("subject", new ChoiceField(array("choices"=>array()))) //InArray is implicit unless we configure our own ChoiceValidator in the "validators" key
        ->add("message", new TextareaField(array(
              "validators" => array(
                    new NotEmpty(), 
                    new StringLength(array("min"=>4))
        )));

$data_array = array("firstName"=>"John");
$form       = $builder->getForm($data_array);

Creating a Form class

class MessageForm extends AbstractForm{

    public function configure(FormBuilder $builder)
    {


        $builder->add("firstName")
                ->add("lastName")
                ->add("email",   new InputTypeField(array("type"=>"email", "validators"=> new Email() )))
                ->add("subject", new ChoiceField(array("choices"=>array()))) //ChoiceValidator is implicit unless we configure our own ChoiceValidator in the "validators" key
                ->add("message", new TextareaField(array(
                                               "validators" => array(
                                                     new NotEmpty(), 
                                                     new StringLength(array("min"=>4))
                                         )))

    }


    public function getName()
    {
        return 'message';
    }


}

$data_array = array("firstName"=>"John");
$form       = new MessageForm($data_array, new FormBuilder());

Validating Forms

SimpleForm uses Zend Validator to manage the fields validation in its forms., _(*4)

$builder->add("message", new TextareaField(array(
                              "label"      => "Write your message",
                              "validators" => array(
                                    new NotEmpty(), 
                                    new StringLength(array("min"=>4)
                              )))
);

In your controller, you can bind the request data and check if the form is valid, _(*5)

$form->bind( $_POST["message"] );

if($form->isValid()){

   echo $form->getValue("firstName");

}

Rendering Forms

Outputs:, _(*6)

  
  firstName
  
  Error message

*Note: you can return a null value in your Form::getName() method in order to set a clean input name like:, _(*7)

  <input type="text" name="firstName" required="required">

*Note2: using Field::getRow("label") method, the result is similar but with a custom label., _(*8)

getRow('Text for the label tag') ?>

You can render each HTML tag individually:, _(*9)

getLabelTag() ?>

getInputTag(array("class"=>"the attribute value")) ?>

getErrorTag() ?>

Also, you can get an array of error values, _(*10)

getErrorArray() as $error ){} ?>