File manager

MPEKTEMPEKTEMPEKTEMPEKMEPEPKEMEPMEPEKEK File manager

File manager - Edit - /opt/cpanel/ea-php82/root/usr/include/php/ext/session/php_session.h

Back
/* +----------------------------------------------------------------------+ \| Copyright (c) The PHP Group \| +----------------------------------------------------------------------+ \| This source file is subject to version 3.01 of the PHP license, \| \| that is bundled with this package in the file LICENSE, and is \| \| available through the world-wide-web at the following url: \| \| https://www.php.net/license/3_01.txt \| \| If you did not receive a copy of the PHP license and are unable to \| \| obtain it through the world-wide-web, please send a note to \| \| license@php.net so we can mail you a copy immediately. \| +----------------------------------------------------------------------+ \| Author: Sascha Schumann <sascha@schumann.cx> \| +----------------------------------------------------------------------+ / #ifndef PHP_SESSION_H #define PHP_SESSION_H #include "ext/standard/php_var.h" #include "ext/hash/php_hash.h" #define PHP_SESSION_API 20161017 #include "php_version.h" #define PHP_SESSION_VERSION PHP_VERSION / save handler macros / #define PS_NUM_APIS 9 #define PS_OPEN_ARGS void mod_data, const char save_path, const char session_name #define PS_CLOSE_ARGS void mod_data #define PS_READ_ARGS void mod_data, zend_string key, zend_string val, zend_long maxlifetime #define PS_WRITE_ARGS void mod_data, zend_string key, zend_string val, zend_long maxlifetime #define PS_DESTROY_ARGS void *mod_data, zend_string key #define PS_GC_ARGS void *mod_data, zend_long maxlifetime, zend_long nrdels #define PS_CREATE_SID_ARGS void mod_data #define PS_VALIDATE_SID_ARGS void mod_data, zend_string key #define PS_UPDATE_TIMESTAMP_ARGS void mod_data, zend_string key, zend_string val, zend_long maxlifetime typedef struct ps_module_struct { const char s_name; zend_result (s_open)(PS_OPEN_ARGS); zend_result (s_close)(PS_CLOSE_ARGS); zend_result (s_read)(PS_READ_ARGS); zend_result (s_write)(PS_WRITE_ARGS); zend_result (s_destroy)(PS_DESTROY_ARGS); zend_long (s_gc)(PS_GC_ARGS); zend_string (s_create_sid)(PS_CREATE_SID_ARGS); zend_result (s_validate_sid)(PS_VALIDATE_SID_ARGS); zend_result (s_update_timestamp)(PS_UPDATE_TIMESTAMP_ARGS); } ps_module; #define PS_GET_MOD_DATA() mod_data #define PS_SET_MOD_DATA(a) mod_data = (a) #define PS_OPEN_FUNC(x) zend_result ps_open_##x(PS_OPEN_ARGS) #define PS_CLOSE_FUNC(x) zend_result ps_close_##x(PS_CLOSE_ARGS) #define PS_READ_FUNC(x) zend_result ps_read_##x(PS_READ_ARGS) #define PS_WRITE_FUNC(x) zend_result ps_write_##x(PS_WRITE_ARGS) #define PS_DESTROY_FUNC(x) zend_result ps_delete_##x(PS_DESTROY_ARGS) #define PS_GC_FUNC(x) zend_long ps_gc_##x(PS_GC_ARGS) #define PS_CREATE_SID_FUNC(x) zend_string ps_create_sid_##x(PS_CREATE_SID_ARGS) #define PS_VALIDATE_SID_FUNC(x) zend_result ps_validate_sid_##x(PS_VALIDATE_SID_ARGS) #define PS_UPDATE_TIMESTAMP_FUNC(x) zend_result ps_update_timestamp_##x(PS_UPDATE_TIMESTAMP_ARGS) / Legacy save handler module definitions / #define PS_FUNCS(x) \ PS_OPEN_FUNC(x); \ PS_CLOSE_FUNC(x); \ PS_READ_FUNC(x); \ PS_WRITE_FUNC(x); \ PS_DESTROY_FUNC(x); \ PS_GC_FUNC(x); \ PS_CREATE_SID_FUNC(x) #define PS_MOD(x) \ #x, ps_open_##x, ps_close_##x, ps_read_##x, ps_write_##x, \ ps_delete_##x, ps_gc_##x, php_session_create_id, \ php_session_validate_sid, php_session_update_timestamp / Legacy SID creation enabled save handler module definitions / #define PS_FUNCS_SID(x) \ PS_OPEN_FUNC(x); \ PS_CLOSE_FUNC(x); \ PS_READ_FUNC(x); \ PS_WRITE_FUNC(x); \ PS_DESTROY_FUNC(x); \ PS_GC_FUNC(x); \ PS_CREATE_SID_FUNC(x); \ PS_VALIDATE_SID_FUNC(x); \ PS_UPDATE_TIMESTAMP_FUNC(x); #define PS_MOD_SID(x) \ #x, ps_open_##x, ps_close_##x, ps_read_##x, ps_write_##x, \ ps_delete_##x, ps_gc_##x, ps_create_sid_##x, \ php_session_validate_sid, php_session_update_timestamp / Update timestamp enabled save handler module definitions New save handlers should use this API / #define PS_FUNCS_UPDATE_TIMESTAMP(x) \ PS_OPEN_FUNC(x); \ PS_CLOSE_FUNC(x); \ PS_READ_FUNC(x); \ PS_WRITE_FUNC(x); \ PS_DESTROY_FUNC(x); \ PS_GC_FUNC(x); \ PS_CREATE_SID_FUNC(x); \ PS_VALIDATE_SID_FUNC(x); \ PS_UPDATE_TIMESTAMP_FUNC(x); #define PS_MOD_UPDATE_TIMESTAMP(x) \ #x, ps_open_##x, ps_close_##x, ps_read_##x, ps_write_##x, \ ps_delete_##x, ps_gc_##x, ps_create_sid_##x, \ ps_validate_sid_##x, ps_update_timestamp_##x typedef enum { php_session_disabled, php_session_none, php_session_active } php_session_status; typedef struct _php_session_rfc1867_progress { size_t sname_len; zval sid; smart_str key; zend_long update_step; zend_long next_update; double next_update_time; bool cancel_upload; bool apply_trans_sid; size_t content_length; zval data; / the array exported to session data / zval post_bytes_processed; /* data["bytes_processed"] / zval files; / data["files"] array / zval current_file; / array of currently uploading file / zval current_file_bytes_processed; } php_session_rfc1867_progress; typedef struct _php_ps_globals { char save_path; char session_name; zend_string id; char extern_referer_chk; char cache_limiter; zend_long cookie_lifetime; char cookie_path; char cookie_domain; bool cookie_secure; bool cookie_httponly; char cookie_samesite; const ps_module mod; const ps_module default_mod; void mod_data; php_session_status session_status; zend_long gc_probability; zend_long gc_divisor; zend_long gc_maxlifetime; int module_number; zend_long cache_expire; union { zval names[PS_NUM_APIS]; struct { zval ps_open; zval ps_close; zval ps_read; zval ps_write; zval ps_destroy; zval ps_gc; zval ps_create_sid; zval ps_validate_sid; zval ps_update_timestamp; } name; } mod_user_names; bool mod_user_implemented; bool mod_user_is_open; zend_string mod_user_class_name; const struct ps_serializer_struct serializer; zval http_session_vars; bool auto_start; bool use_cookies; bool use_only_cookies; bool use_trans_sid; / contains the INI value of whether to use trans-sid / zend_long sid_length; zend_long sid_bits_per_character; bool send_cookie; bool define_sid; php_session_rfc1867_progress rfc1867_progress; bool rfc1867_enabled; /* session.upload_progress.enabled / bool rfc1867_cleanup; / session.upload_progress.cleanup / char rfc1867_prefix; /* session.upload_progress.prefix / char rfc1867_name; /* session.upload_progress.name / zend_long rfc1867_freq; / session.upload_progress.freq / double rfc1867_min_freq; / session.upload_progress.min_freq / bool use_strict_mode; / whether or not PHP accepts unknown session ids / bool lazy_write; / omit session write when it is possible / bool in_save_handler; / state if session is in save handler or not / bool set_handler; / state if session module i setting handler or not / zend_string session_vars; /* serialized original session data / } php_ps_globals; typedef php_ps_globals zend_ps_globals; extern zend_module_entry session_module_entry; #define phpext_session_ptr &session_module_entry #ifdef ZTS #define PS(v) ZEND_TSRMG(ps_globals_id, php_ps_globals , v) #ifdef COMPILE_DL_SESSION ZEND_TSRMLS_CACHE_EXTERN() #endif #else #define PS(v) (ps_globals.v) #endif #define PS_SERIALIZER_ENCODE_ARGS void #define PS_SERIALIZER_DECODE_ARGS const char val, size_t vallen typedef struct ps_serializer_struct { const char name; zend_string (encode)(PS_SERIALIZER_ENCODE_ARGS); zend_result (decode)(PS_SERIALIZER_DECODE_ARGS); } ps_serializer; #define PS_SERIALIZER_ENCODE_NAME(x) ps_srlzr_encode_##x #define PS_SERIALIZER_DECODE_NAME(x) ps_srlzr_decode_##x #define PS_SERIALIZER_ENCODE_FUNC(x) \ zend_string PS_SERIALIZER_ENCODE_NAME(x)(PS_SERIALIZER_ENCODE_ARGS) #define PS_SERIALIZER_DECODE_FUNC(x) \ zend_result PS_SERIALIZER_DECODE_NAME(x)(PS_SERIALIZER_DECODE_ARGS) #define PS_SERIALIZER_FUNCS(x) \ PS_SERIALIZER_ENCODE_FUNC(x); \ PS_SERIALIZER_DECODE_FUNC(x) #define PS_SERIALIZER_ENTRY(x) \ { #x, PS_SERIALIZER_ENCODE_NAME(x), PS_SERIALIZER_DECODE_NAME(x) } /* default create id function / PHPAPI zend_string php_session_create_id(PS_CREATE_SID_ARGS); /* Dummy PS module functions / PHPAPI zend_result php_session_validate_sid(PS_VALIDATE_SID_ARGS); PHPAPI zend_result php_session_update_timestamp(PS_UPDATE_TIMESTAMP_ARGS); PHPAPI void session_adapt_url(const char url, size_t url_len, char *new_url, size_t new_len); PHPAPI zend_result php_session_destroy(void); PHPAPI void php_add_session_var(zend_string name); PHPAPI zval php_set_session_var(zend_string name, zval state_val, php_unserialize_data_t var_hash); PHPAPI zval php_get_session_var(zend_string name); PHPAPI zend_result php_session_register_module(const ps_module ); PHPAPI zend_result php_session_register_serializer(const char name, zend_string (encode)(PS_SERIALIZER_ENCODE_ARGS), zend_result (decode)(PS_SERIALIZER_DECODE_ARGS)); PHPAPI zend_result php_session_start(void); PHPAPI zend_result php_session_flush(int write); PHPAPI const ps_module _php_find_ps_module(const char name); PHPAPI const ps_serializer _php_find_ps_serializer(const char name); PHPAPI zend_result php_session_valid_key(const char key); PHPAPI zend_result php_session_reset_id(void); #define PS_ADD_VARL(name) do { \ php_add_session_var(name); \ } while (0) #define PS_ADD_VAR(name) PS_ADD_VARL(name) #define PS_DEL_VARL(name) do { \ if (!Z_ISNULL(PS(http_session_vars))) { \ zend_hash_del(Z_ARRVAL(PS(http_session_vars)), name); \ } \ } while (0) #define PS_ENCODE_VARS \ zend_string key; \ zend_ulong num_key; \ zval struc; #define PS_ENCODE_LOOP(code) do { \ HashTable _ht = Z_ARRVAL_P(Z_REFVAL(PS(http_session_vars))); \ ZEND_HASH_FOREACH_KEY(_ht, num_key, key) { \ if (key == NULL) { \ php_error_docref(NULL, E_WARNING, \ "Skipping numeric key " ZEND_LONG_FMT, num_key);\ continue; \ } \ if ((struc = php_get_session_var(key))) { \ code; \ } \ } ZEND_HASH_FOREACH_END(); \ } while(0) PHPAPI ZEND_EXTERN_MODULE_GLOBALS(ps) void php_session_auto_start(void data); extern PHPAPI zend_class_entry php_session_class_entry; extern PHPAPI zend_class_entry php_session_iface_entry; extern PHPAPI zend_class_entry php_session_id_iface_entry; extern PHPAPI zend_class_entry *php_session_update_timestamp_iface_entry; extern PHP_METHOD(SessionHandler, open); extern PHP_METHOD(SessionHandler, close); extern PHP_METHOD(SessionHandler, read); extern PHP_METHOD(SessionHandler, write); extern PHP_METHOD(SessionHandler, destroy); extern PHP_METHOD(SessionHandler, gc); extern PHP_METHOD(SessionHandler, create_sid); #endif