Module phper_doc::_06_module::_01_hooks

Hooks

PHP is a complex piece of machinery whose lifecycle really should be understood by anyone who wants to understand how PHP operates.

Refer: https://www.phpinternalsbook.com/php7/extensions_design/php_lifecycle.html

PHP provides many hooks in lifecycle for extension to override.

There are MINIT, MSHUTDOWN, RINIT, RSHUTDOWN, GINIT, RSHUTDOWN.

Correspondingly, PHPER sets these hooks to complete some internal operations, such as registering extension information, registering functions, classes, constants, etc., but also exposes these hooks to users to overwrite.

The following is the corresponding relationship between PHP hooks and Module methods:

PHP hooks	Module method
MINIT	on_module_init
MSHUTDOWN	on_module_shutdown
RINIT	on_request_init
RSHUTDOWN	on_request_shutdown

use phper::{modules::Module, php_get_module};

#[php_get_module]
pub fn get_module() -> Module {
    let mut module = Module::new(
        env!("CARGO_CRATE_NAME"),
        env!("CARGO_PKG_VERSION"),
        env!("CARGO_PKG_AUTHORS"),
    );

    module.on_module_init(|| {
        // Do somethings in `MINIT` stage.
    });

    module
}