Source for file TextBase.php

Documentation is available at TextBase.php

1: <?php
2:
3: /**
4: * Nette Framework
5: *
6: * Copyright (c) 2004, 2009 David Grudl (http://davidgrudl.com)
7: *
8: * This source file is subject to the "Nette license" that is bundled
9: * with this package in the file license.txt.
10: *
11: * For more information please see https://nette.org
12: *
13: * @copyright Copyright (c) 2004, 2009 David Grudl
14: * @license https://nette.org/license Nette license
15: * @link https://nette.org
16: * @category Nette
17: * @package Nette\Forms
18: * @version $Id$
19: */
20:
21:
22:
23: require_once dirname(__FILE__) . '/../../Forms/Controls/FormControl.php';
24:
25:
26:
27: /**
28: * Implements the basic functionality common to text input controls.
29: *
30: * @author David Grudl
31: * @copyright Copyright (c) 2004, 2009 David Grudl
32: * @package Nette\Forms
33: */
34: abstract class TextBase extends FormControl
35: {
36: /** @var string */
37: protected $emptyValue = '';
38:
39: /** @var string */
40: protected $tmpValue;
41:
42: /** @var array */
43: protected $filters = array();
44:
45:
46:
47: /**
48: * Sets control's value.
49: * @param string
50: * @return void
51: */
52: public function setValue($value)
53: {
54: $value = (string) $value;
55: foreach ($this->filters as $filter) {
56: $value = (string) call_user_func($filter, $value);
57: }
58: $this->tmpValue = $this->value = $value === $this->translate($this->emptyValue) ? '' : $value;
59: }
60:
61:
62:
63: /**
64: * Loads HTTP data.
65: * @param array
66: * @return void
67: */
68: public function loadHttpData($data)
69: {
70: $name = $this->getName();
71: $this->tmpValue = isset($data[$name]) && is_scalar($data[$name]) ? $data[$name] : NULL;
72: $this->setValue($this->tmpValue);
73: }
74:
75:
76:
77: /**
78: * Sets the special value which is treated as empty string.
79: * @param string
80: * @return TextBase provides a fluent interface
81: */
82: public function setEmptyValue($value)
83: {
84: $this->emptyValue = $value;
85: return $this;
86: }
87:
88:
89:
90: /**
91: * Returns the special value which is treated as empty string.
92: * @return string
93: */
94: final public function getEmptyValue()
95: {
96: return $this->emptyValue;
97: }
98:
99:
100:
101: /**
102: * Appends input string filter callback.
103: * @param callback
104: * @return TextBase provides a fluent interface
105: */
106: public function addFilter($filter)
107: {
108: fixCallback($filter);
109: if (!is_callable($filter)) {
110: $able = is_callable($filter, TRUE, $textual);
111: throw new InvalidArgumentException("Filter '$textual' is not " . ($able ? 'callable.' : 'valid PHP callback.'));
112: }
113: $this->filters[] = $filter;
114: return $this;
115: }
116:
117:
118:
119: public function notifyRule(Rule $rule)
120: {
121: if (is_string($rule->operation) && strcasecmp($rule->operation, ':float') === 0) {
122: $this->addFilter(array(__CLASS__, 'filterFloat'));
123: }
124:
125: parent::notifyRule($rule);
126: }
127:
128:
129:
130: /**
131: * Min-length validator: has control's value minimal length?
132: * @param TextBase
133: * @param int length
134: * @return bool
135: */
136: public static function validateMinLength(TextBase $control, $length)
137: {
138: // PHP bug #33268 iconv_strlen works since PHP 5.0.5
139: return iconv_strlen($control->getValue(), 'UTF-8') >= $length;
140: }
141:
142:
143:
144: /**
145: * Max-length validator: is control's value length in limit?
146: * @param TextBase
147: * @param int length
148: * @return bool
149: */
150: public static function validateMaxLength(TextBase $control, $length)
151: {
152: return iconv_strlen($control->getValue(), 'UTF-8') <= $length;
153: }
154:
155:
156:
157: /**
158: * Length validator: is control's value length in range?
159: * @param TextBase
160: * @param array min and max length pair
161: * @return bool
162: */
163: public static function validateLength(TextBase $control, $range)
164: {
165: if (!is_array($range)) {
166: $range = array($range, $range);
167: }
168: $len = iconv_strlen($control->getValue(), 'UTF-8');
169: return ($range[0] === NULL || $len >= $range[0]) && ($range[1] === NULL || $len <= $range[1]);
170: }
171:
172:
173:
174: /**
175: * Email validator: is control's value valid email address?
176: * @param TextBase
177: * @return bool
178: */
179: public static function validateEmail(TextBase $control)
180: {
181: return preg_match('/^[^@\s]+@[^@\s]+\.[a-z]{2,10}$/i', $control->getValue());
182: }
183:
184:
185:
186: /**
187: * URL validator: is control's value valid URL?
188: * @param TextBase
189: * @return bool
190: */
191: public static function validateUrl(TextBase $control)
192: {
193: return preg_match('/^.+\.[a-z]{2,6}(\\/.*)?$/i', $control->getValue());
194: }
195:
196:
197:
198: /**
199: * Regular expression validator: matches control's value regular expression?
200: * @param TextBase
201: * @param string
202: * @return bool
203: */
204: public static function validateRegexp(TextBase $control, $regexp)
205: {
206: return preg_match($regexp, $control->getValue());
207: }
208:
209:
210:
211: /**
212: * Integer validator: is a control's value decimal number?
213: * @param TextBase
214: * @return bool
215: */
216: public static function validateInteger(TextBase $control)
217: {
218: return preg_match('/^-?[0-9]+$/', $control->getValue());
219: }
220:
221:
222:
223: /**
224: * Float validator: is a control's value float number?
225: * @param TextBase
226: * @return bool
227: */
228: public static function validateFloat(TextBase $control)
229: {
230: return preg_match('/^-?[0-9]*[.,]?[0-9]+$/', $control->getValue());
231: }
232:
233:
234:
235: /**
236: * Rangle validator: is a control's value number in specified range?
237: * @param TextBase
238: * @param array min and max value pair
239: * @return bool
240: */
241: public static function validateRange(TextBase $control, $range)
242: {
243: return ($range[0] === NULL || $control->getValue() >= $range[0]) && ($range[1] === NULL || $control->getValue() <= $range[1]);
244: }
245:
246:
247:
248: /**
249: * Float string cleanup.
250: * @param string
251: * @return string
252: */
253: public static function filterFloat($s)
254: {
255: return str_replace(array(' ', ','), array('', '.'), $s);
256: }
257:
258: }

Source for file TextBase.php

Namespaces