View source for JForm/validate

===Description===
Method to validate form data.



<! removed transcluded page call, red link never existed >

===Syntax===
<source lang="php">validate($data, $limit=null)</source>

 {| class="wikitable"
|-
!Parameter Name
!Default Value
!Description
|-
| $data
| 
|  $data An array of field values to validate. 
|-
| $limit
| null
|  $limit An option group to limit the validation to. 
|}

===Returns===
mixed Boolean on success,  on error. 

===Defined in===
libraries/joomla/form/form.php
===Importing===
<source lang="php">jimport( 'joomla.form.form' );</source>

===Source Body===
<source lang="php">
public function validate($data, $limit = null)
{
        $return = true;
        $data   = (array)$data;

        // Check if the group exists.
        if ($limit !== null && !isset($this->_groups[$limit])) {
                // The group that was supposed to be filtered does not exist.
                return new JException(JText::sprintf('LIBRARIES FORM VALIDATOR GROUP NOT FOUND', $limit), 0, E_ERROR);
        }

        // Get a validator object.
        jimport('joomla.form.formvalidator');
        $validator = new JFormValidator();

        // Iterate through the groups.
        foreach ($this->_groups as $group => $fields) {
                // Filter if no group is specified or if the group matches the current group.
                if ($limit === null || ($limit !== null && $group === $limit)) {
                        // If the group name matches the name of a group in the data and the value is not scalar, pass the group.
                        if (isset($data[$group]) && !is_scalar($data[$group]) && !is_resource($data[$group])) {
                                $results = $validator->validate($this->_groups[$group], $data[$group]);
                        } else {
                                // Run the validator over the group.
                                $results = $validator->validate($this->_groups[$group], $data);
                        }

                        // Check for a error.
                        if (JError::isError($results)) {
                                return new JException($results->getMessage(), 0, E_ERROR);
                        }

                        // Check the validation results.
                        if (count($results)) {
                                // Get the validation messages.
                                foreach ($results as $result) {
                                        if (JError::isError($result) && $result->get('level') === E_WARNING) {
                                                $this->setError($result);
                                                $return = false;
                                        }
                                }
                        }
                }
        }

        return $return;
}
</source>


<! removed transcluded page call, red link never existed >

===Examples===
<CodeExamplesForm />
<dpl>
 noresultsheader=\n
 category=validate
 category=JForm
 category=CodeExample
 category=MethodExample
 include=*
 format= ,,,
</dpl>
[[Category:Archived pages API16]]