php扩展加载过程,PHP的执行流程,PHP扩展加载过程
Apache环境下,PHP通过mod_php5模块接收请求。SAPI(服务器API)启动后,执行php_init_handler,调用sapi_startup创建全局结构,再执行php_module_startup,依次加载php.ini配置、内置扩展、外部扩展,最后启动所有扩展并注册到模块注册表哈希表,完成PHP引擎初始化。这是Apache下PHP启动的关
为了以后能开发 PHP 扩展,理解 PHP 的执行顺序是绕不开的一步。这篇文章其实就是为用 C 语言开发 PHP 扩展做铺垫的。
先说 Web 环境,我们假设用的是 Apache。编译 PHP 时,为了让 Apache 支持 PHP,通常会生成一个 mod_php5.so 模块,然后 Apache 加载这个模块。当 URL 访问的是 .php 文件时,Apache 就会把请求转给 mod_php5.so 来处理。这个模块到底是什么?它就是我们常说的 SAPI,全称是 Server Abstraction API。
SAPI 其实是一个统称,下面包含 ISAPI、CLI SAPI、CGI 等。有了它,PHP 就能很方便地跟 Apache、IIS、CGI 这些外部环境交互。好了,回到正题。
Apache 启动后,会把 mod_php5.so 模块的 hook handler 注册进来。Apache 今天不是主角,所以不细说。当 Apache 检测到访问的 URL 是一个 PHP 文件时,控制权就会交给 SAPI。

进入 SAPI 后,首先执行的是 sapi/apache/mod_php5.c 文件中的 php_init_handler 函数。这个函数主要调用了两个函数:sapi_startup(&apache_sapi_module) 和 php_apache_startup(&apache_sapi_module)。
sapi_startup 会创建一个 sapi_globals_struct 结构体,这个结构体保存了 Apache 请求的基本信息,比如服务器信息、header、编码等。其中 known_post_content_types 是一个 HashTable,大小初始化为 5。从字面意思猜测,它保存的应该是客户端传递过来的内容类型。php_setup_sapi_content_types 函数会把 sapi_post_entry 添加到 sapi_globals 里。
sapi_startup 执行完毕后,再执行 php_apache_startup。这里面的核心其实是 php_module_startup,内容太多,简单介绍一下它的作用:
- 初始化
zend_utility_functions结构。这个结构用于设置 Zend 的函数指针,比如错误处理函数、输出函数、流操作函数等。 - 设置环境变量。
- 加载
php.ini配置。 - 加载 PHP 内置扩展。
- 写日志。
- 注册 PHP 内部函数集。
- 调用
php_ini_register_extensions,加载所有外部扩展。 - 开启所有扩展。
- 一些清理操作。
重点说一下第 3、4、7、8 步。
加载 php.ini 配置
关键代码:if (php_init_config(TSRMLS_C) == FAILURE) { return FAILURE; }。这里的 php_init_config 函数会检查所有 php.ini 配置,并且找到所有需要加载的模块,添加到 php_extension_lists 结构中。
加载 PHP 内置扩展
调用 zend_register_standard_ini_entries 加载所有 PHP 的内置扩展,比如 array、mysql 等。
加载所有外部扩展
调用 php_ini_register_extensions,在 main/php_ini.c 中,通过 zend_llist_apply 函数遍历 extension_lists,执行回调函数 php_load_php_extension_cb。这个回调函数会调用 ext/standard/dl.c 中的 zend_load_extension 来加载扩展。该函数内部最后会调用:
if ((module_entry = zend_register_module_ex(module_entry TSRMLS_CC)) == NULL) {
DL_UNLOAD(handle);
return FAILURE;
}
这会把扩展信息放到 Hash 表 module_registry 中(定义在 Zend/zend_API.c)。
开启所有扩展
最后执行 zend_startup_modules(TSRMLS_C) 对模块进行排序,并检测是否已注册到 module_registry Hash 表里;然后 zend_startup_extensions() 执行 extension->startup(extension) 来启动扩展。
WOW……都半夜 12 点了,整整分析了三个小时……就到这里吧。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。















