1999-04-08 02:10:10 +08:00
|
|
|
/*
|
|
|
|
+----------------------------------------------------------------------+
|
|
|
|
| Zend Engine |
|
|
|
|
+----------------------------------------------------------------------+
|
2019-01-30 17:23:29 +08:00
|
|
|
| Copyright (c) Zend Technologies Ltd. (http://www.zend.com) |
|
1999-04-08 02:10:10 +08:00
|
|
|
+----------------------------------------------------------------------+
|
2001-12-11 23:16:21 +08:00
|
|
|
| This source file is subject to version 2.00 of the Zend license, |
|
2006-05-10 07:53:23 +08:00
|
|
|
| that is bundled with this package in the file LICENSE, and is |
|
2003-06-11 04:04:29 +08:00
|
|
|
| available through the world-wide-web at the following url: |
|
2001-12-11 23:16:21 +08:00
|
|
|
| http://www.zend.com/license/2_00.txt. |
|
1999-07-16 22:58:16 +08:00
|
|
|
| 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. |
|
1999-04-08 02:10:10 +08:00
|
|
|
+----------------------------------------------------------------------+
|
2018-11-01 23:20:07 +08:00
|
|
|
| Authors: Andi Gutmans <andi@php.net> |
|
|
|
|
| Zeev Suraski <zeev@php.net> |
|
1999-04-08 02:10:10 +08:00
|
|
|
+----------------------------------------------------------------------+
|
|
|
|
*/
|
|
|
|
|
2000-07-03 07:54:19 +08:00
|
|
|
#ifndef ZEND_EXTENSIONS_H
|
|
|
|
#define ZEND_EXTENSIONS_H
|
1999-04-08 02:10:10 +08:00
|
|
|
|
|
|
|
#include "zend_compile.h"
|
2009-01-17 10:05:13 +08:00
|
|
|
#include "zend_build.h"
|
1999-04-08 02:10:10 +08:00
|
|
|
|
2015-09-16 14:31:48 +08:00
|
|
|
/*
|
|
|
|
The constants below are derived from ext/opcache/ZendAccelerator.h
|
|
|
|
|
|
|
|
You can use the following macro to check the extension API version for compatibilities:
|
|
|
|
|
2015-10-22 20:26:37 +08:00
|
|
|
#define ZEND_EXTENSION_API_NO_5_0_X 220040412
|
|
|
|
#define ZEND_EXTENSION_API_NO_5_1_X 220051025
|
|
|
|
#define ZEND_EXTENSION_API_NO_5_2_X 220060519
|
|
|
|
#define ZEND_EXTENSION_API_NO_5_3_X 220090626
|
|
|
|
#define ZEND_EXTENSION_API_NO_5_4_X 220100525
|
|
|
|
#define ZEND_EXTENSION_API_NO_5_5_X 220121212
|
|
|
|
#define ZEND_EXTENSION_API_NO_5_6_X 220131226
|
|
|
|
#define ZEND_EXTENSION_API_NO_7_0_X 320151012
|
2015-09-16 14:31:48 +08:00
|
|
|
|
|
|
|
#if ZEND_EXTENSION_API_NO < ZEND_EXTENSION_API_NO_5_5_X
|
|
|
|
// do something for php versions lower than 5.5.x
|
|
|
|
#endif
|
|
|
|
*/
|
|
|
|
|
2014-09-20 07:24:03 +08:00
|
|
|
/* The first number is the engine version and the rest is the date (YYYYMMDD).
|
2015-10-22 20:26:37 +08:00
|
|
|
* This way engine 2/3 API no. is always greater than engine 1 API no.. */
|
2019-01-28 17:43:42 +08:00
|
|
|
#define ZEND_EXTENSION_API_NO 420190128
|
1999-04-08 02:10:10 +08:00
|
|
|
|
1999-05-23 00:10:51 +08:00
|
|
|
typedef struct _zend_extension_version_info {
|
1999-04-08 02:10:10 +08:00
|
|
|
int zend_extension_api_no;
|
2009-01-17 10:05:13 +08:00
|
|
|
char *build_id;
|
1999-04-08 02:10:10 +08:00
|
|
|
} zend_extension_version_info;
|
|
|
|
|
2009-01-17 10:05:13 +08:00
|
|
|
#define ZEND_EXTENSION_BUILD_ID "API" ZEND_TOSTR(ZEND_EXTENSION_API_NO) ZEND_BUILD_TS ZEND_BUILD_DEBUG ZEND_BUILD_SYSTEM ZEND_BUILD_EXTRA
|
1999-04-08 02:10:10 +08:00
|
|
|
|
|
|
|
typedef struct _zend_extension zend_extension;
|
|
|
|
|
2000-11-14 01:30:42 +08:00
|
|
|
/* Typedef's for zend_extension function pointers */
|
|
|
|
typedef int (*startup_func_t)(zend_extension *extension);
|
|
|
|
typedef void (*shutdown_func_t)(zend_extension *extension);
|
2001-01-24 01:55:17 +08:00
|
|
|
typedef void (*activate_func_t)(void);
|
|
|
|
typedef void (*deactivate_func_t)(void);
|
2000-11-14 01:30:42 +08:00
|
|
|
|
|
|
|
typedef void (*message_handler_func_t)(int message, void *arg);
|
|
|
|
|
|
|
|
typedef void (*op_array_handler_func_t)(zend_op_array *op_array);
|
|
|
|
|
2016-05-04 16:25:59 +08:00
|
|
|
typedef void (*statement_handler_func_t)(zend_execute_data *frame);
|
|
|
|
typedef void (*fcall_begin_handler_func_t)(zend_execute_data *frame);
|
|
|
|
typedef void (*fcall_end_handler_func_t)(zend_execute_data *frame);
|
2000-11-14 01:30:42 +08:00
|
|
|
|
|
|
|
typedef void (*op_array_ctor_func_t)(zend_op_array *op_array);
|
|
|
|
typedef void (*op_array_dtor_func_t)(zend_op_array *op_array);
|
2015-09-25 16:50:38 +08:00
|
|
|
typedef size_t (*op_array_persist_calc_func_t)(zend_op_array *op_array);
|
|
|
|
typedef size_t (*op_array_persist_func_t)(zend_op_array *op_array, void *mem);
|
2000-11-14 01:30:42 +08:00
|
|
|
|
1999-04-08 02:10:10 +08:00
|
|
|
struct _zend_extension {
|
|
|
|
char *name;
|
|
|
|
char *version;
|
|
|
|
char *author;
|
|
|
|
char *URL;
|
|
|
|
char *copyright;
|
|
|
|
|
2000-11-14 01:30:42 +08:00
|
|
|
startup_func_t startup;
|
|
|
|
shutdown_func_t shutdown;
|
|
|
|
activate_func_t activate;
|
|
|
|
deactivate_func_t deactivate;
|
|
|
|
|
|
|
|
message_handler_func_t message_handler;
|
1999-04-08 02:10:10 +08:00
|
|
|
|
2000-11-14 01:30:42 +08:00
|
|
|
op_array_handler_func_t op_array_handler;
|
2000-04-29 18:20:40 +08:00
|
|
|
|
2006-05-10 07:53:23 +08:00
|
|
|
statement_handler_func_t statement_handler;
|
2000-11-14 01:30:42 +08:00
|
|
|
fcall_begin_handler_func_t fcall_begin_handler;
|
|
|
|
fcall_end_handler_func_t fcall_end_handler;
|
1999-04-08 02:10:10 +08:00
|
|
|
|
2000-11-14 01:30:42 +08:00
|
|
|
op_array_ctor_func_t op_array_ctor;
|
|
|
|
op_array_dtor_func_t op_array_dtor;
|
1999-04-08 02:10:10 +08:00
|
|
|
|
2000-11-14 01:30:42 +08:00
|
|
|
int (*api_no_check)(int api_no);
|
2009-04-08 20:19:01 +08:00
|
|
|
int (*build_id_check)(const char* build_id);
|
2015-09-25 16:50:38 +08:00
|
|
|
op_array_persist_calc_func_t op_array_persist_calc;
|
|
|
|
op_array_persist_func_t op_array_persist;
|
1999-04-08 02:10:10 +08:00
|
|
|
void *reserved5;
|
|
|
|
void *reserved6;
|
|
|
|
void *reserved7;
|
|
|
|
void *reserved8;
|
|
|
|
|
|
|
|
DL_HANDLE handle;
|
|
|
|
int resource_number;
|
|
|
|
};
|
|
|
|
|
2004-02-19 06:44:40 +08:00
|
|
|
BEGIN_EXTERN_C()
|
2018-10-17 20:52:50 +08:00
|
|
|
extern ZEND_API int zend_op_array_extension_handles;
|
|
|
|
|
1999-12-02 06:55:20 +08:00
|
|
|
ZEND_API int zend_get_resource_handle(zend_extension *extension);
|
2018-10-17 20:52:50 +08:00
|
|
|
ZEND_API int zend_get_op_array_extension_handle(void);
|
2014-12-14 06:06:14 +08:00
|
|
|
ZEND_API void zend_extension_dispatch_message(int message, void *arg);
|
2004-02-19 06:44:40 +08:00
|
|
|
END_EXTERN_C()
|
2000-04-29 18:20:40 +08:00
|
|
|
|
|
|
|
#define ZEND_EXTMSG_NEW_EXTENSION 1
|
1999-04-08 02:10:10 +08:00
|
|
|
|
|
|
|
|
|
|
|
#define ZEND_EXTENSION() \
|
2009-01-18 00:14:59 +08:00
|
|
|
ZEND_EXT_API zend_extension_version_info extension_version_info = { ZEND_EXTENSION_API_NO, ZEND_EXTENSION_BUILD_ID }
|
1999-04-08 02:10:10 +08:00
|
|
|
|
2009-04-09 07:06:16 +08:00
|
|
|
#define STANDARD_ZEND_EXTENSION_PROPERTIES NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, -1
|
|
|
|
#define COMPAT_ZEND_EXTENSION_PROPERTIES NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, -1
|
|
|
|
#define BUILD_COMPAT_ZEND_EXTENSION_PROPERTIES NULL, NULL, NULL, NULL, NULL, NULL, NULL, -1
|
1999-04-08 02:10:10 +08:00
|
|
|
|
|
|
|
|
|
|
|
ZEND_API extern zend_llist zend_extensions;
|
2015-09-25 16:50:38 +08:00
|
|
|
ZEND_API extern uint32_t zend_extension_flags;
|
|
|
|
|
|
|
|
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_CTOR (1<<0)
|
|
|
|
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_DTOR (1<<1)
|
|
|
|
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_HANDLER (1<<2)
|
|
|
|
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_PERSIST_CALC (1<<3)
|
|
|
|
#define ZEND_EXTENSIONS_HAVE_OP_ARRAY_PERSIST (1<<4)
|
1999-04-08 02:10:10 +08:00
|
|
|
|
|
|
|
void zend_extension_dtor(zend_extension *extension);
|
2014-10-13 01:22:03 +08:00
|
|
|
ZEND_API void zend_append_version_info(const zend_extension *extension);
|
2000-09-26 02:10:45 +08:00
|
|
|
int zend_startup_extensions_mechanism(void);
|
2000-04-28 23:52:02 +08:00
|
|
|
int zend_startup_extensions(void);
|
2014-12-14 06:06:14 +08:00
|
|
|
void zend_shutdown_extensions(void);
|
2004-02-19 06:44:40 +08:00
|
|
|
|
|
|
|
BEGIN_EXTERN_C()
|
2014-12-14 06:06:14 +08:00
|
|
|
ZEND_API int zend_load_extension(const char *path);
|
2017-07-13 20:27:19 +08:00
|
|
|
ZEND_API int zend_load_extension_handle(DL_HANDLE handle, const char *path);
|
2014-12-14 06:06:14 +08:00
|
|
|
ZEND_API int zend_register_extension(zend_extension *new_extension, DL_HANDLE handle);
|
2008-08-13 01:20:25 +08:00
|
|
|
ZEND_API zend_extension *zend_get_extension(const char *extension_name);
|
2015-09-25 16:50:38 +08:00
|
|
|
ZEND_API size_t zend_extensions_op_array_persist_calc(zend_op_array *op_array);
|
|
|
|
ZEND_API size_t zend_extensions_op_array_persist(zend_op_array *op_array, void *mem);
|
2004-02-19 06:44:40 +08:00
|
|
|
END_EXTERN_C()
|
1999-04-08 02:10:10 +08:00
|
|
|
|
2000-07-03 07:54:19 +08:00
|
|
|
#endif /* ZEND_EXTENSIONS_H */
|