PHP内核剖析：从SAPI启动到扩展加载的完整流程

PHP内核剖析：从SAPI启动到扩展加载的完整流程

理解PHP执行流程是开发扩展、排查性能问题的基础。本文以Apache + mod_php为例，梳理从Web请求进入到Zend引擎启动、扩展加载的关键路径。

整体架构：SAPI抽象层

PHP通过SAPI（Server Abstraction API）与Web服务器交互。常见SAPI：

• Apache 2.0 Handler（mod_php5.so）
• CGI/FastCGI（PHP-FPM）
• CLI（命令行）
• ISAPI（IIS）

编译PHP时生成mod_php5.so，Apache启动时加载该模块并注册Hook。请求到达.php文件时，控制权移交SAPI。

关键启动函数调用链

1. php_init_handler()（sapi/apache/mod_php5.c）
   注册清理函数，首次调用时执行：
   tsrm_startup()（线程安全资源管理器）
   sapi_startup(&apache_sapi_module)
php_apache_startup(&apache_sapi_module)
2. sapi_startup()（main/sapi.c）
   初始化sapi_globals_struct，保存请求基本信息（Headers、编码等）。核心步骤：
   sapi_globals_ctor()：初始化known_post_content_types HashTable（大小5）
   php_setup_sapi_content_types()：注册默认POST内容类型
   virtual_cwd_startup()、reentrancy_startup()
3. php_apache_startup() → php_module_startup()（main/main.c）
   PHP核心启动总入口，主要完成：
   ① 初始化zend_utility_functions（错误处理、输出、流操作函数指针）
   ② 设置环境变量
   ③ 加载php.ini配置（php_init_config()）
   ④ 注册内置扩展（zend_register_standard_ini_entries()，如array、mysql等）
   ⑤ 注册内部函数集
   ⑥ 加载外部扩展（php_ini_register_extensions()）
   ⑦ 启动所有扩展（zend_startup_extensions()）
   ⑧ 清理操作

深入扩展加载机制

1. php.ini解析与扩展列表构建

php_init_config()遍历extension=xxx指令，将模块路径加入php_extension_lists结构（engine为Zend扩展，functions为PHP扩展）。

2. 外部扩展注册入口

void php_ini_register_extensions(TSRMLS_D) {
    zend_llist_apply(&extension_lists.engine, php_load_zend_extension_cb TSRMLS_CC);
    zend_llist_apply(&extension_lists.functions, php_load_php_extension_cb TSRMLS_CC);
    zend_llist_destroy(&extension_lists.engine);
    zend_llist_destroy(&extension_lists.functions);
}

遍历链表调用回调函数加载扩展。

3. PHP扩展加载核心：php_load_php_extension_cb

static void php_load_php_extension_cb(void *arg TSRMLS_DC) {
    zend_load_extension(*((char **) arg));
}

最终调用zend_load_extension()（ext/standard/dl.c），通过dlopen加载共享库，获取get_module函数指针，调用它得到zend_module_entry。

4. 模块注册到全局Hash表

if (zend_hash_add(&module_registry, lcname, name_len+1, (void*)module, sizeof(zend_module_entry), (void**)&module_ptr) == FAILURE) {
    zend_error(E_CORE_WARNING, "Module '%s' already loaded", module->name);
    return NULL;
}

module_registry是全局扩展注册表，键为小写扩展名。

5. 扩展启动排序与初始化

zend_startup_modules(TSRMLS_C);  // 依赖排序、检测注册
zend_startup_extensions();       // 逐个调用 extension->startup()

此阶段执行各扩展的PHP_MINIT_FUNCTION，完成资源分配、INI注册、类/函数注册等。

总结流程图

Apache请求
   ↓
mod_php5.so Hook
   ↓
php_init_handler()
   ├─ sapi_startup() → sapi_globals初始化
   └─ php_apache_startup() → php_module_startup()
        ├─ zend_utility_functions 初始化
        ├─ php_init_config() → 解析php.ini、收集extension列表
        ├─ zend_register_standard_ini_entries() → 内置扩展
        ├─ php_ini_register_extensions() → 外部扩展
        │    ├─ zend_load_extension() → dlopen、获取module_entry
        │    └─ zend_hash_add(&module_registry) → 注册
        ├─ zend_startup_modules() → 依赖排序
        └─ zend_startup_extensions() → 调用MINIT

掌握此流程，可定位扩展加载失败、INI不生效、启动顺序依赖等疑难问题。