Form Class

<?php
 
/*
 * phpForm class for create and validate forms
 *
 * @package phpForm
 * @author Armando Monroy aka Ratzo
 * @version 0.5
 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
 *
 */
class Form {
 
	/*
	 * Stores number of fields that failed validation
	 * @var int
	 */
	protected $errorCount = 0;
 
	/*
	 * Array containing all the field that failed validation and their error messages.
	 * @var array
	 */
	protected $errors = array();
 
	/*
	 * Array containing all the validation rules that should be applied.
	 * @var array
	 */
	protected $rules = array();
 
	/*
	 * Set the validation rules
	 * @param array $rules
	 */
	public function setRules($rules) {
 
		if (!empty($rules)) {
			$this->rules = $rules;
		}
 
	}
 
	/*
	 * Creates an html form tag
	 *
	 * @param string $action URL of the action
	 * @param array $options Optional options like type
	 *
	 * @return string
	 */
	public function create($action = null, $options = array()) {
 
		if (empty($action)) {
			$action = $_SERVER['PHP_SELF'];
		}
 
		if (!empty($options)) {
			$id = array_key_exists('id', $options) ? ' id ="' . $options['id'] . '"' : null;
		}
 
		$out = '<form method="post" action="' . $action . '"';
		if (array_key_exists('type', $options) && ($options['type'] == 'file')) {
			$out .= ' enctype="multipart/form-data"';
		}
		$out .= $id . '>';
		echo $out;
		return true;
 
	}
 
	/*
	 * Creates an html closing form tag
	 *
	 * @param string $message Optional parameter wich display a submit button if present
	 */
	public function end($message = null) {
 
		$out = null;
 
		if (!empty($message)) {
			$out = '<p class="submit"><input type="submit" value="' . $message . '" /></p>';
		}
 
		$out .= '</form>';
		echo $out;
		return true;
 
	}
 
	/*
	 * Creates an html input tag
	 *
	 * @param string $name
	 * @param array $options
	 */
	public function input($name, $options = array()) {
 
		if (array_key_exists($name, $this->errors)) {
			$out = '<p class="error">';
		} else {
			$out = '<p>';
		}
 
		$type = 'text';
 
		if (!empty($options)) {
			if (array_key_exists('type', $options)) { $type = $options['type']; }
			$id = array_key_exists('id', $options) ? ' id ="' . $options['id'] . '"' : ' id="' . $name . '"';
			if (array_key_exists('label', $options)) {
				$out .= '<label for="' . $name . '">' . $options['label'] . '</label>';
			}
		}
 
		$out .= '<input type="' . $type . '" name="' . $name . '"' . $id;
		if (array_key_exists($name, $_POST)) {
			$out .= ' value="' . $_POST[$name] . '" ';
		}
		$out .= ' />';
		if (array_key_exists($name, $this->errors)) {
			$out .= '<span class="note">' . $this->errors[$name] . '</span>';
		}
		$out .= '</p>';
		echo $out;
		return true;
 
	}
 
	/*
	 * Creates a html textarea tag
	 *
	 * @param string $name
	 * @param array $options
	 */
	public function textarea($name, $options = array()) {
 
		if (array_key_exists($name, $this->errors)) {
			$out = '<p class="error">';
		} else {
			$out = '<p>';
		}
 
		if (!empty($options)) {
			$id = array_key_exists('id', $options) ? ' id ="' . $options['id'] . '"' : ' id="' . $name . '"';
			if (array_key_exists('label', $options)) {
				$out .= '<label for="' . $name . '">' . $options['label'] . '</label>';
			}
		}
 
		$out .= '<textarea cols="50" rows="10" name="' . $name . '"' . $id . '>';
		if (array_key_exists($name, $_POST)) {
			$out .= $_POST[$name];
		}
		$out .= '</textarea>';
		if (array_key_exists($name, $this->errors)) {
			$out .= '<span class="note">' . $this->errors[$name] . '</span>';
		}
		$out .= '</p>';
		echo $out;
		return true;
 
	}
 
	/*
	 * Creates a html select tag
	 *
	 * @param string $name The name of the field
	 * @param array $values An array containing the options of the select tag. Every element of the array needs to have two elements value and label
	 * @param array $options An array with aditional options for the select tag
	 */
	public function select($name, $values, $options = array()) {
 
		if (array_key_exists($name, $this->errors)) {
			$out = '<p class="error">';
		} else {
			$out = '<p>';
		}
 
		if (!empty($options)) {
			$id = array_key_exists('id', $options) ? ' id ="' . $options['id'] . '"' : ' id="' . $name . '"';
			if (array_key_exists('label', $options)) {
				$out .= '<label for="' . $name . '">' . $options['label'] . '</label>';
			}
		}
		$out .= '<select name="' . $name . '"' . $id . '>';
		foreach ($values as $option) {
			$out .= '<option value="' . $option['value'];
			if ($_POST[$name] == $option['value']) {
				$out .= '" selected="selected">';
			} else {
				$out .= '">';
			}
			$out .= $option['label'] . '</option>';
		}
 
		$out .= '</select></p>';
		echo $out;
		return true;
 
	}
 
	// Validation Rules
 
	/*
	 * Validates if the field is not empty
	 * 
	 * @param string $field
	 * @param string $message
	 */
	private function notEmpty($field = null, $message) {
 
		if (!empty($field)) {
			if (empty($_POST[$field])) {
				$this->errorCount++;
				$this->errors[$field] = $message;
			}
		}
 
	}
 
	/*
	 * Validates if the field contains only numbers
	 * 
	 * @param string $field
	 * @param string $message
	 */
	private function isNumeric($field = null, $message) {
 
		if (!empty($field)) {
			if (!ctype_digit($_POST[$field])) {
				$this->errorCount++;
				$this->errors[$field] = $message;
			}
		}
 
	}
 
	/*
	 * Validates if the field contain only alphabetic characters
	 *
	 * @param string $field
	 * @param string $message
	 */
	private function isAlphabetic($field = null, $message) {
 
		if (!empty($_POST[$field])) {
			if (!ctype_alpha($field)) {
				$this->errorCount++;
				$this->errors[$field] = $message;
			}
		}
 
	}
 
	/*
	 * Validates if the field contain only alphanumeric characters
	 *
	 * @param string $field
	 * @param string $message
	 */
	private function isAlphaNumeric($field = null, $message) {
 
		if (!empty($_POST[$field])) {
			if (!ctype_alnum($field)) {
				$this->errorCount++;
				$this->errors[$field] = $message;
			}
		}
 
	}
 
	/*
	 * Validates if the field is a valid email addresss
	 * 
	 * @param string $field
	 * @param string $message
	 */
	private function validEmail($field = null, $message) {
 
		if (!empty($field)) {
			if (!filter_var($_POST[$field], FILTER_VALIDATE_EMAIL)) {
				$this->errorCount++;
				$this->errors[$field] = $message;
			}
		}
 
	}
 
	/*
	 * Validates if the field is a valid URL
	 * 
	 * @param string $field
	 * @param string $message
	 */
	private function validURL($field = null, $message) {
 
		if (!empty($field)) {
			if (!filter_var($_POST[$field], FILTER_VALIDATE_URL)) {
				$this->errorCount++;
				$this->errors[$field] = $message;
			}
		}
 
	}
 
	/*
	 * Validates if the uploaded file is a valid type file
	 * 
	 * @param string $field
	 * @param string $message
	 * @param array $options
	 */
	private function validType($field = null, $message, $options = array()) {
 
		$type = $_FILES[$field]['type'];
 
		if (!empty($field)) {
			if (!in_array($type, $options)) {
				$this->errorCount++;
				$this->errors[$field] = $message;
			}
		}
 
	}
 
	/*
	 * Executes all the validation rules
	 */
	private function validate() {
 
		if (!empty($this->rules)) {
			foreach ($this->rules as $field => $rule) {
				if (!empty($rule['rule'])) {
					if (!empty($rule['options'])) {
						$this->{$rule['rule']}($field, $rule['message'], $rule['options']);
					} else {
						$this->{$rule['rule']}($field, $rule['message']);
					}
				}
 
			}
		}
 
	}
 
	/*
	 * Returns true if all the fields pass validation
	 *
	 * @return true|false
	 */
	public function passValidation() {
 
		$this->validate();
 
		if ($this->errorCount == 0) {
			return true;
		}
 
		return false;
 
	}
 
}
 
?>