size, zend_api,
zend_debug and
zts |
Usually filled with the "STANDARD_MODULE_HEADER",
which fills these four members with the size
of the whole zend_module_entry, the ZEND_MODULE_API_NO,
whether it is a debug build or normal build
(ZEND_DEBUG) and if
ZTS is enabled (USING_ZTS). |
name |
Contains the module name (for example, "File functions", "Socket functions", "Crypt", etc.). This
name will show up in
phpinfo(), in the section "Additional
Modules." |
functions |
Points to the Zend function block,
discussed in the preceding section. |
module_startup_func |
This function is called once upon module
initialization and can be used to do one-time
initialization steps (such as initial memory
allocation, etc.). To indicate a failure
during initialization, return FAILURE; otherwise, SUCCESS. To mark this field as
unused, use NULL. To
declare a function, use the macro ZEND_MINIT. |
module_shutdown_func |
This function is called once upon module
shutdown and can be used to do one-time
deinitialization steps (such as memory
deallocation). This is the counterpart to module_startup_func().
To indicate a failure during
deinitialization, return
FAILURE; otherwise,
SUCCESS. To mark this field as unused,
use NULL. To declare
a function, use the macro ZEND_MSHUTDOWN. |
request_startup_func |
This function is called once upon every
page request and can be used to do one-time
initialization steps that are required to
process a request. To indicate a failure
here, return
FAILURE; otherwise,
SUCCESS. Note: As dynamic
loadable modules are loaded only on page
requests, the request startup function is
called right after the module startup
function (both initialization events happen
at the same time). To mark this field as
unused, use NULL. To
declare a function, use the macro ZEND_RINIT. |
request_shutdown_func |
This function is called once after every
page request and works as counterpart to request_startup_func().
To indicate a failure here, return FAILURE; otherwise, SUCCESS.
Note: As dynamic loadable modules
are loaded only on page requests, the request
shutdown function is immediately followed by
a call to the module shutdown handler (both
deinitialization events happen at the same
time). To mark this field as unused, use NULL. To declare a
function, use the macro
ZEND_RSHUTDOWN. |
info_func |
When phpinfo() is called
in a script, Zend cycles through all loaded
modules and calls this function. Every module
then has the chance to print its own
"footprint" into the output page. Generally
this is used to dump environmental or
statistical information. To mark this field
as unused, use NULL.
To declare a function, use the macro ZEND_MINFO. |
version |
The version of the module. You can use NO_VERSION_YET if you
don't want to give the module a version
number yet, but we really recommend that you
add a version string here. Such a version
string can look like this (in chronological
order): "2.5-dev",
"2.5RC1", "2.5" or
"2.5pl3". |
Remaining structure elements |
These are used internally and can be
prefilled by using the macro STANDARD_MODULE_PROPERTIES_EX.
You should not assign any values to them. Use
STANDARD_MODULE_PROPERTIES_EX only if
you use global startup and shutdown
functions; otherwise, use STANDARD_MODULE_PROPERTIES
directly. |