摸索PHP 生命周期
PHP 扩展钩子
你大概猜到了,PHP 引擎将在多个生命周期点触发你的扩展。我们称它们为钩子函数。你的扩展程序可以在向引擎注册时,通过声明函数钩子来声明对特定生命周期点的乐趣。
在你剖析 PHP 扩展构造时(zend_module_entry
构造),这些钩子可以清楚地看到:
struct _zend_module_entry { unsigned short size; unsigned int zend_api; unsigned char zend_debug; unsigned char zts; const struct _zend_ini_entry *ini_entry; const struct _zend_module_dep *deps; const char *name; const struct _zend_function_entry *functions; int (*module_startup_func)(INIT_FUNC_ARGS); /* MINIT() */ int (*module_shutdown_func)(SHUTDOWN_FUNC_ARGS); /* MSHUTDOWN() */ int (*request_startup_func)(INIT_FUNC_ARGS); /* RINIT() */ int (*request_shutdown_func)(SHUTDOWN_FUNC_ARGS); /* RSHUTDOWN() */ void (*info_func)(ZEND_MODULE_INFO_FUNC_ARGS); /* PHPINFO() */ const char *version; size_t globals_size; #ifdef ZTS ts_rsrc_id* globals_id_ptr; #else void* globals_ptr; #endif void (*globals_ctor)(void *global); /* GINIT() */ void (*globals_dtor)(void *global); /* GSHUTDOWN */ int (*post_deactivate_func)(void); /* PRSHUTDOWN() */ int module_started; unsigned char type; void *handle; int module_number; const char *build_id; };
此刻让我们看看你应当在这些钩子中编写哪种代码。
模块初始化:MINIT()
这是 PHP 进程启动步骤。在扩展的MINIT()
中,你将加载并分配今后每次恳求需要的任何耐久对象或者信息。它们的大部分将分配为只读对象。
在MINIT()
中,尚未有线程或进程弹出,所以你完全可以拜访全局变量,而没有任何庇护。别的,由于恳求尚未启动,因此你不克不及分配恳求绑定的内存。你永久不会在MINIT()
步骤中使用Zend 内存治理 分配,但是会使用永远分配。不是 emalloc()
,而是pemalloc()
。不然会致使崩溃。
在 MINIT()
中,施行引擎仍未启动,所以不要在没有特殊留意的状况下,尝试拜访其任何构造。
假如你需要为你的扩展注册 INI 入口,则MINIT()
是准确的做法。
假如你要为今后使用而注册只读zend_strings,请使用耐久分配了。
假如你需要分配的对象在处置恳求时会写入,那么你必需复制它们的内存分配到该恳求的线程专用池。记住,你只可以在MINIT()
中平安地写入全局空间。
留意
内存治理、分配和调试是内存治理的部分章节。
在 php_module_startup()函数中,通过zend_startup_modules()
触发 MINIT()
。
模块终止:MSHUTDOWN()
这是 PHP 进程终止步骤。很容易, 根本上,你在这里运转了与MINIT()
中使用的相反的操纵。你开释了资源,取消 INI 设定的注册等等。
再次留意:施行引擎是关闭的,所以你不该在此处拜访其任何变量。
由于你在此处不需要恳求,所以不该使用Zend 内存治理 的efree()
或相似函数去开释资源,但关于开释耐久分配,使用pefree()
。
在php_module_shutdown()函数中,由zend_shutdown()
的zend_destroy_modules()
中触发MSHUTDOWN()
。
恳求初始化: RINIT()
刚刚看过的恳求,PHP 将在这里处置它。在RINIT()
中,你指导了处置该准确恳求所需的资源。PHP 是一种无同享架构,它供给了内存治理功效。
在 RINIT()
中,假如需要分配动态内存,你将使用Zend 内存治理器。你将调取 emalloc()
。Zend 内存治理器 追踪你通过它分配的内存,当恳求关闭时,假如你健忘这么做,它将尝试开释恳求绑定的内存(你不该这么做)。
在这里,你不该恳求耐久的动态内存,即 libc 的malloc()
或Zend 的pemalloc()
。假如你在这里恳求耐久内存,并且健忘开释它,则将造成泄露,并且随着 PHP 处置越来越多的恳求而聚积,终究致使进程崩溃(Kernel OOM) ,并且致使机器内存不足。
别的,务必留意不要在这里写入全局空间。假如 PHP 作为选定的并行模型运转到线程中,那么你将修改每个线程池中的上下文(所有与你的恳求并行处置的恳求),并且假如你没有锁定内存,也大概触发竞争前提。假如你需要全局,你必需庇护它们。
留意
全局范畴治理说明在专用章节。
在php_request_startup()函数中,通过zend_activate_module()
触发RINIT()
。
恳求终止: RSHUTDOWN()
这是 PHP 恳求终止步骤。PHP 刚完毕处置其恳求,此刻来清算其部分作为无同享架构的内存。接下来的恳求不该记住当前恳求的任何内容。很容易,根本上,你在此处施行了与RINIT()
使用的相反的操纵。你开释了恳求绑定的资源。
由于你在此处使用了恳求,你应使用 Zend 内存治理器的efree()
或相似方式开释资源。假如你健忘开释并且造成泄露,在调试版本下,内存治理器将在进程stderr上记载关于泄露的指针的日记,并且将为你开释它们。
给你个主意,RSHUTDOWN()
将被调取:
- 施行会员区关闭功效后 (
register_shutdown_function()
) - 在调取每个对象析构函数之后
- PHP 输出缓冲区刷新之后
- 禁用 max_execution_time 之后
在php_request_shutdown()函数中,通过zend_deactivate_modules()
触发RSHUTDOWN()
。
Post 恳求终止: PRSHUTDOWN()
这个钩子很少使用。它在 RSHUTDOWN()
之后调取,但是中心还会运转一些额外的引擎代码。
特别是在 Post-RSHUTDOWN 中:
- PHP 输出缓冲区已关闭,并且它的处置程序已刷新
- PHP 超全局已经烧毁
- 施行引擎已经关闭
这个钩子很少使用。在php_request_shutdown()函数中,通过zend_post_deactivate_modules()
,在RSHUTDOWN()
之后被触发。
全局初始化: GINIT()
线程库每次弹出线程时都会调取该钩子。假如你使用多进程,当 PHP 启动,仅在触发 MINIT()
此前调取此函数。
这里不讲太多细节,只需在这里简便地初始化全局变量,平常初始化为0。全局治理将在专用章节具体说明。
记住,全局变量不会在每次恳求后清算。假如你需要为每次新的恳求重置它们(大概),那么你必需将这样地进程放到RINIT()
中。
留意
全局范畴治理在专用章节具体介绍。
全局终止: GSHUTDOWN()
在线程库中,每当线程终止时都会调取该钩子。假如你使用多线程,该函数将在 PHP 终止期间(在MSHUTDOWN()
)被调取一次。
在这里不供给太多细节,你只需简便地在这里取消初始化你的全局变量,平常你不必做什么,但假如在构建全局(GINIT()
)时分配了资源,在这里的步骤你应当开释它们。
全局治理将在专用章节具体介绍。
记住,全局变量在每次恳求后不会清除。即GSHUTDOWN()
不会作为RSHUTDOWN()
的一部分被调取。
留意
全局范畴治理在专用章节有具体介绍。
信息收集: MINFO()
该钩子很非凡,它永久不会被引擎主动触发,只要你扣问它有关扩展的信息时才会触发。典型的例子是调取phpinfo()
。然后运转此函数,并将有关当前扩展的非凡信息打印到流中。
简而言之,phpinfo()
展现信息。
该函数也可以通过 CLI 使用反射开关之一调取,例如php --ri pib
或通过会员区调取ini_get_all()
。
你可以将其留空,在这种状况下,只要扩展的名字显示,没有其他(大概不会显示 INI 设定,由于这是 MINFO() 的一部分)。
关于 PHP 生命周期的思索
你大概已经发明了,RINIT()
和 RSHUTDOWN()
特别重要,由于它们在扩展中被触发成千上万次。假如 PHP 步骤是关于 Web (不是 CLI),并且已经配置为可以处置很多次恳求,那么你的 RINIT()/RSHUTDOWN()
组将被很多次调取。
我们想要再次引发你对内存治理的关注。在处置恳求时(在RINIT()
和 RSHUTDOWN()
之间),你终究泄露的小字节,将对满载效劳器发生严峻影响。这就是为什么倡议你使用 Zend 内存治理器 停止此类分配,并且预备好调试内存规划。作为无同享架构的一部分,PHP 在每次恳求最后都会健忘并开释恳求内存,这是 PHP 的内部设计。
别的,假如你的崩溃信号是 SIGSEGV (坏内存拜访),则整个进程会崩溃。假如 PHP 是使用线程作为多进程引擎,那么你所有其他线程也将崩溃,乃至大概造成效劳器崩溃。
留意
C 说话不是 PHP 说话。使用 C,在程序的错误很大概致使程序的崩溃与终止。
通过重写函数指针停止挂钩
此刻你知道引擎何时会触发代码,还存在值得留意的函数指针,你可以更换它们来挂载到引擎。由于那些指针是全局变量,因此你可以将它们更换为 MINIT()
步骤,并将它们放回MSHUTDOWN()
中。
感乐趣的有:
AST, Zend/zend_ast.h:
- void (zend_ast_process_t)(zend_ast ast)
Compiler, Zend/zend_compile.h:
- zend_op_array (zend_compile_file)(zend_file_handle file_handle, int type)*
- zend_op_array (zend_compile_string)(zval source_string, char filename)
Executor, Zend/zend_execute.h:
- void (zend_execute_ex)(zend_execute_data execute_data)
- void (zend_execute_internal)(zend_execute_data execute_data, zval return_value)*
GC, Zend/zend_gc.h:
- int (gc_collect_cycles)(void)*
TSRM, TSRM/TSRM.h:
- void (tsrm_thread_begin_func_t)(THREAD_T thread_id)*
- void (tsrm_thread_end_func_t)(THREAD_T thread_id)*
Error, Zend/zend.h:
- void (zend_error_cb)(int type, const char error_filename, const uint error_lineno, const char format, va_list args)*
Exceptions, Zend/zend_exceptions.h:
- void (zend_throw_exception_hook)(zval ex)
Lifetime, Zend/zend.h:
- void (zend_on_timeout)(int seconds)*
- void (zend_interrupt_function)(zend_execute_data execute_data)
- void (zend_ticks_function)(int ticks)*
还有其他存在,但是上面的是最重要的,当你设计 PHP 扩展时,你大概需要。由于它们的名字很容易看,所以不再具体说明它们。
假如你需要更多信息,你可以在 PHP 源代码查看,并发明何时和怎样触发它们。
以上就是摸索PHP 生命周期的具体内容,更多请关注百分百源码网其它相关文章!