Extending and Embedding PHP－扩展和移植ＰＨＰ(一)

第一章　ＰＨＰ生命周期

在一个常见的ＷＥＢ服务器环境里，你根本无法明确什么时候开启ＰＨＰ解释器。只有在ＰＨＰ脚本被请求的时候，你才会启动apache或者其它服务器，它们会载入PHP并运行。
它们都以ＳＡＰＩ的方式开始
命令行虽然看起来非常不同，但实际上以相同的方式运行。在系统提示符下输入的ＰＨＰ命令，启动“命令行ＳＡＰＩ”，就像一个微形的网站服务器，服务于一个单一的请求。当脚本被执行完毕时，这个“微型服务器”关闭，把控制权交给shell。
启动和关闭
启动和关闭进程发生在两个独立的启动阶段和两个独立的关闭阶段。对于ＰＨＰ解释器的一个生命周期，作为一个整体，完成初始结构和数据的构建，继续ＳＡＰＩ的构建，另一方面为了暂时设置，只在单页被请求的时候。
最初的启动过程中，在任何请求被处理之前，PHP会调用所有扩展的MINIT(模块初始化)方法，这时，扩展被声明常量，定义类，注册资源，数据流和过滤程序，这些都可能在脚本被请求时使用。所设计的这些特性，贯穿于所有请求，被看作是持续存在的。
下面是一个常见的MINIT方法：

/* 初始化扩展模块
* 在SAPI 启动时发生
*/
PHP_MINIT_FUNCTION(myextension)
{
/* 全局设置: 参考１２章 */
#ifdef ZTS
ts_allocate_id(&myextension_globals_id,
sizeof(php_myextension_globals),
(ts_allocate_ctor) myextension_globals_ctor,
(ts_allocate_dtor) myextension_globals_dtor);
#else
myextension_globals_ctor(&myextension_globals TSRMLS_CC);
#endif
/* REGISTER_INI_ENTRIES() 参考在第１３章的全局结构"INI Settings"　*/

REGISTER_INI_ENTRIES();
/* define('MYEXT_MEANING', 42); */
REGISTER_LONG_CONSTANT("MYEXT_MEANING", 42, CONST_CS | CONST_PERSISTENT);
/* define('MYEXT_FOO', 'bar'); */
REGISTER_STRING_CONSTANT("MYEXT_FOO", "bar", CONST_CS | CONST_PERSISTENT);
/* Resources: chapter 9 */
le_myresource = zend_register_list_destructors_ex(
php_myext_myresource_dtor, NULL,
"My Resource Type", module_number);
le_myresource_persist = zend_register_list_destructors_ex(
NULL, php_myext_myresource_dtor,
"My Resource Type", module_number);
/* Stream Filters: Chapter 16 */
if (FAILURE == php_stream_filter_register_factory("myfilter",
&php_myextension_filter_factory TSRMLS_CC)) {
return FAILURE;
}
/* Stream Wrappers: Chapter 15 */
if (FAILURE == php_register_url_stream_wrapper ("myproto",
&php_myextension_stream_wrapper TSRMLS_CC)) {
return FAILURE;
}
/* Autoglobals: Chapter 12 */
#ifdef ZEND_ENGINE_2
if (zend_register_auto_global("_MYEXTENSION", sizeof("_MYEXTENSION") - 1,
NULL TSRMLS_CC) == FAILURE) {
return FAILURE;
}
zend_auto_global_disable_jit ("_MYEXTENSION", sizeof("_MYEXTENSION") - 1
TSRMLS_CC);
#else
if (zend_register_auto_global("_MYEXTENSION", sizeof("_MYEXTENSION") - 1
TSRMLS_CC) == FAILURE) {
return FAILURE;
}
#endif
return SUCCESS;
}

请求到来时，ＰＨＰ建立起一个包含所有变量的符号表，并同步目录配置。然后ＰＨＰ依次调用每个扩展的RINIT方法。这里，某个扩展也许重设一个全局变量为默认值，并存入符号表，或者做其它事，例如把请求记录到文件日志里。ＲＩＮＩＴ可以看作是一种对所有请求的预操作指令。