1 /*
2 +----------------------------------------------------------------------+
3 | PHP Version 7 |
4 +----------------------------------------------------------------------+
5 | Copyright (c) The PHP Group |
6 +----------------------------------------------------------------------+
7 | This source file is subject to version 3.01 of the PHP license, |
8 | that is bundled with this package in the file LICENSE, and is |
9 | available through the world-wide-web at the following url: |
10 | http://www.php.net/license/3_01.txt |
11 | If you did not receive a copy of the PHP license and are unable to |
12 | obtain it through the world-wide-web, please send a note to |
13 | license@php.net so we can mail you a copy immediately. |
14 +----------------------------------------------------------------------+
15 | Authors: Rasmus Lerdorf <rasmus@php.net> |
16 | Derick Rethans <derick@php.net> |
17 | Pierre-A. Joye <pierre@php.net> |
18 | Ilia Alshanetsky <iliaa@php.net> |
19 +----------------------------------------------------------------------+
20 */
21
22 #ifdef HAVE_CONFIG_H
23 #include "config.h"
24 #endif
25
26 #include "php_filter.h"
27
28 ZEND_DECLARE_MODULE_GLOBALS(filter)
29
30 #include "filter_private.h"
31
32 typedef struct filter_list_entry {
33 const char *name;
34 int id;
35 void (*function)(PHP_INPUT_FILTER_PARAM_DECL);
36 } filter_list_entry;
37
38 /* {{{ filter_list */
39 static const filter_list_entry filter_list[] = {
40 { "int", FILTER_VALIDATE_INT, php_filter_int },
41 { "boolean", FILTER_VALIDATE_BOOLEAN, php_filter_boolean },
42 { "float", FILTER_VALIDATE_FLOAT, php_filter_float },
43
44 { "validate_regexp", FILTER_VALIDATE_REGEXP, php_filter_validate_regexp },
45 { "validate_domain", FILTER_VALIDATE_DOMAIN, php_filter_validate_domain },
46 { "validate_url", FILTER_VALIDATE_URL, php_filter_validate_url },
47 { "validate_email", FILTER_VALIDATE_EMAIL, php_filter_validate_email },
48 { "validate_ip", FILTER_VALIDATE_IP, php_filter_validate_ip },
49 { "validate_mac", FILTER_VALIDATE_MAC, php_filter_validate_mac },
50
51 { "string", FILTER_SANITIZE_STRING, php_filter_string },
52 { "stripped", FILTER_SANITIZE_STRING, php_filter_string },
53 { "encoded", FILTER_SANITIZE_ENCODED, php_filter_encoded },
54 { "special_chars", FILTER_SANITIZE_SPECIAL_CHARS, php_filter_special_chars },
55 { "full_special_chars", FILTER_SANITIZE_FULL_SPECIAL_CHARS, php_filter_full_special_chars },
56 { "unsafe_raw", FILTER_UNSAFE_RAW, php_filter_unsafe_raw },
57 { "email", FILTER_SANITIZE_EMAIL, php_filter_email },
58 { "url", FILTER_SANITIZE_URL, php_filter_url },
59 { "number_int", FILTER_SANITIZE_NUMBER_INT, php_filter_number_int },
60 { "number_float", FILTER_SANITIZE_NUMBER_FLOAT, php_filter_number_float },
61 { "magic_quotes", FILTER_SANITIZE_MAGIC_QUOTES, php_filter_magic_quotes },
62 { "add_slashes", FILTER_SANITIZE_ADD_SLASHES, php_filter_add_slashes },
63
64 { "callback", FILTER_CALLBACK, php_filter_callback },
65 };
66 /* }}} */
67
68 #ifndef PARSE_ENV
69 #define PARSE_ENV 4
70 #endif
71
72 #ifndef PARSE_SERVER
73 #define PARSE_SERVER 5
74 #endif
75
76 #ifndef PARSE_SESSION
77 #define PARSE_SESSION 6
78 #endif
79
80 static unsigned int php_sapi_filter(int arg, char *var, char **val, size_t val_len, size_t *new_val_len);
81 static unsigned int php_sapi_filter_init(void);
82
83 /* {{{ arginfo */
84 ZEND_BEGIN_ARG_INFO_EX(arginfo_filter_input, 0, 0, 2)
85 ZEND_ARG_INFO(0, type)
86 ZEND_ARG_INFO(0, variable_name)
87 ZEND_ARG_INFO(0, filter)
88 ZEND_ARG_INFO(0, options)
89 ZEND_END_ARG_INFO()
90
91 ZEND_BEGIN_ARG_INFO_EX(arginfo_filter_var, 0, 0, 1)
92 ZEND_ARG_INFO(0, variable)
93 ZEND_ARG_INFO(0, filter)
94 ZEND_ARG_INFO(0, options)
95 ZEND_END_ARG_INFO()
96
97 ZEND_BEGIN_ARG_INFO_EX(arginfo_filter_input_array, 0, 0, 1)
98 ZEND_ARG_INFO(0, type)
99 ZEND_ARG_INFO(0, definition)
100 ZEND_ARG_INFO(0, add_empty)
101 ZEND_END_ARG_INFO()
102
103 ZEND_BEGIN_ARG_INFO_EX(arginfo_filter_var_array, 0, 0, 1)
104 ZEND_ARG_INFO(0, data)
105 ZEND_ARG_INFO(0, definition)
106 ZEND_ARG_INFO(0, add_empty)
107 ZEND_END_ARG_INFO()
108
109 ZEND_BEGIN_ARG_INFO(arginfo_filter_list, 0)
110 ZEND_END_ARG_INFO()
111
112 ZEND_BEGIN_ARG_INFO_EX(arginfo_filter_has_var, 0, 0, 2)
113 ZEND_ARG_INFO(0, type)
114 ZEND_ARG_INFO(0, variable_name)
115 ZEND_END_ARG_INFO()
116
117 ZEND_BEGIN_ARG_INFO_EX(arginfo_filter_id, 0, 0, 1)
118 ZEND_ARG_INFO(0, filtername)
119 ZEND_END_ARG_INFO()
120 /* }}} */
121
122 /* {{{ filter_functions[]
123 */
124 static const zend_function_entry filter_functions[] = {
125 PHP_FE(filter_input, arginfo_filter_input)
126 PHP_FE(filter_var, arginfo_filter_var)
127 PHP_FE(filter_input_array, arginfo_filter_input_array)
128 PHP_FE(filter_var_array, arginfo_filter_var_array)
129 PHP_FE(filter_list, arginfo_filter_list)
130 PHP_FE(filter_has_var, arginfo_filter_has_var)
131 PHP_FE(filter_id, arginfo_filter_id)
132 PHP_FE_END
133 };
134 /* }}} */
135
136 /* {{{ filter_module_entry
137 */
138 zend_module_entry filter_module_entry = {
139 STANDARD_MODULE_HEADER,
140 "filter",
141 filter_functions,
142 PHP_MINIT(filter),
143 PHP_MSHUTDOWN(filter),
144 NULL,
145 PHP_RSHUTDOWN(filter),
146 PHP_MINFO(filter),
147 PHP_FILTER_VERSION,
148 STANDARD_MODULE_PROPERTIES
149 };
150 /* }}} */
151
152 #ifdef COMPILE_DL_FILTER
153 #ifdef ZTS
154 ZEND_TSRMLS_CACHE_DEFINE()
155 #endif
ZEND_GET_MODULE(filter)156 ZEND_GET_MODULE(filter)
157 #endif
158
159 static PHP_INI_MH(UpdateDefaultFilter) /* {{{ */
160 {
161 int i, size = sizeof(filter_list) / sizeof(filter_list_entry);
162
163 for (i = 0; i < size; ++i) {
164 if ((strcasecmp(ZSTR_VAL(new_value), filter_list[i].name) == 0)) {
165 IF_G(default_filter) = filter_list[i].id;
166 return SUCCESS;
167 }
168 }
169 /* Fallback to the default filter */
170 IF_G(default_filter) = FILTER_DEFAULT;
171 return SUCCESS;
172 }
173 /* }}} */
174
175 /* {{{ PHP_INI
176 */
PHP_INI_MH(OnUpdateFlags)177 static PHP_INI_MH(OnUpdateFlags)
178 {
179 if (!new_value) {
180 IF_G(default_filter_flags) = FILTER_FLAG_NO_ENCODE_QUOTES;
181 } else {
182 IF_G(default_filter_flags) = atoi(ZSTR_VAL(new_value));
183 }
184 return SUCCESS;
185 }
186
187 PHP_INI_BEGIN()
188 STD_PHP_INI_ENTRY("filter.default", "unsafe_raw", PHP_INI_SYSTEM|PHP_INI_PERDIR, UpdateDefaultFilter, default_filter, zend_filter_globals, filter_globals)
189 PHP_INI_ENTRY("filter.default_flags", NULL, PHP_INI_SYSTEM|PHP_INI_PERDIR, OnUpdateFlags)
PHP_INI_END()190 PHP_INI_END()
191 /* }}} */
192
193 static void php_filter_init_globals(zend_filter_globals *filter_globals) /* {{{ */
194 {
195 #if defined(COMPILE_DL_FILTER) && defined(ZTS)
196 ZEND_TSRMLS_CACHE_UPDATE();
197 #endif
198 ZVAL_UNDEF(&filter_globals->post_array);
199 ZVAL_UNDEF(&filter_globals->get_array);
200 ZVAL_UNDEF(&filter_globals->cookie_array);
201 ZVAL_UNDEF(&filter_globals->env_array);
202 ZVAL_UNDEF(&filter_globals->server_array);
203 #if 0
204 ZVAL_UNDEF(&filter_globals->session_array);
205 #endif
206 filter_globals->default_filter = FILTER_DEFAULT;
207 }
208 /* }}} */
209
210 #define PARSE_REQUEST 99
211
212 /* {{{ PHP_MINIT_FUNCTION
213 */
PHP_MINIT_FUNCTION(filter)214 PHP_MINIT_FUNCTION(filter)
215 {
216 ZEND_INIT_MODULE_GLOBALS(filter, php_filter_init_globals, NULL);
217
218 REGISTER_INI_ENTRIES();
219
220 REGISTER_LONG_CONSTANT("INPUT_POST", PARSE_POST, CONST_CS | CONST_PERSISTENT);
221 REGISTER_LONG_CONSTANT("INPUT_GET", PARSE_GET, CONST_CS | CONST_PERSISTENT);
222 REGISTER_LONG_CONSTANT("INPUT_COOKIE", PARSE_COOKIE, CONST_CS | CONST_PERSISTENT);
223 REGISTER_LONG_CONSTANT("INPUT_ENV", PARSE_ENV, CONST_CS | CONST_PERSISTENT);
224 REGISTER_LONG_CONSTANT("INPUT_SERVER", PARSE_SERVER, CONST_CS | CONST_PERSISTENT);
225 REGISTER_LONG_CONSTANT("INPUT_SESSION", PARSE_SESSION, CONST_CS | CONST_PERSISTENT);
226 REGISTER_LONG_CONSTANT("INPUT_REQUEST", PARSE_REQUEST, CONST_CS | CONST_PERSISTENT);
227
228 REGISTER_LONG_CONSTANT("FILTER_FLAG_NONE", FILTER_FLAG_NONE, CONST_CS | CONST_PERSISTENT);
229
230 REGISTER_LONG_CONSTANT("FILTER_REQUIRE_SCALAR", FILTER_REQUIRE_SCALAR, CONST_CS | CONST_PERSISTENT);
231 REGISTER_LONG_CONSTANT("FILTER_REQUIRE_ARRAY", FILTER_REQUIRE_ARRAY, CONST_CS | CONST_PERSISTENT);
232 REGISTER_LONG_CONSTANT("FILTER_FORCE_ARRAY", FILTER_FORCE_ARRAY, CONST_CS | CONST_PERSISTENT);
233 REGISTER_LONG_CONSTANT("FILTER_NULL_ON_FAILURE", FILTER_NULL_ON_FAILURE, CONST_CS | CONST_PERSISTENT);
234
235 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_INT", FILTER_VALIDATE_INT, CONST_CS | CONST_PERSISTENT);
236 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_BOOLEAN", FILTER_VALIDATE_BOOLEAN, CONST_CS | CONST_PERSISTENT);
237 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_FLOAT", FILTER_VALIDATE_FLOAT, CONST_CS | CONST_PERSISTENT);
238
239 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_REGEXP", FILTER_VALIDATE_REGEXP, CONST_CS | CONST_PERSISTENT);
240 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_DOMAIN", FILTER_VALIDATE_DOMAIN, CONST_CS | CONST_PERSISTENT);
241 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_URL", FILTER_VALIDATE_URL, CONST_CS | CONST_PERSISTENT);
242 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_EMAIL", FILTER_VALIDATE_EMAIL, CONST_CS | CONST_PERSISTENT);
243 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_IP", FILTER_VALIDATE_IP, CONST_CS | CONST_PERSISTENT);
244 REGISTER_LONG_CONSTANT("FILTER_VALIDATE_MAC", FILTER_VALIDATE_MAC, CONST_CS | CONST_PERSISTENT);
245
246 REGISTER_LONG_CONSTANT("FILTER_DEFAULT", FILTER_DEFAULT, CONST_CS | CONST_PERSISTENT);
247 REGISTER_LONG_CONSTANT("FILTER_UNSAFE_RAW", FILTER_UNSAFE_RAW, CONST_CS | CONST_PERSISTENT);
248
249 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_STRING", FILTER_SANITIZE_STRING, CONST_CS | CONST_PERSISTENT);
250 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_STRIPPED", FILTER_SANITIZE_STRING, CONST_CS | CONST_PERSISTENT);
251 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_ENCODED", FILTER_SANITIZE_ENCODED, CONST_CS | CONST_PERSISTENT);
252 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_SPECIAL_CHARS", FILTER_SANITIZE_SPECIAL_CHARS, CONST_CS | CONST_PERSISTENT);
253 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_FULL_SPECIAL_CHARS", FILTER_SANITIZE_FULL_SPECIAL_CHARS, CONST_CS | CONST_PERSISTENT);
254 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_EMAIL", FILTER_SANITIZE_EMAIL, CONST_CS | CONST_PERSISTENT);
255 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_URL", FILTER_SANITIZE_URL, CONST_CS | CONST_PERSISTENT);
256 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_NUMBER_INT", FILTER_SANITIZE_NUMBER_INT, CONST_CS | CONST_PERSISTENT);
257 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_NUMBER_FLOAT", FILTER_SANITIZE_NUMBER_FLOAT, CONST_CS | CONST_PERSISTENT);
258 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_MAGIC_QUOTES", FILTER_SANITIZE_MAGIC_QUOTES, CONST_CS | CONST_PERSISTENT);
259 REGISTER_LONG_CONSTANT("FILTER_SANITIZE_ADD_SLASHES", FILTER_SANITIZE_ADD_SLASHES, CONST_CS | CONST_PERSISTENT);
260
261 REGISTER_LONG_CONSTANT("FILTER_CALLBACK", FILTER_CALLBACK, CONST_CS | CONST_PERSISTENT);
262
263 REGISTER_LONG_CONSTANT("FILTER_FLAG_ALLOW_OCTAL", FILTER_FLAG_ALLOW_OCTAL, CONST_CS | CONST_PERSISTENT);
264 REGISTER_LONG_CONSTANT("FILTER_FLAG_ALLOW_HEX", FILTER_FLAG_ALLOW_HEX, CONST_CS | CONST_PERSISTENT);
265
266 REGISTER_LONG_CONSTANT("FILTER_FLAG_STRIP_LOW", FILTER_FLAG_STRIP_LOW, CONST_CS | CONST_PERSISTENT);
267 REGISTER_LONG_CONSTANT("FILTER_FLAG_STRIP_HIGH", FILTER_FLAG_STRIP_HIGH, CONST_CS | CONST_PERSISTENT);
268 REGISTER_LONG_CONSTANT("FILTER_FLAG_STRIP_BACKTICK", FILTER_FLAG_STRIP_BACKTICK, CONST_CS | CONST_PERSISTENT);
269 REGISTER_LONG_CONSTANT("FILTER_FLAG_ENCODE_LOW", FILTER_FLAG_ENCODE_LOW, CONST_CS | CONST_PERSISTENT);
270 REGISTER_LONG_CONSTANT("FILTER_FLAG_ENCODE_HIGH", FILTER_FLAG_ENCODE_HIGH, CONST_CS | CONST_PERSISTENT);
271 REGISTER_LONG_CONSTANT("FILTER_FLAG_ENCODE_AMP", FILTER_FLAG_ENCODE_AMP, CONST_CS | CONST_PERSISTENT);
272 REGISTER_LONG_CONSTANT("FILTER_FLAG_NO_ENCODE_QUOTES", FILTER_FLAG_NO_ENCODE_QUOTES, CONST_CS | CONST_PERSISTENT);
273 REGISTER_LONG_CONSTANT("FILTER_FLAG_EMPTY_STRING_NULL", FILTER_FLAG_EMPTY_STRING_NULL, CONST_CS | CONST_PERSISTENT);
274
275 REGISTER_LONG_CONSTANT("FILTER_FLAG_ALLOW_FRACTION", FILTER_FLAG_ALLOW_FRACTION, CONST_CS | CONST_PERSISTENT);
276 REGISTER_LONG_CONSTANT("FILTER_FLAG_ALLOW_THOUSAND", FILTER_FLAG_ALLOW_THOUSAND, CONST_CS | CONST_PERSISTENT);
277 REGISTER_LONG_CONSTANT("FILTER_FLAG_ALLOW_SCIENTIFIC", FILTER_FLAG_ALLOW_SCIENTIFIC, CONST_CS | CONST_PERSISTENT);
278
279 REGISTER_LONG_CONSTANT("FILTER_FLAG_SCHEME_REQUIRED", FILTER_FLAG_SCHEME_REQUIRED, CONST_CS | CONST_PERSISTENT);
280 REGISTER_LONG_CONSTANT("FILTER_FLAG_HOST_REQUIRED", FILTER_FLAG_HOST_REQUIRED, CONST_CS | CONST_PERSISTENT);
281 REGISTER_LONG_CONSTANT("FILTER_FLAG_PATH_REQUIRED", FILTER_FLAG_PATH_REQUIRED, CONST_CS | CONST_PERSISTENT);
282 REGISTER_LONG_CONSTANT("FILTER_FLAG_QUERY_REQUIRED", FILTER_FLAG_QUERY_REQUIRED, CONST_CS | CONST_PERSISTENT);
283
284 REGISTER_LONG_CONSTANT("FILTER_FLAG_IPV4", FILTER_FLAG_IPV4, CONST_CS | CONST_PERSISTENT);
285 REGISTER_LONG_CONSTANT("FILTER_FLAG_IPV6", FILTER_FLAG_IPV6, CONST_CS | CONST_PERSISTENT);
286 REGISTER_LONG_CONSTANT("FILTER_FLAG_NO_RES_RANGE", FILTER_FLAG_NO_RES_RANGE, CONST_CS | CONST_PERSISTENT);
287 REGISTER_LONG_CONSTANT("FILTER_FLAG_NO_PRIV_RANGE", FILTER_FLAG_NO_PRIV_RANGE, CONST_CS | CONST_PERSISTENT);
288
289 REGISTER_LONG_CONSTANT("FILTER_FLAG_HOSTNAME", FILTER_FLAG_HOSTNAME, CONST_CS | CONST_PERSISTENT);
290
291 REGISTER_LONG_CONSTANT("FILTER_FLAG_EMAIL_UNICODE", FILTER_FLAG_EMAIL_UNICODE, CONST_CS | CONST_PERSISTENT);
292
293 sapi_register_input_filter(php_sapi_filter, php_sapi_filter_init);
294
295 return SUCCESS;
296 }
297 /* }}} */
298
299 /* {{{ PHP_MSHUTDOWN_FUNCTION
300 */
PHP_MSHUTDOWN_FUNCTION(filter)301 PHP_MSHUTDOWN_FUNCTION(filter)
302 {
303 UNREGISTER_INI_ENTRIES();
304
305 return SUCCESS;
306 }
307 /* }}} */
308
309 /* {{{ PHP_RSHUTDOWN_FUNCTION
310 */
311 #define VAR_ARRAY_COPY_DTOR(a) \
312 if (!Z_ISUNDEF(IF_G(a))) { \
313 zval_ptr_dtor(&IF_G(a)); \
314 ZVAL_UNDEF(&IF_G(a)); \
315 }
316
PHP_RSHUTDOWN_FUNCTION(filter)317 PHP_RSHUTDOWN_FUNCTION(filter)
318 {
319 VAR_ARRAY_COPY_DTOR(get_array)
320 VAR_ARRAY_COPY_DTOR(post_array)
321 VAR_ARRAY_COPY_DTOR(cookie_array)
322 VAR_ARRAY_COPY_DTOR(server_array)
323 VAR_ARRAY_COPY_DTOR(env_array)
324 #if 0
325 VAR_ARRAY_COPY_DTOR(session_array)
326 #endif
327 return SUCCESS;
328 }
329 /* }}} */
330
331 /* {{{ PHP_MINFO_FUNCTION
332 */
PHP_MINFO_FUNCTION(filter)333 PHP_MINFO_FUNCTION(filter)
334 {
335 php_info_print_table_start();
336 php_info_print_table_row( 2, "Input Validation and Filtering", "enabled" );
337 php_info_print_table_end();
338
339 DISPLAY_INI_ENTRIES();
340 }
341 /* }}} */
342
php_find_filter(zend_long id)343 static filter_list_entry php_find_filter(zend_long id) /* {{{ */
344 {
345 int i, size = sizeof(filter_list) / sizeof(filter_list_entry);
346
347 for (i = 0; i < size; ++i) {
348 if (filter_list[i].id == id) {
349 return filter_list[i];
350 }
351 }
352 /* Fallback to "string" filter */
353 for (i = 0; i < size; ++i) {
354 if (filter_list[i].id == FILTER_DEFAULT) {
355 return filter_list[i];
356 }
357 }
358 /* To shut up GCC */
359 return filter_list[0];
360 }
361 /* }}} */
362
php_sapi_filter_init(void)363 static unsigned int php_sapi_filter_init(void)
364 {
365 ZVAL_UNDEF(&IF_G(get_array));
366 ZVAL_UNDEF(&IF_G(post_array));
367 ZVAL_UNDEF(&IF_G(cookie_array));
368 ZVAL_UNDEF(&IF_G(server_array));
369 ZVAL_UNDEF(&IF_G(env_array));
370 #if 0
371 ZVAL_UNDEF(&IF_G(session_array));
372 #endif
373 return SUCCESS;
374 }
375
php_zval_filter(zval * value,zend_long filter,zend_long flags,zval * options,char * charset,zend_bool copy)376 static void php_zval_filter(zval *value, zend_long filter, zend_long flags, zval *options, char* charset, zend_bool copy) /* {{{ */
377 {
378 filter_list_entry filter_func;
379
380 filter_func = php_find_filter(filter);
381
382 if (!filter_func.id) {
383 /* Find default filter */
384 filter_func = php_find_filter(FILTER_DEFAULT);
385 }
386
387 /* #49274, fatal error with object without a toString method
388 Fails nicely instead of getting a recovarable fatal error. */
389 if (Z_TYPE_P(value) == IS_OBJECT) {
390 zend_class_entry *ce;
391
392 ce = Z_OBJCE_P(value);
393 if (!ce->__tostring) {
394 zval_ptr_dtor(value);
395 /* #67167: doesn't return null on failure for objects */
396 if (flags & FILTER_NULL_ON_FAILURE) {
397 ZVAL_NULL(value);
398 } else {
399 ZVAL_FALSE(value);
400 }
401 goto handle_default;
402 }
403 }
404
405 /* Here be strings */
406 convert_to_string(value);
407
408 filter_func.function(value, flags, options, charset);
409
410 handle_default:
411 if (options && Z_TYPE_P(options) == IS_ARRAY &&
412 ((flags & FILTER_NULL_ON_FAILURE && Z_TYPE_P(value) == IS_NULL) ||
413 (!(flags & FILTER_NULL_ON_FAILURE) && Z_TYPE_P(value) == IS_FALSE))) {
414 zval *tmp;
415 if ((tmp = zend_hash_str_find(Z_ARRVAL_P(options), "default", sizeof("default") - 1)) != NULL) {
416 ZVAL_COPY(value, tmp);
417 }
418 }
419 }
420 /* }}} */
421
php_sapi_filter(int arg,char * var,char ** val,size_t val_len,size_t * new_val_len)422 static unsigned int php_sapi_filter(int arg, char *var, char **val, size_t val_len, size_t *new_val_len) /* {{{ */
423 {
424 zval new_var, raw_var;
425 zval *array_ptr = NULL, *orig_array_ptr = NULL;
426 int retval = 0;
427
428 assert(*val != NULL);
429
430 #define PARSE_CASE(s,a,t) \
431 case s: \
432 if (Z_ISUNDEF(IF_G(a))) { \
433 array_init(&IF_G(a)); \
434 } \
435 array_ptr = &IF_G(a); \
436 orig_array_ptr = &PG(http_globals)[t]; \
437 break;
438
439 switch (arg) {
440 PARSE_CASE(PARSE_POST, post_array, TRACK_VARS_POST)
441 PARSE_CASE(PARSE_GET, get_array, TRACK_VARS_GET)
442 PARSE_CASE(PARSE_COOKIE, cookie_array, TRACK_VARS_COOKIE)
443 PARSE_CASE(PARSE_SERVER, server_array, TRACK_VARS_SERVER)
444 PARSE_CASE(PARSE_ENV, env_array, TRACK_VARS_ENV)
445
446 case PARSE_STRING: /* PARSE_STRING is used by parse_str() function */
447 retval = 1;
448 break;
449 }
450
451 /*
452 * According to rfc2965, more specific paths are listed above the less specific ones.
453 * If we encounter a duplicate cookie name, we should skip it, since it is not possible
454 * to have the same (plain text) cookie name for the same path and we should not overwrite
455 * more specific cookies with the less specific ones.
456 */
457 if (arg == PARSE_COOKIE && orig_array_ptr &&
458 zend_symtable_str_exists(Z_ARRVAL_P(orig_array_ptr), var, strlen(var))) {
459 return 0;
460 }
461
462 if (array_ptr) {
463 /* Store the RAW variable internally */
464 ZVAL_STRINGL(&raw_var, *val, val_len);
465 php_register_variable_ex(var, &raw_var, array_ptr);
466 }
467
468 if (val_len) {
469 /* Register mangled variable */
470 if (IF_G(default_filter) != FILTER_UNSAFE_RAW) {
471 ZVAL_STRINGL(&new_var, *val, val_len);
472 php_zval_filter(&new_var, IF_G(default_filter), IF_G(default_filter_flags), NULL, NULL, 0);
473 } else {
474 ZVAL_STRINGL(&new_var, *val, val_len);
475 }
476 } else { /* empty string */
477 ZVAL_EMPTY_STRING(&new_var);
478 }
479
480 if (orig_array_ptr) {
481 php_register_variable_ex(var, &new_var, orig_array_ptr);
482 }
483
484 if (retval) {
485 if (new_val_len) {
486 *new_val_len = Z_STRLEN(new_var);
487 }
488 efree(*val);
489 if (Z_STRLEN(new_var)) {
490 *val = estrndup(Z_STRVAL(new_var), Z_STRLEN(new_var));
491 } else {
492 *val = estrdup("");
493 }
494 zval_ptr_dtor(&new_var);
495 }
496
497 return retval;
498 }
499 /* }}} */
500
php_zval_filter_recursive(zval * value,zend_long filter,zend_long flags,zval * options,char * charset,zend_bool copy)501 static void php_zval_filter_recursive(zval *value, zend_long filter, zend_long flags, zval *options, char *charset, zend_bool copy) /* {{{ */
502 {
503 if (Z_TYPE_P(value) == IS_ARRAY) {
504 zval *element;
505
506 if (Z_IS_RECURSIVE_P(value)) {
507 return;
508 }
509 Z_PROTECT_RECURSION_P(value);
510
511 ZEND_HASH_FOREACH_VAL(Z_ARRVAL_P(value), element) {
512 ZVAL_DEREF(element);
513 if (Z_TYPE_P(element) == IS_ARRAY) {
514 SEPARATE_ARRAY(element);
515 php_zval_filter_recursive(element, filter, flags, options, charset, copy);
516 } else {
517 php_zval_filter(element, filter, flags, options, charset, copy);
518 }
519 } ZEND_HASH_FOREACH_END();
520 Z_UNPROTECT_RECURSION_P(value);
521 } else {
522 php_zval_filter(value, filter, flags, options, charset, copy);
523 }
524 }
525 /* }}} */
526
php_filter_get_storage(zend_long arg)527 static zval *php_filter_get_storage(zend_long arg)/* {{{ */
528
529 {
530 zval *array_ptr = NULL;
531
532 switch (arg) {
533 case PARSE_GET:
534 array_ptr = &IF_G(get_array);
535 break;
536 case PARSE_POST:
537 array_ptr = &IF_G(post_array);
538 break;
539 case PARSE_COOKIE:
540 array_ptr = &IF_G(cookie_array);
541 break;
542 case PARSE_SERVER:
543 if (PG(auto_globals_jit)) {
544 zend_is_auto_global_str(ZEND_STRL("_SERVER"));
545 }
546 array_ptr = &IF_G(server_array);
547 break;
548 case PARSE_ENV:
549 if (PG(auto_globals_jit)) {
550 zend_is_auto_global_str(ZEND_STRL("_ENV"));
551 }
552 array_ptr = !Z_ISUNDEF(IF_G(env_array)) ? &IF_G(env_array) : &PG(http_globals)[TRACK_VARS_ENV];
553 break;
554 case PARSE_SESSION:
555 /* FIXME: Implement session source */
556 php_error_docref(NULL, E_WARNING, "INPUT_SESSION is not yet implemented");
557 break;
558 case PARSE_REQUEST:
559 /* FIXME: Implement request source */
560 php_error_docref(NULL, E_WARNING, "INPUT_REQUEST is not yet implemented");
561 break;
562 }
563
564 if (array_ptr && Z_TYPE_P(array_ptr) != IS_ARRAY) {
565 /* Storage not initialized */
566 return NULL;
567 }
568
569 return array_ptr;
570 }
571 /* }}} */
572
573 /* {{{ proto mixed filter_has_var(constant type, string variable_name)
574 * Returns true if the variable with the name 'name' exists in source.
575 */
PHP_FUNCTION(filter_has_var)576 PHP_FUNCTION(filter_has_var)
577 {
578 zend_long arg;
579 zend_string *var;
580 zval *array_ptr = NULL;
581
582 if (zend_parse_parameters(ZEND_NUM_ARGS(), "lS", &arg, &var) == FAILURE) {
583 RETURN_FALSE;
584 }
585
586 array_ptr = php_filter_get_storage(arg);
587
588 if (array_ptr && zend_hash_exists(Z_ARRVAL_P(array_ptr), var)) {
589 RETURN_TRUE;
590 }
591
592 RETURN_FALSE;
593 }
594 /* }}} */
595
php_filter_call(zval * filtered,zend_long filter,zval * filter_args,const int copy,zend_long filter_flags)596 static void php_filter_call(zval *filtered, zend_long filter, zval *filter_args, const int copy, zend_long filter_flags) /* {{{ */
597 {
598 zval *options = NULL;
599 zval *option;
600 char *charset = NULL;
601
602 if (filter_args && Z_TYPE_P(filter_args) != IS_ARRAY) {
603 zend_long lval = zval_get_long(filter_args);
604
605 if (filter != -1) { /* handler for array apply */
606 /* filter_args is the filter_flags */
607 filter_flags = lval;
608
609 if (!(filter_flags & FILTER_REQUIRE_ARRAY || filter_flags & FILTER_FORCE_ARRAY)) {
610 filter_flags |= FILTER_REQUIRE_SCALAR;
611 }
612 } else {
613 filter = lval;
614 }
615 } else if (filter_args) {
616 if ((option = zend_hash_str_find(Z_ARRVAL_P(filter_args), "filter", sizeof("filter") - 1)) != NULL) {
617 filter = zval_get_long(option);
618 }
619
620 if ((option = zend_hash_str_find(Z_ARRVAL_P(filter_args), "flags", sizeof("flags") - 1)) != NULL) {
621 filter_flags = zval_get_long(option);
622
623 if (!(filter_flags & FILTER_REQUIRE_ARRAY || filter_flags & FILTER_FORCE_ARRAY)) {
624 filter_flags |= FILTER_REQUIRE_SCALAR;
625 }
626 }
627
628 if ((option = zend_hash_str_find_deref(Z_ARRVAL_P(filter_args), "options", sizeof("options") - 1)) != NULL) {
629 if (filter != FILTER_CALLBACK) {
630 if (Z_TYPE_P(option) == IS_ARRAY) {
631 options = option;
632 }
633 } else {
634 options = option;
635 filter_flags = 0;
636 }
637 }
638 }
639
640 if (Z_TYPE_P(filtered) == IS_ARRAY) {
641 if (filter_flags & FILTER_REQUIRE_SCALAR) {
642 zval_ptr_dtor(filtered);
643 if (filter_flags & FILTER_NULL_ON_FAILURE) {
644 ZVAL_NULL(filtered);
645 } else {
646 ZVAL_FALSE(filtered);
647 }
648 return;
649 }
650 php_zval_filter_recursive(filtered, filter, filter_flags, options, charset, copy);
651 return;
652 }
653 if (filter_flags & FILTER_REQUIRE_ARRAY) {
654 zval_ptr_dtor(filtered);
655 if (filter_flags & FILTER_NULL_ON_FAILURE) {
656 ZVAL_NULL(filtered);
657 } else {
658 ZVAL_FALSE(filtered);
659 }
660 return;
661 }
662
663 php_zval_filter(filtered, filter, filter_flags, options, charset, copy);
664 if (filter_flags & FILTER_FORCE_ARRAY) {
665 zval tmp;
666 ZVAL_COPY_VALUE(&tmp, filtered);
667 array_init(filtered);
668 add_next_index_zval(filtered, &tmp);
669 }
670 }
671 /* }}} */
672
php_filter_array_handler(zval * input,zval * op,zval * return_value,zend_bool add_empty)673 static void php_filter_array_handler(zval *input, zval *op, zval *return_value, zend_bool add_empty) /* {{{ */
674 {
675 zend_string *arg_key;
676 zval *tmp, *arg_elm;
677
678 if (!op) {
679 ZVAL_DUP(return_value, input);
680 php_filter_call(return_value, FILTER_DEFAULT, NULL, 0, FILTER_REQUIRE_ARRAY);
681 } else if (Z_TYPE_P(op) == IS_LONG) {
682 ZVAL_DUP(return_value, input);
683 php_filter_call(return_value, Z_LVAL_P(op), NULL, 0, FILTER_REQUIRE_ARRAY);
684 } else if (Z_TYPE_P(op) == IS_ARRAY) {
685 array_init(return_value);
686
687 ZEND_HASH_FOREACH_STR_KEY_VAL(Z_ARRVAL_P(op), arg_key, arg_elm) {
688 if (arg_key == NULL) {
689 php_error_docref(NULL, E_WARNING, "Numeric keys are not allowed in the definition array");
690 zval_ptr_dtor(return_value);
691 RETURN_FALSE;
692 }
693 if (ZSTR_LEN(arg_key) == 0) {
694 php_error_docref(NULL, E_WARNING, "Empty keys are not allowed in the definition array");
695 zval_ptr_dtor(return_value);
696 RETURN_FALSE;
697 }
698 if ((tmp = zend_hash_find(Z_ARRVAL_P(input), arg_key)) == NULL) {
699 if (add_empty) {
700 add_assoc_null_ex(return_value, ZSTR_VAL(arg_key), ZSTR_LEN(arg_key));
701 }
702 } else {
703 zval nval;
704 ZVAL_DEREF(tmp);
705 ZVAL_DUP(&nval, tmp);
706 php_filter_call(&nval, -1, arg_elm, 0, FILTER_REQUIRE_SCALAR);
707 zend_hash_update(Z_ARRVAL_P(return_value), arg_key, &nval);
708 }
709 } ZEND_HASH_FOREACH_END();
710 } else {
711 RETURN_FALSE;
712 }
713 }
714 /* }}} */
715
716 /* {{{ proto mixed filter_input(constant type, string variable_name [, int filter [, mixed options]])
717 * Returns the filtered variable 'name'* from source `type`.
718 */
PHP_FUNCTION(filter_input)719 PHP_FUNCTION(filter_input)
720 {
721 zend_long fetch_from, filter = FILTER_DEFAULT;
722 zval *filter_args = NULL, *tmp;
723 zval *input = NULL;
724 zend_string *var;
725
726 if (zend_parse_parameters(ZEND_NUM_ARGS(), "lS|lz", &fetch_from, &var, &filter, &filter_args) == FAILURE) {
727 return;
728 }
729
730 if (!PHP_FILTER_ID_EXISTS(filter)) {
731 RETURN_FALSE;
732 }
733
734 input = php_filter_get_storage(fetch_from);
735
736 if (!input || (tmp = zend_hash_find(Z_ARRVAL_P(input), var)) == NULL) {
737 zend_long filter_flags = 0;
738 zval *option, *opt, *def;
739 if (filter_args) {
740 if (Z_TYPE_P(filter_args) == IS_LONG) {
741 filter_flags = Z_LVAL_P(filter_args);
742 } else if (Z_TYPE_P(filter_args) == IS_ARRAY && (option = zend_hash_str_find(Z_ARRVAL_P(filter_args), "flags", sizeof("flags") - 1)) != NULL) {
743 filter_flags = zval_get_long(option);
744 }
745 if (Z_TYPE_P(filter_args) == IS_ARRAY &&
746 (opt = zend_hash_str_find_deref(Z_ARRVAL_P(filter_args), "options", sizeof("options") - 1)) != NULL &&
747 Z_TYPE_P(opt) == IS_ARRAY &&
748 (def = zend_hash_str_find_deref(Z_ARRVAL_P(opt), "default", sizeof("default") - 1)) != NULL) {
749 ZVAL_COPY(return_value, def);
750 return;
751 }
752 }
753
754 /* The FILTER_NULL_ON_FAILURE flag inverts the usual return values of
755 * the function: normally when validation fails false is returned, and
756 * when the input value doesn't exist NULL is returned. With the flag
757 * set, NULL and false should be returned, respectively. Ergo, although
758 * the code below looks incorrect, it's actually right. */
759 if (filter_flags & FILTER_NULL_ON_FAILURE) {
760 RETURN_FALSE;
761 } else {
762 RETURN_NULL();
763 }
764 }
765
766 ZVAL_DUP(return_value, tmp);
767
768 php_filter_call(return_value, filter, filter_args, 1, FILTER_REQUIRE_SCALAR);
769 }
770 /* }}} */
771
772 /* {{{ proto mixed filter_var(mixed variable [, int filter [, mixed options]])
773 * Returns the filtered version of the variable.
774 */
PHP_FUNCTION(filter_var)775 PHP_FUNCTION(filter_var)
776 {
777 zend_long filter = FILTER_DEFAULT;
778 zval *filter_args = NULL, *data;
779
780 if (zend_parse_parameters(ZEND_NUM_ARGS(), "z|lz", &data, &filter, &filter_args) == FAILURE) {
781 return;
782 }
783
784 if (!PHP_FILTER_ID_EXISTS(filter)) {
785 RETURN_FALSE;
786 }
787
788 ZVAL_DUP(return_value, data);
789
790 php_filter_call(return_value, filter, filter_args, 1, FILTER_REQUIRE_SCALAR);
791 }
792 /* }}} */
793
794 /* {{{ proto mixed filter_input_array(constant type, [, mixed options [, bool add_empty]]])
795 * Returns an array with all arguments defined in 'definition'.
796 */
PHP_FUNCTION(filter_input_array)797 PHP_FUNCTION(filter_input_array)
798 {
799 zend_long fetch_from;
800 zval *array_input = NULL, *op = NULL;
801 zend_bool add_empty = 1;
802
803 if (zend_parse_parameters(ZEND_NUM_ARGS(), "l|zb", &fetch_from, &op, &add_empty) == FAILURE) {
804 return;
805 }
806
807 if (op && (Z_TYPE_P(op) != IS_ARRAY) && !(Z_TYPE_P(op) == IS_LONG && PHP_FILTER_ID_EXISTS(Z_LVAL_P(op)))) {
808 RETURN_FALSE;
809 }
810
811 array_input = php_filter_get_storage(fetch_from);
812
813 if (!array_input) {
814 zend_long filter_flags = 0;
815 zval *option;
816 if (op) {
817 if (Z_TYPE_P(op) == IS_LONG) {
818 filter_flags = Z_LVAL_P(op);
819 } else if (Z_TYPE_P(op) == IS_ARRAY && (option = zend_hash_str_find(Z_ARRVAL_P(op), "flags", sizeof("flags") - 1)) != NULL) {
820 filter_flags = zval_get_long(option);
821 }
822 }
823
824 /* The FILTER_NULL_ON_FAILURE flag inverts the usual return values of
825 * the function: normally when validation fails false is returned, and
826 * when the input value doesn't exist NULL is returned. With the flag
827 * set, NULL and false should be returned, respectively. Ergo, although
828 * the code below looks incorrect, it's actually right. */
829 if (filter_flags & FILTER_NULL_ON_FAILURE) {
830 RETURN_FALSE;
831 } else {
832 RETURN_NULL();
833 }
834 }
835
836 php_filter_array_handler(array_input, op, return_value, add_empty);
837 }
838 /* }}} */
839
840 /* {{{ proto mixed filter_var_array(array data, [, mixed options [, bool add_empty]]])
841 * Returns an array with all arguments defined in 'definition'.
842 */
PHP_FUNCTION(filter_var_array)843 PHP_FUNCTION(filter_var_array)
844 {
845 zval *array_input = NULL, *op = NULL;
846 zend_bool add_empty = 1;
847
848 if (zend_parse_parameters(ZEND_NUM_ARGS(), "a|zb", &array_input, &op, &add_empty) == FAILURE) {
849 return;
850 }
851
852 if (op && (Z_TYPE_P(op) != IS_ARRAY) && !(Z_TYPE_P(op) == IS_LONG && PHP_FILTER_ID_EXISTS(Z_LVAL_P(op)))) {
853 RETURN_FALSE;
854 }
855
856 php_filter_array_handler(array_input, op, return_value, add_empty);
857 }
858 /* }}} */
859
860 /* {{{ proto filter_list()
861 * Returns a list of all supported filters */
PHP_FUNCTION(filter_list)862 PHP_FUNCTION(filter_list)
863 {
864 int i, size = sizeof(filter_list) / sizeof(filter_list_entry);
865
866 if (zend_parse_parameters_none() == FAILURE) {
867 return;
868 }
869
870 array_init(return_value);
871 for (i = 0; i < size; ++i) {
872 add_next_index_string(return_value, (char *)filter_list[i].name);
873 }
874 }
875 /* }}} */
876
877 /* {{{ proto filter_id(string filtername)
878 * Returns the filter ID belonging to a named filter */
PHP_FUNCTION(filter_id)879 PHP_FUNCTION(filter_id)
880 {
881 int i;
882 size_t filter_len;
883 int size = sizeof(filter_list) / sizeof(filter_list_entry);
884 char *filter;
885
886 if (zend_parse_parameters(ZEND_NUM_ARGS(), "s", &filter, &filter_len) == FAILURE) {
887 return;
888 }
889
890 for (i = 0; i < size; ++i) {
891 if (strcmp(filter_list[i].name, filter) == 0) {
892 RETURN_LONG(filter_list[i].id);
893 }
894 }
895
896 RETURN_FALSE;
897 }
898 /* }}} */
899