Class: MailFormRule

[line 98]
Handles validation of form fields for the MailForm package.

Rule Format:

type "value"

Validation Rules:

• is "value"
• contains "some value"
• regex "some regex"
• equals "anotherfield"
• empty
• length "6+" (eg: 6, 6+, 6-12, 12-)
• gt "value"
• ge "value"
• lt "value"
• le "value"
• func "func_name" (or function "func_name")
• unique "dbtablename.columnname"
• exists "path/to/directory"
• numeric
• email
• header

Note: Any rule may be negated by preceeding it with a 'not', for example:

• not empty
• not contains "some value"

New in 1.2:

• Added a 'unique' rule, which compares the value against a specified field in a database table.
• Fixed a bug in the 'length' rule evaluation.

New in 1.4:

• Added 'exists' and 'not exists' rules, which checks if the value given exists (or doesn't) as a file name in the path provided by the rule.

New in 1.6:

• Abstracted 'not empty' and 'not exists' so that 'not' now negates any rule, and 'empty' and 'exists' are ordinary rules now. This required the addition of two new methods, _validate(), and _validateNegated(), and a new $negated property.

New in 1.8:

• Added warning notices when rules fail the syntax parser.
• Added new rule type "numeric", which checks the data type of the value to see whether it is a valid number or not.

New in 2.0:

• New rules: 'email' and 'header' which help prevent form abuse by spammers. 'email' checks that it is a valid email, and 'header' checks that there are no newlines in the field so that it can't pass extra headers to your mail() function.

1     <?php
2     
3      $widget = new MF_Widget ('name');
4      $widget->addRule ('is "foo"', 'You must enter "foo" to pass!');
5     
6      // note: MailFormRule is never accessed directly.
7     
8      ? >

Tags:

$msg =

[line 121]

The error message for this rule.

Tags:

$name =

[line 113]

The name of the widget.

Tags:

$negated =  false

[line 148]

If a 'not' is present at the start of the rule, this will be set to true, otherwise false.

Tags:

$rule =

[line 105]

The original unmodified rule definition.

Tags:

$type =

[line 130]

The rule type. Can be 'is', 'contains', 'regex', 'not empty', 'equals', 'length', 'gt', 'ge', 'lt', 'le', or 'func'.

Tags:

$value =

[line 139]

The rule value. This corresponds to the part of the rule in double quotes (ie. type "value").

Tags:

---

constructor MailFormRule [line 159]

---

method parseRuleStatement [line 177]

---

method validate [line 204]

---

method _validate [line 223]

---

method _validateNegated [line 324]