Annotation of embedaddon/php/ext/standard/php_var.h, revision 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>