Source code in Qf2Valid.php

To see how this is used return to this tutorial index.

<?php
    // This generates a simple quickform that validates form data, both client and server side.
    // You should look at QfSimple.php before you try to understand this file.

    // Copyright (c) 2009, Parliament Hill Computers (www.phcomp.co.uk). Author: Alain D D Williams (addw@phcomp.co.uk).
    // You may used this file as the basis your own (or organisation's/company's) project (under whatever
    // licence that you see fit), but may not claim ownership or copyright of the substantially unmodified file.
    // This file is made available in the hope that it is useful, there is no warranty at all, use at your own risk.
    // SCCS: @(#)Qf2Valid.php	1.4 10/21/13 15:08:34

?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
 <head>
    <title>Quickform Demo</title>
    <link rel="stylesheet" type="text/css" href="/DefaultStyle.css">
    <link rel="stylesheet" type="text/css" href="Qf2Style.css">
 </head>

 <body>
  <!-- A standard page header -->
  <div style='position : absolute;text-align: left;top:10px;'>
   <a href='/'><img src='/Images/kite_40_83_trans.gif' width="40" height="83" alt="Parliament Hill Computers Ltd" style="border-width: 0;"></a>
  </div>
  <div style='top:0px;margin:0px auto;text-align: center; font-size:40pt; '>
   Simple Quickform
  </div>
  <p>
<?php
    // Check that the title is valid.
    // Don't want 0 since that is the one that asks for the title to be selected
    function CheckTitle($t)
    {
        global $Titles;
        return $t > 0 && isset($Titles[$t]);
    }

    // Check that the first name is one of an approved list, callback function used in FirstName:
    function checkFNfunc($name)
    {
	$OKlist = array('John', 'Bill');	// A very simple approved list
	return strcmp(array_search($name, $OKlist), '');
    }

    require_once "HTML/QuickForm2.php";

    // Create a GET form with the name QfDemo:
    $form = new HTML_QuickForm2('QfDemo', 'get');

    // addElement() adds a display line or an input field to the form.
    // The first argument is a standard html type (text, checkbox, hidden, ...) or a custom
    // type (header, group, ...). Other arguments depend on the type.
    // $form->addElement('header', 'DemoHeader', 'Quickform Demo');
    $form->addElement('hidden', 'DemoHeader')->setValue('Quickform Demo');
    // Another way of doing this:
    // $form->addElement('hidden', 'DemoHeader', array('value' =>'Quickform Demo'));

    // When the form has been filled in, trim spaces from all fields:
    $form->addRecursiveFilter('trim');

    // Add a drop down select list:
    $Titles = array('Please select', 'Mr', 'Mrs', 'Miss', 'Dr');
    // $form->addElement('select', 'Title', 'Title', $Titles);
    $title = $form->addElement('select', 'Title', null, array('label' => 'Title', 'options' => $Titles));
    $title->addRule('required', 'A title must be set');
    $title->addRule('regex', 'A title must be from the list', '/^\d+$/');    // numeric
    $title->addRule('callback', 'A title must be from the list', 'CheckTitle');

    // Add a text field, the form element name is 'FirstName' with a title 'First name'
    // $form->addElement('text', 'FirstName', 'First name');
    $first = $form->addElement('text', 'FirstName', null, array('label' => 'First name'));
    // $form->addRule('FirstName', 'First name is required', 'required', null, 'client');
    $first->addRule('required', 'First name is required');

    // The rule checkfn is to be implemented by calling checkFNfunc(), we apply that
    // to the FirstName field - this is a server side only check
    // $form->registerRule('checkfn', 'callback', 'checkFNfunc');
    // $form->addRule('FirstName', 'First name is not in approved list', 'checkfn');
    $first->addRule('callback', 'First name is not in approved list', 'checkFNfunc');

    // A client side check is made that LastName has been given a value.
    // All client side checks are repeated server side -- it is not safe to rely on client only checks
    // $form->addElement('text', 'LastName', 'Last name');
    $last = $form->addElement('text', 'LastName', null, array('label' => 'Last name'));
    // $form->addRule('LastName', 'Last name is required', 'required', null, 'client');
    $last->addRule('required', 'Last name is required');

    // Age is required (must be filled in) and must be numeric.
    // Specify the size - people don't get very old!
    // $form->addElement('text', 'Age', 'Age');
    // $form->addRule('Age', 'Age is required', 'required');
    // $form->addRule('Age', 'Age must be numeric', 'numeric', null, 'client');
    $age = $form->addElement('text', 'Age', array('maxlength' => 3, 'size' => 3), array('label' => 'Age'));
    $age->addRule('required', 'Age is required');
    $age->addRule('regex', 'Age must be numeric', '/^\d+$/');

    // Telephone number is checked with a regular expression, but is not required:
    // $form->addElement('text', 'Telephone', 'Telephone number');
    // $form->addRule('Telephone', 'The phone number must start with 0, or international ones with +',
    //         'regex', '/^[0+]/', 'client');
    $phone = $form->addElement('text', 'Telephone', null, array('label' => 'Telephone number'));
    $phone->addRule('regex', 'The phone number must start with 0, or international ones with +',
		'/^[0+]/');

    // Standard buttons (no break space label to get alignment):
    // $form->addElement('reset', 'Clear', 'Clear');
    // $form->addElement('submit', 'Submit', 'Submit');
    $form->addElement('reset', 'Clear');
    $form->addElement('submit', 'Submit', array('value' => 'Press to Submit'));

    // First time round this results in false, remember that, as is common in php, this
    // script is used both to generate the form and to process the results.
    if ($form->validate()) {
        # Get here when the form has been filled in and validation checks passed
        // $form->freeze();	// If we want the form redisplayed in the way that the user entered it
				// but you need to do another display()
        $res = $form->getValue();
	echo "Title = " . htmlspecialchars($res['Title']) . " = '" . $Titles[$res['Title']] . "'<br>\n";
	echo "FirstName = " . htmlspecialchars($res['FirstName']) . "<br>\n";
	echo "LastName = " . htmlspecialchars($res['LastName']) . "<br>\n";
	echo "Age = " . htmlspecialchars($res['Age']) . "<br>\n";
	echo "Telephone = " . htmlspecialchars($res['Telephone']) . "<br>\n";
    } else {
        // $form->setDefaults(array('FirstName'=>'John', 'LastName'=>'Bloggs')); // only does something with empty form
        $form->addDataSource(new HTML_QuickForm2_DataSource_Array(
            array('FirstName'=>'John', 'LastName'=>'Bloggs'))); // only does something with empty form

	echo $form;
    }
?>

  <p class="notes">
   This is a simple form, fill in some values and press <i>Submit</i>.
  <p>
   There is some validation on this form:
  <ul>
   <li> Firstname: it must have a value; server side: the value 'Bill' or 'John'
   <li> Lastname: it must have a value
   <li> Age: it must have a value and be numeric
   <li> Telephone: it must start '0' or '+'
  </ul> 

  <p style="font-size: x-large; font-weight: bold;">
   Return to this <em><a href='index.php'>tutorial index</a></em>.
  </p>
 </body>
</html>

Return to this tutorial index.