CGI::Validate 2.000

CGI::Validate is an advanced CGI form parser and type validation. SYNOPSIS use CGI::Validate; # GetFormData() only use CGI::Validate qw(:standard); # Normal use use CGI::Validate qw(:subs); # Just functions use CGI::Validate qw(:vars); # Just exception vars ## If you dont want it to check that every requested ## element arrived you can use this. But I dont recommend it ## for most users. $CGI::Validate::Complete = 0; ## If you dont care that some fields in the form dont ## actually match what you asked for. -I dont recommend ## this unless you REALLY know what youre doing because this ## normally meens youve got typos in your HTML and we cant ## catch them if you set this. ## $CGI::Validate::IgnoreNonMatchingFields = 1; my $FieldOne = Default String; my $FieldTwo = 8; my $FieldThree = some default string; my @FieldFour = (); ## For multi-select field my @FieldFive = (); ## Ditto my $EmailAddress= ; ## Try... my $Query = GetFormData ( FieldOne=s => $FieldOne, ## Required string FieldTwo=i => $FieldTwo, ## Required int FieldThree => $FieldThree, ## Auto converted to the ":s" type FieldFour=s => @FieldFour, ## Multi-select field of strings FieldFive=f => @FieldFive, ## Multi-select field of floats Email=e => $EmailAddress, ## Must look like an email address ) or do { ## Catch... (wouldnt you just love a case statement here?) if (%Missing) { die "Missing form elements: " . join ( , keys %Missing); } elsif (%Invalid) { die "Invalid form elements: " . join ( , keys %Invalid); } elsif (%Blank) { die "Blank form elements: " . join ( , keys %Blank); } elsif (%InvalidType) { die "Invalid data types for fields: " . join ( , keys %InvalidType); } else { die "GetFormData() exception: $CGI::Validate::Error"; } }; ## If you only want to check the form data, but dont want to ## have CGI::Validate set anything use this. -You still have full ## access to the data via the normal B object that is returned. use CGI::Validate qw(CheckFormData); # not exported by default my $Query = CheckFormData ( FieldOne=s, FieldTwo=i, FieldThree, FieldFour, FieldFive, Email, ) or do { ... Same exceptions available as GetFormData above ... }; ## Need some of your own validation code to be used? Here is how you do it. addExtensions ( myType => sub { $_[0] =~ /test/ }, fooBar => &fooBar, i_modify_the_actual_data => sub { if ($_[0] =~ /test/) { ## data validation $_[0] = whatever; ## modify the data by alias return 1; } else { return 0; } }, ); my $Query = GetFormData ( foo=xmyType => $foo, bar=xfooBar => $bar, cat=xi_modify_the_actual_data => $cat, ); ## Builtin data type checks available are: s string # Any non-zero length value w word # Must have at least one w char i integer # Integer value f float # Float value e email # Must match m/^s*]+@[^@.<>]+(?:.[^@.<>]+)+>?s*$/ x extension # User extension type. See EXTENSIONS below. Basicly a blending of the CGI and Getopt::Long modules, and requires the CGI module to function. The basic concept of this module is to combine the best features of the CGI and Getopt::Long modules. The CGI module is great for parsing, building, and rebuilding forms, however it lacks any real error checking abilitys such as misspelled form input names, the data types received from them, missing values, etc. This however, is something that the Getopt::Long module is vary good at doing. So, basicly this module is a layer that collects the data using the CGI module and passes it to routines to do type validation and name consistency checks all in one clean try/catch style block. The syntax of GetFormData() is mostly the same as the GetOptions() of Getopt::Long, with a few exceptions (namely, the handling of exceptions) . See the VALUE TYPES section for detail of the available types, and the EXCEPTIONS section for exception handling options. If given without a type, fields are assumed to be type ":s" (optional string), which is normally correct. If successful, GetFormData() returns the CGI object that it used to parse the data incase you want to use it for anything else, and undef otherwise. If you only want to do value type and name validation, use CheckFormData() instead with a field=type list. -See the SYNOPSIS for an example..

Requirements:	No special requirements
Platforms:	Linux
Keyword:	Cgi Form,  Cgivalidate,  Data,  Dont,  Fieldfive,  Fieldfour,  Fieldthree,  Fieldtwo,  Form,  Getformdata,  Module,  Type,  Want To
Users rating:	0/10