This source file includes following definitions.
- zend_load_extension
- zend_register_extension
- zend_extension_shutdown
- zend_extension_startup
- zend_startup_extensions_mechanism
- zend_startup_extensions
- zend_shutdown_extensions
- zend_extension_dtor
- zend_extension_message_dispatcher
- zend_extension_dispatch_message
- zend_get_resource_handle
- zend_get_extension
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22 #include "zend_extensions.h"
23
24 ZEND_API zend_llist zend_extensions;
25 static int last_resource_number;
26
27 int zend_load_extension(const char *path)
28 {
29 #if ZEND_EXTENSIONS_SUPPORT
30 DL_HANDLE handle;
31 zend_extension *new_extension;
32 zend_extension_version_info *extension_version_info;
33
34 handle = DL_LOAD(path);
35 if (!handle) {
36 #ifndef ZEND_WIN32
37 fprintf(stderr, "Failed loading %s: %s\n", path, DL_ERROR());
38
39 #ifdef PHP_WIN32
40 fflush(stderr);
41 #endif
42 #else
43 fprintf(stderr, "Failed loading %s\n", path);
44 #endif
45 return FAILURE;
46 }
47
48 extension_version_info = (zend_extension_version_info *) DL_FETCH_SYMBOL(handle, "extension_version_info");
49 if (!extension_version_info) {
50 extension_version_info = (zend_extension_version_info *) DL_FETCH_SYMBOL(handle, "_extension_version_info");
51 }
52 new_extension = (zend_extension *) DL_FETCH_SYMBOL(handle, "zend_extension_entry");
53 if (!new_extension) {
54 new_extension = (zend_extension *) DL_FETCH_SYMBOL(handle, "_zend_extension_entry");
55 }
56 if (!extension_version_info || !new_extension) {
57 fprintf(stderr, "%s doesn't appear to be a valid Zend extension\n", path);
58
59 #ifdef PHP_WIN32
60 fflush(stderr);
61 #endif
62 DL_UNLOAD(handle);
63 return FAILURE;
64 }
65
66
67
68 if (extension_version_info->zend_extension_api_no != ZEND_EXTENSION_API_NO &&(!new_extension->api_no_check || new_extension->api_no_check(ZEND_EXTENSION_API_NO) != SUCCESS)) {
69 if (extension_version_info->zend_extension_api_no > ZEND_EXTENSION_API_NO) {
70 fprintf(stderr, "%s requires Zend Engine API version %d.\n"
71 "The Zend Engine API version %d which is installed, is outdated.\n\n",
72 new_extension->name,
73 extension_version_info->zend_extension_api_no,
74 ZEND_EXTENSION_API_NO);
75
76 #ifdef PHP_WIN32
77 fflush(stderr);
78 #endif
79 DL_UNLOAD(handle);
80 return FAILURE;
81 } else if (extension_version_info->zend_extension_api_no < ZEND_EXTENSION_API_NO) {
82 fprintf(stderr, "%s requires Zend Engine API version %d.\n"
83 "The Zend Engine API version %d which is installed, is newer.\n"
84 "Contact %s at %s for a later version of %s.\n\n",
85 new_extension->name,
86 extension_version_info->zend_extension_api_no,
87 ZEND_EXTENSION_API_NO,
88 new_extension->author,
89 new_extension->URL,
90 new_extension->name);
91
92 #ifdef PHP_WIN32
93 fflush(stderr);
94 #endif
95 DL_UNLOAD(handle);
96 return FAILURE;
97 }
98 } else if (strcmp(ZEND_EXTENSION_BUILD_ID, extension_version_info->build_id) &&
99 (!new_extension->build_id_check || new_extension->build_id_check(ZEND_EXTENSION_BUILD_ID) != SUCCESS)) {
100 fprintf(stderr, "Cannot load %s - it was built with configuration %s, whereas running engine is %s\n",
101 new_extension->name, extension_version_info->build_id, ZEND_EXTENSION_BUILD_ID);
102
103 #ifdef PHP_WIN32
104 fflush(stderr);
105 #endif
106 DL_UNLOAD(handle);
107 return FAILURE;
108 } else if (zend_get_extension(new_extension->name)) {
109 fprintf(stderr, "Cannot load %s - extension already loaded\n", new_extension->name);
110
111 #ifdef PHP_WIN32
112 fflush(stderr);
113 #endif
114 DL_UNLOAD(handle);
115 return FAILURE;
116 }
117
118 return zend_register_extension(new_extension, handle);
119 #else
120 fprintf(stderr, "Extensions are not supported on this platform.\n");
121
122 #ifdef PHP_WIN32
123 fflush(stderr);
124 #endif
125 return FAILURE;
126 #endif
127 }
128
129
130 int zend_register_extension(zend_extension *new_extension, DL_HANDLE handle)
131 {
132 #if ZEND_EXTENSIONS_SUPPORT
133 zend_extension extension;
134
135 extension = *new_extension;
136 extension.handle = handle;
137
138 zend_extension_dispatch_message(ZEND_EXTMSG_NEW_EXTENSION, &extension);
139
140 zend_llist_add_element(&zend_extensions, &extension);
141
142
143 #endif
144
145 return SUCCESS;
146 }
147
148
149 static void zend_extension_shutdown(zend_extension *extension TSRMLS_DC)
150 {
151 #if ZEND_EXTENSIONS_SUPPORT
152 if (extension->shutdown) {
153 extension->shutdown(extension);
154 }
155 #endif
156 }
157
158 static int zend_extension_startup(zend_extension *extension)
159 {
160 #if ZEND_EXTENSIONS_SUPPORT
161 if (extension->startup) {
162 if (extension->startup(extension)!=SUCCESS) {
163 return 1;
164 }
165 zend_append_version_info(extension);
166 }
167 #endif
168 return 0;
169 }
170
171
172 int zend_startup_extensions_mechanism()
173 {
174
175 zend_llist_init(&zend_extensions, sizeof(zend_extension), (void (*)(void *)) zend_extension_dtor, 1);
176 last_resource_number = 0;
177 return SUCCESS;
178 }
179
180
181 int zend_startup_extensions()
182 {
183 zend_llist_apply_with_del(&zend_extensions, (int (*)(void *)) zend_extension_startup);
184 return SUCCESS;
185 }
186
187
188 void zend_shutdown_extensions(TSRMLS_D)
189 {
190 zend_llist_apply(&zend_extensions, (llist_apply_func_t) zend_extension_shutdown TSRMLS_CC);
191 zend_llist_destroy(&zend_extensions);
192 }
193
194
195 void zend_extension_dtor(zend_extension *extension)
196 {
197 #if ZEND_EXTENSIONS_SUPPORT && !ZEND_DEBUG
198 if (extension->handle) {
199 DL_UNLOAD(extension->handle);
200 }
201 #endif
202 }
203
204
205 static void zend_extension_message_dispatcher(const zend_extension *extension, int num_args, va_list args TSRMLS_DC)
206 {
207 int message;
208 void *arg;
209
210 if (!extension->message_handler || num_args!=2) {
211 return;
212 }
213 message = va_arg(args, int);
214 arg = va_arg(args, void *);
215 extension->message_handler(message, arg);
216 }
217
218
219 ZEND_API void zend_extension_dispatch_message(int message, void *arg)
220 {
221 TSRMLS_FETCH();
222
223 zend_llist_apply_with_arguments(&zend_extensions, (llist_apply_with_args_func_t) zend_extension_message_dispatcher TSRMLS_CC, 2, message, arg);
224 }
225
226
227 ZEND_API int zend_get_resource_handle(zend_extension *extension)
228 {
229 if (last_resource_number<ZEND_MAX_RESERVED_RESOURCES) {
230 extension->resource_number = last_resource_number;
231 return last_resource_number++;
232 } else {
233 return -1;
234 }
235 }
236
237
238 ZEND_API zend_extension *zend_get_extension(const char *extension_name)
239 {
240 zend_llist_element *element;
241
242 for (element = zend_extensions.head; element; element = element->next) {
243 zend_extension *extension = (zend_extension *) element->data;
244
245 if (!strcmp(extension->name, extension_name)) {
246 return extension;
247 }
248 }
249 return NULL;
250 }
251
252
253
254
255
256
257
258