PHP:FORM SERIES, PART 1: VALIDATORS & CLIENT-SIDE VALIDATION

Introduction Welcome to the prototypal conception of a newborn two-part series
on the PHP:Form scheme component. In this part, I module provide you an
introduction to PHP:Form, its features, and ground it is so useful.
I module also handle the integral validators that PHP:Form
supports. In the ordinal conception I module handle the more advanced
features of PHP:Form.

What is PHP:Form? PHP:Form is a (new) scheme component, developed
by TGP PHP Scripts (http://phpscripts.pallettgroup.com). It is
designed to hold you create forms with a aggregation inferior effort. When
you’re creating a newborn PHP script, you module doubtless hit to
create forms to earmark signaling to be entered. There is (almost) no
PHP playscript without forms, and forms commonly order solid
validation to attain trusty there are no section leaks. It would be
nice if those forms are reachable as well, but this ofttimes gets
forgotten.

We’ve every had to create forms again and again. And every time
we’ve had to indite those determination functions. I’m trusty you
remember… if (empty($blah)) { reflexion ‘Invalid’; }, etc. After a
while it becomes a rattling dull and unremarkable task, and most of
the instance we don’t do it right either. One of the hardest
things to do is to convey nonachievement messages, indicating what is
wrong, and allowing visitors to mend their mistakes, without
having to re-do the rank form. I utilised to exclusive verify them to
hit the back-button, after backward the errors, but this is
obviously a not-so-good artefact of doing it.

Thankfully, that’s where PHP:Form steps in. It handles every the
boring parts for you, and does it right as well.

PHP:Form has hold for integral validators, which effectuation you
only hit to ingest a ultimate HTML-like structure to add newborn validation
logic to a form. With these validators also comes automatic
client-side validation. All the needed JavaScript is created
for you, and there’s null you requirement to do. Another remarkable
feature of PHP:Form are so-called “formtypes”, which are
basically modify templates. These earmark you delimitate modify templates,
which crapper be re-used over and over again.

Let’s hit a fireman countenance at the determination conception of PHP:Form; the
validators.

Inbuilt Validators & Client-side Validation Before we countenance at
the validators, let’s prototypal countenance at the base PHP:Form syntax.
It has a rattling ultimate syntax, because it’s base HTML. To
create a newborn form, ingest the tags, aforementioned so:

 	… modify html goes here …

That’s every that is rattling necessary. But you staleness also verify the
form to display, using PHP, aforementioned so:

$_FORMS->display (’example’);

Those digit things are the exclusive things dead needed to
create and pass a newborn form. Of course, null module be
displayed ease because you haven’t created some signaling fields. To
see a ultimate modify in action, hit a countenance at demonstrate 1
(http://www.phpit.net/demo/phpform%20series/demos/demo1.php)

Let’s advise on to validators now. Validators are utilised to validate
form fields, and meet aforementioned the modify tags, they are ultimate html,
for example:

Your nonachievement message
here

You crapper either locate validators in between the modify tags, or
outside the modify tags. If you locate them right the modify tags
you staleness verify the modify study (using the ‘form’ attribute).

A ultimate modify with a validator would countenance aforementioned this:

// Include PHP:Form allow ('../phpform.php');

// solon form: ?>

required="true">

Please
enter your name

Name:
value="Go!" />

validate (’example’) == true) { // Show
POST’ed values echo ‘ 

'; 	print_r ($_POST); 	echo '

‘;
} added { // Display modify $_FORMS->display (”example”); } ?>
View springy demo
(http://www.phpit.net/demo/phpform%20series/demos/demo2.php)

As you crapper wager in the cipher we created a validator that has the
required concept ordered to “true”. That effectuation that this validator
just checks whether the continuance of the signaling earth isn’t empty.

There are 5 assorted kinds of validators: - Required: they are
used to attain trusty an signaling earth isn’t empty, aforementioned I just
demonstrated.

Please modify in
something

- Numeric: they are utilised to attain trusty an signaling earth only
contains numbers, and null else.

Please modify in
something

- Regex: they crapper be utilised to specifiy a lawful countenance that
an signaling earth staleness match.

Please start ‘test’
only.

- Callback: asking validators crapper verify a asking function
that is separate on the server-side. That asking duty is passed
the continuance of the signaling field, and the duty staleness convey true
or false. This is utilised for rattling modern determination (and it’s
likely you module scarce ever ingest the asking validator)

Not a valid
e-mail address.validator>

- Name: study validator crapper be utilised to pass a communication or error
only when you poverty to. They crapper exclusive be shown when you manually
show them using the trigger_error (’form’, ‘errorname’) method.

This is my custom
error!

Then in PHP: trigger_error (’example’, ‘mymsg’);
?>

When using validators, you module belike poverty to analyse if a form
validates or not. To do this, ingest the validate() method, as seen
in demonstrate 2:

If ($_FORMS->validate(’example’) == true) { echo ‘It
validates!’; } added { echo It ‘doesn\’t validate!’; }

Client-Side Validation PHP:Form also automatically generates
client-side determination (JavaScript) when using validators. It
natively supports the required, denotive and regex validators,
but it doesn’t (fully) hold the asking validator. This
isn’t rattling doable either, because the asking validator
points to a duty on the server-side. But if you create a
JavaScript duty with the aforementioned study as the asking function,
it module work, and it module separate the JavaScript duty you
created. This gives you enthusiastic power, and effectuation you crapper even
using modern JavaScript functions and Ajax to reassert data.

If you would aforementioned to wager the client-side determination in action,
have a countenance at demonstrate 2 again, and attain trusty you hit JavaScript
enabled. You module belike attending how alacritous the errors are
returned, and that no change happens at all. That’s the
client-side validation.

Conclusion In this prototypal conception of the PHP:Form program I have
shown you what PHP:Form is: an extremely elegant PHP form
component, that is rattling multipurpose for antiquity scheme forms. I have
been using it myself today for a some months, and I ease can’t get
over how enthusiastic it is. It has rattling simplified things, and I can
focus on the essential stuff. If you’re ease in doubt, hit a
look at the PHP:Form creation tender for more aggregation and
demo’s (http://phpscripts.pallettgroup.com/phpform/?ref=phpit).

I hit also shown you just what validators are, and the
different types. Validators are the most essential conception of
PHP:Form, and you module belike ingest them in every form. You can
some rattling engrossing things with them, and when you consortium a
few validators it’s doable to create a extremely bonded form.

In the incoming conception I module hit a countenance at “form types”, the form
templates of PHP:Form. I module also hit a countenance at setting
default values, using the set_value() method of PHP:Form.

If you’re fascinated in purchase PHP:Form, don’t block to use
the primary PHPit voucher code: phpit PHP:Form creation page
(http://phpscripts.pallettgroup.com/phpform/?ref=phpit)

This entry was posted on Monday, March 10th, 2008 at 11:42 am and is filed under CGI. You can follow any responses to this entry through the RSS 2.0 feed. Both comments and pings are currently closed.

12 GOLDEN RULES FOR EVERY DOG OWNER »

Comments are closed.