jenwachter/html-form

A PHP library designed to make creating, validating, and maintaining forms easier.

0.7 2017-07-13 16:12 UTC

README

Hate writing and validating HTML forms? Me too. The HTML Form library was designed to make creating, validating, and maintaining forms easier.

Requirements

  1. PHP >= 5.3.2
  2. Sessions enabled (if you want the form fields to repopulate)

Installation

Via Composer:

{
    "require": {
        "jenwachter/html-form": "0.3.*"
    }
}

Documentation

See below for basic usage or see the wiki.

Basic Usage


// Create the form
$form = new \HtmlForm\Form();

// Add a fieldset
$fieldset = $form->addFieldset("Contact info");

// Add some form fields
$fieldset->addTextbox("name", "Your name", array("required" => true))
	->addEmail("email", "Your email", array("required" => true))
	->addNumber("age", "Your age")
	->addSelect("gender", "Your gender", array("male", "female"));

$form->addSubmit("submit", "Submit");

// Render the form
$form->display();

// Validate the form
if (isset($_POST["submit"]) && $form->isValid()) {
    // continue processing the form as you see fit
}

Changelog

  • 0.7

    • Moved location of help text to after label for accessibility
  • 0.6.2

    • Added htmlspecialchars method
  • 0.6.1

    • Bugfix
  • 0.6

    • Added striptags sanitizer
  • 0.5

    • Moved validation functions into element classes.
    • Added sanitizer class
  • 0.4

    • Removed $_GET support
    • Improved unit tests
  • 0.3.3

    • Removed label from honeypot
  • 0.3.2

    • Removed rendering of global beforeElement and afterElement content before and after bits of HTML.
  • 0.3.1

    • Bug fix
  • 0.3

    • Added a flag that allows option form fields to use the numeric keys of the options array as the option field's value. Issue #13
  • 0.2

    • Method name changes in HtmlForm\Form:
      • render() is now display()
      • compileForm() is now render()
  • 0.1

    • Initial release