PHP 的配置系统是整个语言运行时最核心的基础设施之一。从 php.ini 文件的词法解析，到配置指令向各个模块的注册分发，再到运行时通过 ini_set() 动态修改，这条链路贯穿了 PHP 生命周期的每一个阶段。理解这套机制，不仅能帮助开发者写出更可靠的配置管理代码，还能在排查“为什么这个配置不生效”这类问题时直击根因。
一、配置系统的整体架构
PHP 配置系统由三个层次协同工作：
- 解析层：负责读取
.ini文件，将其解析为键值对形式的配置条目。 - 注册层：各扩展在模块初始化阶段（
MINIT）向内核注册自己支持的配置指令，声明默认值、可修改范围及回调函数。 - 运行时层：通过
ini_set()/ini_get()等 API 在请求生命周期内读取或修改已注册的指令。
这三层并非串行执行，而是存在交叉：解析发生在 MINIT 之前，注册发生在 MINIT 期间，而运行时修改则贯穿 RINIT 到 RSHUTDOWN 的整个过程。
二、php.ini 的解析过程
PHP 启动时，php_init_config() 函数负责定位并加载配置文件。解析器本质上是一个手写的词法分析器，位于 Zend/zend_ini_parser.y 和 Zend/zend_ini_scanner.l 中，由 Bison 和 re2c 生成。
解析器支持的语法元素包括：
- 节（Section）：
[PHP]、[Date]等，仅作为组织手段，不影响指令语义。 - 指令赋值：
memory_limit = 128M，支持常量表达式如E_ALL & ~E_DEPRECATED。 - 常量引用：解析阶段即可展开
PHP_VERSION等预定义常量。 - 变量引用：
${VAR}形式可引用已解析的指令值。 - 环境变量：
${ENV_VAR}在特定 SAPI 下可用。
解析结果存储在一个全局哈希表 configuration_hash 中，键为标准化后的指令名（小写、下划线分隔），值为字符串形式的原始值。注意：此时的值尚未经过类型转换，布尔值、整数、字节单位的解析都推迟到注册阶段。
一个容易被忽视的细节是：.ini 文件的解析顺序决定了配置覆盖关系。PHP 依次扫描 php.ini、conf.d 目录下的 .ini 文件、.htaccess（仅 Apache 模块模式）、以及通过 -d 命令行传入的键值对。后加载的配置会覆盖先加载的同名指令。
三、指令注册机制
每个 PHP 扩展通过 ZEND_INI_ENTRY 系列宏向内核注册配置指令。核心数据结构是 zend_ini_entry：
struct _zend_ini_entry {
zend_string *name;
zend_string *value;
zend_string *orig_value;
void (*on_modify)(zend_ini_entry *entry, ...);
int module_number;
int modifiable;
zend_ini_entry *next;
};
注册时需指定三个关键属性：
- 默认值：当
.ini文件中未出现该指令时使用。 - 可修改范围（
modifiable）：决定该指令在哪些阶段可以被修改。常见取值包括PHP_INI_SYSTEM（仅启动时）、PHP_INI_PERDIR（目录级）、PHP_INI_ALL（任意时刻）。这个标志是运行时ini_set()能否成功的决定性因素。 - 回调函数（
on_modify）：指令值变更时触发，用于执行副作用。例如memory_limit的回调会重新计算内存上限，error_reporting的回调会更新错误处理掩码。
注册过程发生在 MINIT 阶段，由 zend_register_ini_entries() 完成。该函数遍历扩展声明的 zend_ini_entry_def 数组，为每个条目分配 zend_ini_entry 结构，填入默认值，并挂载到全局的 registered_zend_ini_directives 哈希表中。
ZEND_INI_BEGIN()
STD_PHP_INI_ENTRY("memory_limit", "128M", PHP_INI_ALL,
OnUpdateMemoryLimit, memory_limit, zend_executor_globals, executor_globals)
ZEND_INI_END()
上述代码片段展示了 memory_limit 的注册方式：默认值 128M，可修改范围 PHP_INI_ALL，回调 OnUpdateMemoryLimit。
四、运行时动态修改的实现
ini_set() 的底层实现是 zend_alter_ini_entry_ex()。当用户调用 ini_set('memory_limit', '256M') 时，内核执行以下步骤：
- 在
registered_zend_ini_directives中查找名为memory_limit的条目。 - 检查该条目的
modifiable标志是否允许在PHP_INI_USER阶段修改。 - 调用
on_modify回调，传入新值。回调内部通常会将字符串转换为目标类型（如zend_atol解析字节数），并更新对应的全局变量。 - 将新值写入
entry->value，同时保留entry->orig_value以便在请求结束时恢复。
这里有一个关键设计：请求隔离。在 RINIT 阶段，PHP 会为每个请求复制一份配置条目的快照。ini_set() 修改的是当前请求的副本，不会影响其他并发请求。请求结束时，RSHUTDOWN 阶段会将配置恢复到 orig_value。这正是 PHP 在多进程模型下保持配置隔离的基石。
对于 PHP_INI_SYSTEM 级别的指令（如 extension_dir），ini_set() 会直接失败并返回 false，同时触发一条 E_WARNING。开发者常遇到的“配置改了不生效”问题，根源往往就在这里。
五、实践中的关键要点
配置缓存与 opcache：opcache 的配置指令大多为 PHP_INI_SYSTEM，意味着它们只能在启动时设置。尝试在运行时修改 opcache.enable 是无效的。
回调的副作用：某些指令的回调会执行不可逆操作。例如修改 date.timezone 会调用 zend_update_timezone()，影响整个请求的时区上下文。
.user.ini 与 PHP_INI_PERDIR：在 CGI/FastCGI 模式下，.user.ini 文件可以修改 PHP_INI_PERDIR 和 PHP_INI_USER 级别的指令，但无法修改 PHP_INI_SYSTEM 级别的指令。这为共享主机环境提供了一种细粒度的配置覆盖手段。
ini_get_all() 的诊断价值：该函数返回所有已注册指令的当前值、默认值和可修改范围，是排查配置问题的第一手工具。
六、总结
PHP 配置系统的设计体现了“启动时集中解析、模块化注册、请求级隔离”的核心思想。php.ini 解析器将文本配置转化为哈希表，各扩展在 MINIT 阶段声明自己的指令及其元信息，运行时通过 ini_set() 在当前请求的副本上执行受控修改。理解 modifiable 标志的语义、回调函数的触发时机以及请求隔离机制，是掌握 PHP 配置管理的关键。当下次遇到配置不生效的问题时，不妨从这三个维度逐一排查。
未经允许不得转载：任鹏个人博客 » PHP 配置系统内核解析：php.ini 解析、指令注册与运行时动态修改
