Annotation of embedaddon/php/ext/standard/php_var.h, revision 1.1.1.1

1.1       misho       1: /* 
                      2:    +----------------------------------------------------------------------+
                      3:    | PHP Version 5                                                        |
                      4:    +----------------------------------------------------------------------+
                      5:    | Copyright (c) 1997-2012 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:    | Author: Jani Lehtimäki <jkl@njet.net>                                |
                     16:    +----------------------------------------------------------------------+
                     17: */
                     18: 
                     19: /* $Id: php_var.h 321634 2012-01-01 13:15:04Z felipe $ */
                     20: 
                     21: #ifndef PHP_VAR_H
                     22: #define PHP_VAR_H
                     23: 
                     24: #include "ext/standard/php_smart_str_public.h"
                     25: 
                     26: PHP_FUNCTION(var_dump);
                     27: PHP_FUNCTION(var_export);
                     28: PHP_FUNCTION(debug_zval_dump);
                     29: PHP_FUNCTION(serialize);
                     30: PHP_FUNCTION(unserialize);
                     31: PHP_FUNCTION(memory_get_usage);
                     32: PHP_FUNCTION(memory_get_peak_usage);
                     33: 
                     34: PHPAPI void php_var_dump(zval **struc, int level TSRMLS_DC);
                     35: PHPAPI void php_var_export(zval **struc, int level TSRMLS_DC);
                     36: PHPAPI void php_var_export_ex(zval **struc, int level, smart_str *buf TSRMLS_DC);
                     37: 
                     38: PHPAPI void php_debug_zval_dump(zval **struc, int level TSRMLS_DC);
                     39: 
                     40: /* typdef HashTable php_serialize_data_t; */
                     41: #define php_serialize_data_t HashTable
                     42: 
                     43: struct php_unserialize_data {
                     44:        void *first;
                     45:        void *first_dtor;
                     46: };
                     47: 
                     48: typedef struct php_unserialize_data php_unserialize_data_t;
                     49: 
                     50: PHPAPI void php_var_serialize(smart_str *buf, zval **struc, php_serialize_data_t *var_hash TSRMLS_DC);
                     51: PHPAPI int php_var_unserialize(zval **rval, const unsigned char **p, const unsigned char *max, php_unserialize_data_t *var_hash TSRMLS_DC);
                     52: 
                     53: #define PHP_VAR_SERIALIZE_INIT(var_hash) \
                     54:    zend_hash_init(&(var_hash), 10, NULL, NULL, 0)
                     55: #define PHP_VAR_SERIALIZE_DESTROY(var_hash) \
                     56:    zend_hash_destroy(&(var_hash))
                     57: 
                     58: #define PHP_VAR_UNSERIALIZE_INIT(var_hash) \
                     59:        (var_hash).first = 0; \
                     60:        (var_hash).first_dtor = 0
                     61: #define PHP_VAR_UNSERIALIZE_DESTROY(var_hash) \
                     62:        var_destroy(&(var_hash))
                     63: 
                     64: PHPAPI void var_replace(php_unserialize_data_t *var_hash, zval *ozval, zval **nzval);
                     65: PHPAPI void var_push_dtor(php_unserialize_data_t *var_hash, zval **val);
                     66: PHPAPI void var_destroy(php_unserialize_data_t *var_hash);
                     67: 
                     68: #define PHP_VAR_UNSERIALIZE_ZVAL_CHANGED(var_hash, ozval, nzval) \
                     69:        var_replace((var_hash), (ozval), &(nzval))
                     70:        
                     71: PHPAPI zend_class_entry *php_create_empty_class(char *class_name, int len);
                     72: 
                     73: static inline int php_varname_check(char *name, int name_len, zend_bool silent TSRMLS_DC) /* {{{ */
                     74: {
                     75:     if (name_len == sizeof("GLOBALS") - 1 && !memcmp(name, "GLOBALS", sizeof("GLOBALS") - 1)) {
                     76:                if (!silent) {
                     77:                        php_error_docref(NULL TSRMLS_CC, E_WARNING, "Attempted GLOBALS variable overwrite");
                     78:                }
                     79:         return FAILURE;
                     80:     } else if (name[0] == '_' &&
                     81:             (
                     82:              (name_len == sizeof("_GET") - 1 && !memcmp(name, "_GET", sizeof("_GET") - 1)) ||
                     83:              (name_len == sizeof("_POST") - 1 && !memcmp(name, "_POST", sizeof("_POST") - 1)) ||
                     84:              (name_len == sizeof("_COOKIE") - 1 && !memcmp(name, "_COOKIE", sizeof("_COOKIE") - 1)) ||
                     85:              (name_len == sizeof("_ENV") - 1 && !memcmp(name, "_ENV", sizeof("_ENV") - 1)) ||
                     86:              (name_len == sizeof("_SERVER") - 1 && !memcmp(name, "_SERVER", sizeof("_SERVER") - 1)) ||
                     87:              (name_len == sizeof("_SESSION") - 1 && !memcmp(name, "_SESSION", sizeof("_SESSION") - 1)) ||
                     88:              (name_len == sizeof("_FILES") - 1  && !memcmp(name, "_FILES", sizeof("_FILES") - 1)) ||
                     89:              (name_len == sizeof("_REQUEST") -1 && !memcmp(name, "_REQUEST", sizeof("_REQUEST") - 1))
                     90:             )
                     91:             ) {
                     92:                if (!silent) {
                     93:                        php_error_docref(NULL TSRMLS_CC, E_WARNING, "Attempted super-global (%s) variable overwrite", name);
                     94:                }
                     95:         return FAILURE;
                     96:     } else if (name[0] == 'H' &&
                     97:             (
                     98:              (name_len == sizeof("HTTP_POST_VARS") - 1 && !memcmp(name, "HTTP_POST_VARS", sizeof("HTTP_POST_VARS") - 1)) ||
                     99:              (name_len == sizeof("HTTP_GET_VARS") - 1 && !memcmp(name, "HTTP_GET_VARS", sizeof("HTTP_GET_VARS") - 1)) ||
                    100:              (name_len == sizeof("HTTP_COOKIE_VARS") - 1 && !memcmp(name, "HTTP_COOKIE_VARS", sizeof("HTTP_COOKIE_VARS") - 1)) ||
                    101:              (name_len == sizeof("HTTP_ENV_VARS") - 1 && !memcmp(name, "HTTP_ENV_VARS", sizeof("HTTP_ENV_VARS") - 1)) ||
                    102:              (name_len == sizeof("HTTP_SERVER_VARS") - 1 && !memcmp(name, "HTTP_SERVER_VARS", sizeof("HTTP_SERVER_VARS") - 1)) ||
                    103:              (name_len == sizeof("HTTP_SESSION_VARS") - 1 && !memcmp(name, "HTTP_SESSION_VARS", sizeof("HTTP_SESSION_VARS") - 1)) ||
                    104:              (name_len == sizeof("HTTP_RAW_POST_DATA") - 1 && !memcmp(name, "HTTP_RAW_POST_DATA", sizeof("HTTP_RAW_POST_DATA") - 1)) ||
                    105:              (name_len == sizeof("HTTP_POST_FILES") - 1 && !memcmp(name, "HTTP_POST_FILES", sizeof("HTTP_POST_FILES") - 1))
                    106:             )
                    107:             ) {
                    108:                if (!silent) {
                    109:                        php_error_docref(NULL TSRMLS_CC, E_WARNING, "Attempted long input array (%s) overwrite", name);
                    110:                }
                    111:         return FAILURE;
                    112:     }
                    113:        return SUCCESS;
                    114: }
                    115: /* }}} */
                    116: 
                    117: #endif /* PHP_VAR_H */

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>