File Manager

✏️ /

/*
   +----------------------------------------------------------------------+
   | Zend Engine                                                          |
   +----------------------------------------------------------------------+
   | Copyright (c) Zend Technologies Ltd. (http://www.zend.com)           |
   +----------------------------------------------------------------------+
   | This source file is subject to version 2.00 of the Zend license,     |
   | that is bundled with this package in the file LICENSE, and is        |
   | available through the world-wide-web at the following url:           |
   | http://www.zend.com/license/2_00.txt.                                |
   | If you did not receive a copy of the Zend license and are unable to  |
   | obtain it through the world-wide-web, please send a note to          |
   | license@zend.com so we can mail you a copy immediately.              |
   +----------------------------------------------------------------------+
   | Authors: Levi Morrison <levim@php.net>                               |
   |          Sammy Kaye Powers <sammyk@php.net>                          |
   |          Bob Weinand <bobwei9@hotmail.com>                           |
   +----------------------------------------------------------------------+
*/

#ifndef ZEND_OBSERVER_H
#define ZEND_OBSERVER_H

#include "zend.h"
#include "zend_compile.h"
#include "zend_fibers.h"

BEGIN_EXTERN_C()

extern ZEND_API int zend_observer_fcall_op_array_extension;
extern ZEND_API int zend_observer_fcall_internal_function_extension;
extern ZEND_API bool zend_observer_errors_observed;
extern ZEND_API bool zend_observer_function_declared_observed;
extern ZEND_API bool zend_observer_class_linked_observed;

#define ZEND_OBSERVER_HANDLE(function) (ZEND_USER_CODE((function)->type) \
	? zend_observer_fcall_op_array_extension : zend_observer_fcall_internal_function_extension)

#define ZEND_OBSERVER_DATA(function) \
	((zend_observer_fcall_begin_handler *)&ZEND_OP_ARRAY_EXTENSION((&(function)->common), ZEND_OBSERVER_HANDLE(function)))

/* Neither begin nor end handler present. Needs to be set in the slot of the begin handler.
 * Optimization reducing runtime checks. */
#define ZEND_OBSERVER_NONE_OBSERVED ((void *) 3)

/* Omit zend_observer_fcall_internal_function_extension check, they are set at the same time. */
#define ZEND_OBSERVER_ENABLED (zend_observer_fcall_op_array_extension != -1)

#define ZEND_OBSERVER_FCALL_BEGIN(execute_data) do { \
		if (ZEND_OBSERVER_ENABLED) { \
			zend_observer_fcall_begin(execute_data); \
		} \
	} while (0)

#define ZEND_OBSERVER_FCALL_END(execute_data, return_value) do { \
		if (ZEND_OBSERVER_ENABLED) { \
			zend_observer_fcall_end(execute_data, return_value); \
		} \
	} while (0)

typedef void (*zend_observer_fcall_begin_handler)(zend_execute_data *execute_data);
typedef void (*zend_observer_fcall_end_handler)(zend_execute_data *execute_data, zval *retval);

typedef struct _zend_observer_fcall_handlers {
	zend_observer_fcall_begin_handler begin;
	zend_observer_fcall_end_handler end;
} zend_observer_fcall_handlers;

/* If the fn should not be observed then return {NULL, NULL} */
typedef zend_observer_fcall_handlers (*zend_observer_fcall_init)(zend_execute_data *execute_data);

// Call during minit/startup ONLY
ZEND_API void zend_observer_fcall_register(zend_observer_fcall_init);

// Call during runtime, but only if you have used zend_observer_fcall_register.
// You must not have more than one begin and one end handler active at the same time. Remove the old one first, if there is an existing one.
ZEND_API void zend_observer_add_begin_handler(zend_function *function, zend_observer_fcall_begin_handler begin);
ZEND_API bool zend_observer_remove_begin_handler(zend_function *function, zend_observer_fcall_begin_handler begin, zend_observer_fcall_begin_handler *next);
ZEND_API void zend_observer_add_end_handler(zend_function *function, zend_observer_fcall_end_handler end);
ZEND_API bool zend_observer_remove_end_handler(zend_function *function, zend_observer_fcall_end_handler end, zend_observer_fcall_end_handler *next);

ZEND_API void zend_observer_startup(void); // Called by engine before MINITs
ZEND_API void zend_observer_post_startup(void); // Called by engine after MINITs
ZEND_API void zend_observer_activate(void);
ZEND_API void zend_observer_shutdown(void);

ZEND_API void ZEND_FASTCALL zend_observer_fcall_begin(zend_execute_data *execute_data);
/* prechecked: the call is actually observed. */
ZEND_API void ZEND_FASTCALL zend_observer_fcall_begin_prechecked(zend_execute_data *execute_data, zend_observer_fcall_begin_handler *observer_data);

static zend_always_inline bool zend_observer_handler_is_unobserved(zend_observer_fcall_begin_handler *handler) {
	return *handler == ZEND_OBSERVER_NONE_OBSERVED;
}

/* Initial check for observers has not happened yet or no observers are installed. */
static zend_always_inline bool zend_observer_fcall_has_no_observers(zend_execute_data *execute_data, bool allow_generator, zend_observer_fcall_begin_handler **handler) {
	zend_function *function = EX(func);
	void *ZEND_MAP_PTR(runtime_cache) = ZEND_MAP_PTR(function->common.run_time_cache);

if (function->common.fn_flags & (ZEND_ACC_CALL_VIA_TRAMPOLINE | (allow_generator ? 0 : ZEND_ACC_GENERATOR))) {
		return true;
	}

if (!ZEND_MAP_PTR(runtime_cache)) {
		return true;
	}

*handler = (zend_observer_fcall_begin_handler *)ZEND_MAP_PTR_GET(runtime_cache) + ZEND_OBSERVER_HANDLE(function);
	return zend_observer_handler_is_unobserved(*handler);
}

/* zend_observer_fcall_begin(), but with generator check inlined and optimized away. */
static zend_always_inline void zend_observer_fcall_begin_specialized(zend_execute_data *execute_data, bool allow_generator) {
	zend_observer_fcall_begin_handler *handler;
	if (!zend_observer_fcall_has_no_observers(execute_data, allow_generator, &handler)) {
		zend_observer_fcall_begin_prechecked(execute_data, handler);
	}
}

ZEND_API void ZEND_FASTCALL zend_observer_generator_resume(zend_execute_data *execute_data);

/* prechecked: the call is actually observed. */
ZEND_API void ZEND_FASTCALL zend_observer_fcall_end_prechecked(zend_execute_data *execute_data, zval *return_value);
static zend_always_inline void zend_observer_fcall_end(zend_execute_data *execute_data, zval *return_value) {
	if (execute_data == EG(current_observed_frame)) {
		zend_observer_fcall_end_prechecked(execute_data, return_value);
	}
}

ZEND_API void zend_observer_fcall_end_all(void);

typedef void (*zend_observer_function_declared_cb)(zend_op_array *op_array, zend_string *name);

ZEND_API void zend_observer_function_declared_register(zend_observer_function_declared_cb cb);
ZEND_API void ZEND_FASTCALL _zend_observer_function_declared_notify(zend_op_array *op_array, zend_string *name);
static inline void zend_observer_function_declared_notify(zend_op_array *op_array, zend_string *name) {
    if (UNEXPECTED(zend_observer_function_declared_observed)) {
		_zend_observer_function_declared_notify(op_array, name);
	}
}

typedef void (*zend_observer_class_linked_cb)(zend_class_entry *ce, zend_string *name);

ZEND_API void zend_observer_class_linked_register(zend_observer_class_linked_cb cb);
ZEND_API void ZEND_FASTCALL _zend_observer_class_linked_notify(zend_class_entry *ce, zend_string *name);
static inline void zend_observer_class_linked_notify(zend_class_entry *ce, zend_string *name) {
	if (UNEXPECTED(zend_observer_class_linked_observed)) {
		_zend_observer_class_linked_notify(ce, name);
	}
}

typedef void (*zend_observer_error_cb)(int type, zend_string *error_filename, uint32_t error_lineno, zend_string *message);

ZEND_API void zend_observer_error_register(zend_observer_error_cb callback);
ZEND_API void _zend_observer_error_notify(int type, zend_string *error_filename, uint32_t error_lineno, zend_string *message);
static inline void zend_observer_error_notify(int type, zend_string *error_filename, uint32_t error_lineno, zend_string *message) {
	if (UNEXPECTED(zend_observer_errors_observed)) {
		_zend_observer_error_notify(type, error_filename, error_lineno, message);
	}
}

typedef void (*zend_observer_fiber_init_handler)(zend_fiber_context *initializing);
typedef void (*zend_observer_fiber_switch_handler)(zend_fiber_context *from, zend_fiber_context *to);
typedef void (*zend_observer_fiber_destroy_handler)(zend_fiber_context *destroying);

ZEND_API void zend_observer_fiber_init_register(zend_observer_fiber_init_handler handler);
ZEND_API void zend_observer_fiber_switch_register(zend_observer_fiber_switch_handler handler);
ZEND_API void zend_observer_fiber_destroy_register(zend_observer_fiber_destroy_handler handler);

ZEND_API void ZEND_FASTCALL zend_observer_fiber_init_notify(zend_fiber_context *initializing);
ZEND_API void ZEND_FASTCALL zend_observer_fiber_switch_notify(zend_fiber_context *from, zend_fiber_context *to);
ZEND_API void ZEND_FASTCALL zend_observer_fiber_destroy_notify(zend_fiber_context *destroying);

END_EXTERN_C()

#endif /* ZEND_OBSERVER_H */

Batal

⬅ php 100 item

Nama	Tipe	Ukuran	Diubah	Aksi
📁Optimizer	dir	—	2026-03-31 19:54	📂 Buka
📄zend.h	h	17.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_API.h	h	106.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_alloc.h	h	20.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_alloc_sizes.h	h	2.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_arena.h	h	5.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_ast.h	h	13.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_atomic.h	h	12.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_attributes.h	h	5.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_attributes_arginfo.h	h	14.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_bitset.h	h	7.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_build.h	h	1.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_builtin_functions.h	h	1.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_builtin_functions_arginfo.h	h	14.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_call_stack.h	h	3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_closures.h	h	2.3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_closures_arginfo.h	h	2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_compile.h	h	52.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_config.h	h	32 B	2026-03-12 17:18	✏️ 👁️
📄zend_constants.h	h	7 KB	2026-03-12 17:18	✏️ 👁️
📄zend_constants_arginfo.h	h	1.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_cpuinfo.h	h	9.3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_dtrace.h	h	2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_enum.h	h	2.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_enum_arginfo.h	h	1.7 KB	2026-03-12 17:18	✏️ 👁️
📄zend_errors.h	h	2.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_exceptions.h	h	4.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_exceptions_arginfo.h	h	17.3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_execute.h	h	23.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_extensions.h	h	6.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_fibers.h	h	5.3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_fibers_arginfo.h	h	3.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_float.h	h	15.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_frameless_function.h	h	5.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_gc.h	h	4.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_gdb.h	h	1.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_generators.h	h	7.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_generators_arginfo.h	h	2.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_globals.h	h	9.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_globals_macros.h	h	2.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_hash.h	h	50.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_highlight.h	h	2.3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_hrtime.h	h	3.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_inheritance.h	h	3.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_ini.h	h	11.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_ini_parser.h	h	3.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_ini_scanner.h	h	1.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_ini_scanner_defs.h	h	205 B	2026-03-12 17:18	✏️ 👁️
📄zend_interfaces.h	h	4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_interfaces_arginfo.h	h	7.7 KB	2026-03-12 17:18	✏️ 👁️
📄zend_iterators.h	h	3.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_language_parser.h	h	11 KB	2026-03-12 17:18	✏️ 👁️
📄zend_language_scanner.h	h	3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_language_scanner_defs.h	h	264 B	2026-03-12 17:18	✏️ 👁️
📄zend_lazy_objects.h	h	4.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_list.h	h	3.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_llist.h	h	3.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_long.h	h	4.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_map_ptr.h	h	3.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_max_execution_timer.h	h	1.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_mmap.h	h	1.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_modules.h	h	4.7 KB	2026-03-12 17:18	✏️ 👁️
📄zend_multibyte.h	h	4.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_multiply.h	h	10.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_object_handlers.h	h	17.7 KB	2026-03-12 17:18	✏️ 👁️
📄zend_objects.h	h	1.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_objects_API.h	h	5.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_observer.h	h	8.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_operators.h	h	33.3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_portability.h	h	26.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_property_hooks.h	h	1.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_ptr_stack.h	h	4.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_range_check.h	h	2.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_signal.h	h	4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_smart_str.h	h	6.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_smart_str_public.h	h	1.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_smart_string.h	h	4.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_smart_string_public.h	h	1.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_sort.h	h	1.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_stack.h	h	2.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_stream.h	h	3.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_string.h	h	22.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_strtod.h	h	2.3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_strtod_int.h	h	2.8 KB	2026-03-12 17:18	✏️ 👁️
📄zend_system_id.h	h	1.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_type_info.h	h	4.4 KB	2026-03-12 17:18	✏️ 👁️
📄zend_types.h	h	51.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_variables.h	h	3 KB	2026-03-12 17:18	✏️ 👁️
📄zend_verify_type_inference.h	h	8.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_virtual_cwd.h	h	12.9 KB	2026-03-12 17:18	✏️ 👁️
📄zend_vm.h	h	2.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_vm_def.h	h	295.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_vm_execute.h	h	2.2 MB	2026-03-12 17:18	✏️ 👁️
📄zend_vm_handlers.h	h	90.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_vm_opcodes.h	h	13.5 KB	2026-03-12 17:18	✏️ 👁️
📄zend_vm_trace_handlers.h	h	3.1 KB	2026-03-12 17:18	✏️ 👁️
📄zend_vm_trace_lines.h	h	1.7 KB	2026-03-12 17:18	✏️ 👁️
📄zend_vm_trace_map.h	h	2.6 KB	2026-03-12 17:18	✏️ 👁️
📄zend_weakrefs.h	h	3.2 KB	2026-03-12 17:18	✏️ 👁️
📄zend_weakrefs_arginfo.h	h	3.4 KB	2026-03-12 17:18	✏️ 👁️

✏️ Rename