PHP扩展读取配置有四种方式：一、用PHP_INI_BEGIN/END注册INI项并用YOUR_EXTENSION_G访问；二、手动解析外部INI文件并存入哈希表；三、通过zend_getenv读取环境变量并回退默认值；四、由PHP用户空间传入并校验关联数组。
如果您在开发PHP扩展时需要读取配置文件，PHP提供了多种机制来实现配置参数的加载与解析。以下是具体的操作步骤：
一、使用PHP_INI_BEGIN和PHP_INI_END宏定义INI配置项
该方法通过在扩展的源码中注册INI配置项，使PHP在启动时自动加载并解析php.ini中对应键值。配置项可在运行时通过zend_ini_long_gets等函数获取。
1、在扩展的php_your_extension.h头文件中声明配置变量，例如：extern zend_long your_extension_timeout;
2、在扩展的your_extension.c中，在PHP_INI_BEGIN()与PHP_INI_END()之间注册配置项：
立即学习“PHP免费学习笔记（深入）”；
PHP_INI_BEGIN()<br>STD_PHP_INI_ENTRY("your_extension.timeout", "30", PHP_INI_ALL, OnUpdateLong, timeout, zend_your_extension_globals, your_extension_globals)<br>PHP_INI_END()
3、在MINIT函数中调用REGISTER_INI_ENTRIES();完成注册。
4、在代码任意位置使用YOUR_EXTENSION_G(timeout)访问该配置值，其中YOUR_EXTENSION_G为全局宏封装。
二、手动解析外部INI文件（如extension.conf）
该方法不依赖PHP内置INI机制，而是通过C标准库或Zend API读取指定路径下的独立配置文件，适用于需动态加载、多环境切换或非php.ini路径的场景。
1、在扩展初始化阶段（如MINIT）调用php_stream_open_wrapper打开配置文件路径，例如/etc/php/ext/your_extension.conf。
2、使用php_stream_get_line逐行读取内容，跳过空行与注释（以分号;或井号#开头的行）。
3、对每行执行strchr查找等号=，分离键名与值，并用zend_hash_str_update存入扩展的全局哈希表中。
4、提供ZEND_FUNCTION接口（如your_extension_get_config），供PHP用户空间调用your_extension_get_config("timeout")获取已解析的值。
三、从环境变量读取配置
该方法利用操作系统环境变量传递配置，避免修改任何文件，适合容器化部署或CI/CD流程中注入敏感参数或临时设置。
1、在MINIT或RINIT阶段调用getenv或zend_getenv（推荐后者，兼容ZTS）获取变量值，例如zend_getenv("YOUR_EXT_TIMEOUT", sizeof("YOUR_EXT_TIMEOUT")-1)。
2、对返回值进行类型转换：使用atol转整型，atof转浮点，或直接保留为char *字符串指针。
3、将转换结果赋值给扩展全局变量或缓存于zend_hash_t *结构中，确保线程安全时使用TSRMLS_DC上下文参数。
4、若环境变量未设置，可回退至默认值，例如：YOUR_EXTENSION_G(timeout) = (val != NULL) ? atol(val) : 30。
四、通过PHP用户空间传入配置数组
该方法将配置控制权交由PHP脚本开发者，扩展仅负责接收并验证参数，适用于高度定制化或按请求粒度变更配置的场景。
1、在扩展中定义一个接收关联数组的函数，如ZEND_FUNCTION(your_extension_init)，使用ZEND_PARSE_PARAMETERS_START(1, 1)解析参数。
2、调用zend_parse_parameters获取zval *config，再用zend_hash_get_current_key与zend_hash_get_current_data遍历数组元素。
3、对每个键执行zend_symtable_str_find匹配预设白名单（如"timeout"、"host"、"port"），拒绝未知键。
4、对值做类型校验：整型字段调用zval_get_long，字符串字段调用zval_get_string并释放临时zval，最终写入扩展内存结构。
