Coverage Report

Created: 2022-07-02 04:24

/src/php-src/Zend/zend_extensions.h
Line
Count
Source (jump to first uncovered line)
1
/*
2
   +----------------------------------------------------------------------+
3
   | Zend Engine                                                          |
4
   +----------------------------------------------------------------------+
5
   | Copyright (c) Zend Technologies Ltd. (http://www.zend.com)           |
6
   +----------------------------------------------------------------------+
7
   | This source file is subject to version 2.00 of the Zend 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.zend.com/license/2_00.txt.                                |
11
   | If you did not receive a copy of the Zend license and are unable to  |
12
   | obtain it through the world-wide-web, please send a note to          |
13
   | license@zend.com so we can mail you a copy immediately.              |
14
   +----------------------------------------------------------------------+
15
   | Authors: Andi Gutmans <andi@php.net>                                 |
16
   |          Zeev Suraski <zeev@php.net>                                 |
17
   +----------------------------------------------------------------------+
18
*/
19
20
#ifndef ZEND_EXTENSIONS_H
21
#define ZEND_EXTENSIONS_H
22
23
#include "zend_compile.h"
24
#include "zend_build.h"
25
26
/*
27
The constants below are derived from ext/opcache/ZendAccelerator.h
28
29
You can use the following macro to check the extension API version for compatibilities:
30
31
#define ZEND_EXTENSION_API_NO_5_0_X 220040412
32
#define ZEND_EXTENSION_API_NO_5_1_X 220051025
33
#define ZEND_EXTENSION_API_NO_5_2_X 220060519
34
#define ZEND_EXTENSION_API_NO_5_3_X 220090626
35
#define ZEND_EXTENSION_API_NO_5_4_X 220100525
36
#define ZEND_EXTENSION_API_NO_5_5_X 220121212
37
#define ZEND_EXTENSION_API_NO_5_6_X 220131226
38
#define ZEND_EXTENSION_API_NO_7_0_X 320151012
39
40
#if ZEND_EXTENSION_API_NO < ZEND_EXTENSION_API_NO_5_5_X
41
   // do something for php versions lower than 5.5.x
42
#endif
43
*/
44
45
/* The first number is the engine version and the rest is the date (YYYYMMDD).
46
 * This way engine 2/3 API no. is always greater than engine 1 API no..  */
47
0
#define ZEND_EXTENSION_API_NO 420190128
48
49
typedef struct _zend_extension_version_info {
50
  int zend_extension_api_no;
51
  char *build_id;
52
} zend_extension_version_info;
53
54
0
#define ZEND_EXTENSION_BUILD_ID "API" ZEND_TOSTR(ZEND_EXTENSION_API_NO) ZEND_BUILD_TS ZEND_BUILD_DEBUG ZEND_BUILD_SYSTEM ZEND_BUILD_EXTRA
55
56
typedef struct _zend_extension zend_extension;
57
58
/* Typedef's for zend_extension function pointers */
59
typedef int (*startup_func_t)(zend_extension *extension);
60
typedef void (*shutdown_func_t)(zend_extension *extension);
61
typedef void (*activate_func_t)(void);
62
typedef void (*deactivate_func_t)(void);
63
64
typedef void (*message_handler_func_t)(int message, void *arg);
65
66
typedef void (*op_array_handler_func_t)(zend_op_array *op_array);
67
68
typedef void (*statement_handler_func_t)(zend_execute_data *frame);
69
typedef void (*fcall_begin_handler_func_t)(zend_execute_data *frame);
70
typedef void (*fcall_end_handler_func_t)(zend_execute_data *frame);
71
72
typedef void (*op_array_ctor_func_t)(zend_op_array *op_array);
73
typedef void (*op_array_dtor_func_t)(zend_op_array *op_array);
74
typedef size_t (*op_array_persist_calc_func_t)(zend_op_array *op_array);
75
typedef size_t (*op_array_persist_func_t)(zend_op_array *op_array, void *mem);
76
77
struct _zend_extension {
78
  char *name;
79
  char *version;
80
  char *author;
81
  char *URL;
82
  char *copyright;
83
84
  startup_func_t startup;
85
  shutdown_func_t shutdown;
86
  activate_func_t activate;
87
  deactivate_func_t deactivate;
88
89
  message_handler_func_t message_handler;
90
91
  op_array_handler_func_t op_array_handler;
92
93
  statement_handler_func_t statement_handler;
94
  fcall_begin_handler_func_t fcall_begin_handler;
95
  fcall_end_handler_func_t fcall_end_handler;
96
97
  op_array_ctor_func_t op_array_ctor;
98
  op_array_dtor_func_t op_array_dtor;
99
100
  int (*api_no_check)(int api_no);
101
  int (*build_id_check)(const char* build_id);
102
  op_array_persist_calc_func_t op_array_persist_calc;
103
  op_array_persist_func_t op_array_persist;
104
  void *reserved5;
105
  void *reserved6;
106
  void *reserved7;
107
  void *reserved8;
108
109
  DL_HANDLE handle;
110
  int resource_number;
111
};
112
113
BEGIN_EXTERN_C()
114
extern ZEND_API int zend_op_array_extension_handles;
115
116
ZEND_API int zend_get_resource_handle(zend_extension *extension);
117
ZEND_API int zend_get_op_array_extension_handle(void);
118
ZEND_API void zend_extension_dispatch_message(int message, void *arg);
119
END_EXTERN_C()
120
121
0
#define ZEND_EXTMSG_NEW_EXTENSION   1
122
123
124
#define ZEND_EXTENSION()  \
125
  ZEND_EXT_API zend_extension_version_info extension_version_info = { ZEND_EXTENSION_API_NO, ZEND_EXTENSION_BUILD_ID }
126
127
#define STANDARD_ZEND_EXTENSION_PROPERTIES       NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, -1
128
#define COMPAT_ZEND_EXTENSION_PROPERTIES         NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, -1
129
#define BUILD_COMPAT_ZEND_EXTENSION_PROPERTIES   NULL, NULL, NULL, NULL, NULL, NULL, NULL, -1
130
131
132
ZEND_API extern zend_llist zend_extensions;
133
ZEND_API extern uint32_t zend_extension_flags;
134
135
276k
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_CTOR         (1<<0)
136
259k
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_DTOR         (1<<1)
137
256k
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_HANDLER      (1<<2)
138
0
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_PERSIST_CALC (1<<3)
139
0
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_PERSIST      (1<<4)
140
141
void zend_extension_dtor(zend_extension *extension);
142
ZEND_API void zend_append_version_info(const zend_extension *extension);
143
int zend_startup_extensions_mechanism(void);
144
int zend_startup_extensions(void);
145
void zend_shutdown_extensions(void);
146
147
BEGIN_EXTERN_C()
148
ZEND_API int zend_load_extension(const char *path);
149
ZEND_API int zend_load_extension_handle(DL_HANDLE handle, const char *path);
150
ZEND_API int zend_register_extension(zend_extension *new_extension, DL_HANDLE handle);
151
ZEND_API zend_extension *zend_get_extension(const char *extension_name);
152
ZEND_API size_t zend_extensions_op_array_persist_calc(zend_op_array *op_array);
153
ZEND_API size_t zend_extensions_op_array_persist(zend_op_array *op_array, void *mem);
154
END_EXTERN_C()
155
156
#endif /* ZEND_EXTENSIONS_H */