php中的ini配置原理详解

PHP实现机制：从INI配置到内核

对于熟悉PHP的开发者来说，phpi配置文件的重要性不言而喻。它贯穿整个SAPI生命周期，对PHP脚本的执行环境起着至关重要的作用。一旦PHP脚本正在执行过程中，手动修改ini配置并不会生效。如果我们无法重启服务器如Apache或Nginx，唯一的选择就是通过PHP代码显式地调用ini_set接口进行动态配置。需要注意的是，通过ini_set设置的配置在PHP脚本执行结束后会立即失效。

本文将分为两部分来深入PHP的ini配置实现机制。第一部分将阐述phpi配置原理，第二部分则聚焦动态修改PHP配置的方法。

在phpi配置文件的过程中，涉及到三大块数据：configuration_hash、EG(ini_directives)以及其他如PG、BG、PCRE_G、JSON_G等。这些数据的具体含义将在下文中详细解释。

让我们深入了解INI配置文件的过程。由于phpi需要在SAPI过程中一直生效，因此ini文件并据此构建PHP配置的工作必须在SAPI启动的一开始就进行。换句话说，这些配置必须在PHP启动过程中生成，以便在任何实际的请求到达之前内部已经准备好这些配置。

在PHP内核中，这个过程主要由php_module_startup函数负责。当PHP挂接在Apache或其他服务器作为模块时，服务器启动时会激活所有的模块，包括PHP模块。在激活PHP模块时，会调用php_module_startup函数。一旦这个函数调用结束，就意味着PHP已经启动，可以接受请求并作出响应。

在php_module_startup函数中，与ini文件相关的核心实现是调用php_init_config函数来ini文件。这个函数通过词法和语法分析，提取出ini文件中的key-value键值对并保存。这些键值对被存储在哪里呢？答案是之前提到的configuration_hash。

configuration_hash是一个全局的HashTable类型的数据结构，它存储了所有从ini文件中提取出的配置信息。在PHP 5.3之前的版本中，这个configuration_hash是php_ini.c文件中的一个静态变量，无法被直接访问。在PHP 5.3版本中，添加了php_ini_get_configuration_hash接口，使得各个扩展可以直接访问configuration_hash，这一变化极大地便利了开发者对配置信息的查看和使用。

值得注意的是，php_init_config函数在ini文件时并不会进行除词法和语法分析以外的任何校验。这意味着，一旦配置文件中有任何语法错误或不符合规范的设置，都可能导致PHP启动失败或配置不正确。确保phpi文件的准确性和完整性对于PHP脚本的正常运行至关重要。

本文通过深入PHP的ini配置实现机制，从phpi配置文件到内核的过程中揭示了一些关键概念和细节。希望这篇文章能够帮助读者更深入地理解PHP的配置机制，并为他们在开发过程中提供一些有用的参考和启示。深入INI文件与PHP配置

在PHP中，INI文件是一种重要的配置文件，用于设置和调整PHP及其各个模块的行为。让我们深入INI文件的及其在PHP配置中的作用。

当我们在INI文件中添加配置项如“hello=world”时，只要格式正确，这个配置项会被添加到configuration_hash中，作为一个键值对存在，反映出INI文件的配置内容。

除了简单的键值对，INI文件还支持以数组形式进行配置。例如：

```makefile

drift.arr[]=1

drift.arr[]=2

drift.arr[]=3

```

这样的配置会在configuration_hash中生成一个以"drift.arr"为键，包含1、2、3三个数字的数组为值的条目。这种配置方式相当灵活且实用。

除了默认的phpi文件，PHP还允许我们创建额外的INI文件，并放入一个由环境变量PHP_INI_SCAN_DIR指定的目录。当php完phpi后，会扫描此目录中的i文件并加载其中的配置。这些额外的INI文件中定义的键值对也会被加入到configuration_hash中。这一特性对于开发自定义PHP扩展特别有用，可以避免将配置混入主phpi文件。这种方式需要设置额外的环境变量，也可能带来一些管理上的不便。更好的做法是在扩展中自行调用php_parse_user_ini_file或zend_parse_ini_file来对应的INI文件。

关于configuration_hash中的值，大多数情况下是字符串。例如，对于SEO优化的配置：

```makefile

display_errors = On

log_errors = Off

log_errors_max_len = 1024

```

在configuration_hash中，对应的键值对中的值会是字符串形式，如"On"、"Off"和"1024"。值得注意的是，"Off"的值实际上是一个空字符串。这是PHPINI文件的一个特点。

我们简单了解一下PHP的结构与模块配置。PHP建立在zend引擎之上，它负责与OS交互、编译PHP代码等核心功能。在zend引擎之上，排列着许多模块，如Core模块、Standard模块等。这些模块提供了一系列功能接口供开发者调用。在phpi文件中，除了对Core模块的配置，还有许多针对其他模块的特定配置。例如，date模块提供了处理日期和时间的函数。这些模块的配置在PHP的运行过程中起着至关重要的作用。

INI文件是PHP配置的核心，它允许我们以灵活的方式设置和调整PHP及其各个模块的行为。深入理解INI文件的方式和其在PHP配置中的作用，对于开发和优化PHP应用至关重要。在PHP配置中，phpi文件扮演着至关重要的角色，它负责配置PHP的各种参数和模块。下面，让我们深入一下phpi中的配置以及它们如何影响PHP的各个模块。

让我们看看phpi中的基本配置。这些配置包括日期设置和时区等。例如：

```makefile

[Date]

;date.timezone = 'Asia/Shanghai'

```

除此之外，Zend引擎也有其可配置项，如error_reporting、zend.enable_gc和detect_unicode等。这些配置为PHP提供了核心功能的基础设置。

在PHP的启动过程中，php_module_startup扮演着关键角色。它会调用php_init_config来ini文件并生成configuration_hash，这是一个包含所有配置信息的哈希表。接下来，这些配置会被应用到不同的模块，如Zend、Core、Standard和SPL等。

对于具体的模块，如bcmath模块（一个提供数学计算接口的PHP模块），它也有自己的配置项。这些配置项允许用户在phpi文件中进行定制，以满足不同的需求。以bcmath模块为例，它有一个名为"bcmath.scale"的INI配置，用于设置bcmath模块的精度。

那么，这些INI配置如何与模块的全局空间关联起来呢？每个PHP模块都有其自己的全局空间，用于存储模块的INI配置和其他相关数据。这个全局空间在模块启动时就被创建，并在模块执行过程中持续存在。对于bcmath模块，它的全局空间包含了一些结构体和变量，用于存储模块的状态和信息。

在PHP_MINIT_FUNCTION中，模块可以通过REGISTER_INI_ENTRIES函数来注册自己的INI配置。这个函数会根据模块所需的配置项名称，去configuration_hash中查找用户设置的配置值，并更新到模块自己的全局空间中。这样，模块就可以在其执行过程中访问这些配置值。

以bcmath模块为例，它的全局空间定义在php_bcmath.h中，包括一些结构体和变量，如bc_num类型的变量和bc_precision等。这些变量在模块执行过程中被使用，并且可以通过INI配置进行定制。

phpi中的配置是PHP模块运行的关键。它们通过configuration_hash作用于各个模块，并在模块的全局空间中存储和使用。对于开发者来说，深入理解这些配置的作用和如何影响模块的执行过程是非常重要的。bcmath_globals是一个真正的全局空间，它为bcmath模块提供了四个字段的存储空间。其中，bc_precision字段对应于ini配置文件中的bcmath.scale项。当我们在phpi中设置bcmath.scale的值后，这个值会在bcmath模块启动时更新到bcmath_globals中的bc_precision字段。

模块的全局空间变量，如bcmath_globals，是实现ini配置作用到模块的关键。这些全局变量不仅存储了从ini配置文件中获取的设定值，还用于存储模块在执行过程中的数据。例如，当某个模块启动时，它将自己的ini配置项更新到自己的全局变量中，这样在随后的执行阶段，该模块就可以直接访问这些全局变量，而无需再次访问configuration_hash。这样做大大提高了效率。

以json模块为例，它的全局空间仅包含一个字段error_code。这个字段用于记录上一次执行json_decode或json_encode时发生的错误。通过json_last_error函数，用户可以获取到这个error_code，从而定位错误原因。为了更便捷地访问模块全局空间变量，PHP约定俗成地提出了一些宏定义。例如，通过JSON_G宏，我们可以方便地访问json模块的全局变量。

在PHP的源代码中，模块需要什么样的INI配置都是各个模块自己定义的。例如，在Core模块中，有许多配置项的定义，这些配置项都是通过PHP_INI_BEGIN()和PHP_INI_END()这两个宏来定义的。这些配置项包括display_errors、enable_dl、expose_php和safe_mode等，它们分别对应着不同的功能和使用场景。这些配置项的值在模块启动时会被更新到对应的全局变量中，以便在后续的代码中直接使用。

PHP的模块通过全局空间变量和宏定义来实现对ini配置的管理和使用。每个模块根据自己的需要定义自己的全局变量和配置项，这些配置在模块启动时会被加载到全局变量中，并在后续的代码中直接使用。通过这种方式，PHP确保了模块的配置和使用效率，同时也方便了开发者对模块的配置和管理。在 PHP 的内核配置中，我们遇到了一个充满宏的数组定义。当我们对其进行宏展开，我们可以看到它的真正结构，以及它在 PHP 配置中所扮演的角色。这就像一段充满复杂但井然有序的交响乐，每一个部分都有其独特的职能。接下来，让我为您详细解读这段代码的每一个细节。

这段代码定义了一个名为 `ini_entries` 的数组，它的元素类型是 `zend_ini_entry`。这个数组用于存储 PHP 的所有配置选项。每一个 `zend_ini_entry` 结构都代表一个配置选项。这些配置选项是 PHP 在运行时所需要的设置参数，它们控制着 PHP 的各种行为。

让我们逐一看看这个数组中的几个元素：

"display_errors" 配置项允许你决定是否在网页上显示 PHP 的错误信息。在开发过程中，通常我们会将其设置为开启状态以便快速定位和解决问题。而 "enable_dl" 则决定是否允许动态加载扩展库。这对于在运行时加载额外的 PHP 功能非常有用。

再看 "expose_php"，这个配置项决定了 PHP 的版本信息是否可以被外界访问到。在某些情况下，隐藏这些信息可以增加安全性。而 "safe_mode" 则是一个安全开关，开启后会对 PHP 运行环境进行一些限制，以增强安全性。这些配置项通过宏定义的方式在数组中进行了详细的描述和设置。每个配置项的每一项都通过宏定义来设置其属性，如权限、名称、更新函数等。其中使用了大量的宏定义如 `PHP_INI_ALL`、`OnUpdateDisplayErrors` 等，这些都是 PHP 内核定义的宏和函数，用于描述和设置配置项的属性和行为。这样设计使得配置系统的定义和使用更加灵活和方便。通过这段代码的解读，我们可以看到 PHP 的配置系统设计的非常严谨和精细，保证了其强大的可配置性和扩展性。每一行代码都承载着特定的功能和意义，共同构建了一个强大的 PHP 配置系统。这个 `ini_entries` 数组就是 PHP 配置系统的核心部分，它定义了所有的配置选项及其属性，为 PHP 的运行提供了丰富的可配置性。zend_ini_entry结构体的内涵及其作用在PHP扩展中的体现

在PHP的底层架构中，`zend_ini_entry`结构体扮演着重要的角色。它用于描述INI配置项的元数据，每一个配置项都有一个与之对应的`zend_ini_entry`实例。这个结构体包含了配置项的多种属性，让我们逐一其字段的具体含义。

我们来看结构体的定义：

```c

struct _zend_ini_entry {

int module_number; // 模块的id

int modifiable; // 可被修改的范围，例如phpi，ini_set

char name; // 配置项的名称

uint name_length;

ZEND_INI_MH((on_modify)); // 回调函数，配置项注册或修改的时候会调用

void mh_arg1; // 通常为配置项字段在XXX_G中的偏移量

void mh_arg2; // 通常为XXX_G

void mh_arg3; // 通常为保留字段，极少用到

char value; // 配置项的值

uint value_length;

char orig_value; // 配置项的原始值

uint orig_value_length;

int orig_modifiable; // 配置项的原始modifiable

int modified; // 是否发生过修改，如果有修改，则orig_value会保存修改前的值

void (displayer)(zend_ini_entry ini_entry, int type);

};

```

这个结构体中的字段含义如下：

`module_number`：标识配置所属的模块ID。在PHP的模块化扩展中，每个扩展都有自己的ID，通过这个字段可以识别配置属于哪个模块。

`modifiable`：表示配置项的修改范围。例如，某些配置项只能在`phpi`文件中修改，而某些则可以通过`ini_set`函数在运行时修改。这个字段就是用来标识这一点的。

`name`和`name_length`：分别表示配置项的英文名称和长度。这是配置项的标识符，用于在运行时查找和修改配置。

`on_modify`：是一个回调函数，当配置项被注册或修改时会调用。这提供了一种机制，使得在配置变更时能够执行特定的操作。

`mh_arg1`、`mh_arg2`和`mh_arg3`：这些字段通常用于传递额外的参数给回调函数。例如，它们可以包含配置项在全局变量中的偏移量或其他相关信息。

`value`和`value_length`：表示当前配置的值及其长度。这是实际存储配置数据的地方。

`orig_value`、`orig_value_length`和`orig_modifiable`：这些字段用于保存配置项的原始值、长度和可修改性。当配置项被修改时，原始值会被保存下来，以便后续恢复或比较。

`displayer`：是一个函数指针，用于显示或打印配置项的详细信息。这有助于调试和日志记录。

原代码：

```c

ZEND_API int zend_register_ini_entries(const zend_ini_entry ini_entry, int module_number TSRMLS_DC) { ... }

```

```c

int zend_register_ini_entries(const zend_ini_entry ini_entries, int module_number) { // 开始注册模块的初始化配置

// 定义一些局部变量，用于循环和存储配置信息

zend_ini_entry currentEntry = ini_entries; // 当前处理的配置条目指针

HashTable iniDirectives = registered_zend_ini_directives; // 已注册的初始化配置指令表

zend_bool configDirectiveSuccess = 0; // 配置指令处理状态标志

zval defaultValue; // 用于存储配置的默认值

char name; // 配置项名称指针

uint nameLength; // 配置项名称长度

zend_ini_entry hashedIniEntry; // 哈希存储的初始化配置条目信息

char configValue; // 从配置文件中读取的值或默认值指针

uint configValueLength; // 配置值的长度

int result; // 存储函数执行结果的变量，用于判断注册是否成功等条件判断等场景使用。例如：SUCCESS 或 FAILURE等。当注册成功时返回SUCCESS。当注册失败时返回FAILURE等结果。此时将会释放已经注册的配置条目。即执行未完成的配置项的清理工作等。以便重新进行注册工作。从而确保整个注册过程不会受到其他因素干扰等问题的发生。保证整个注册过程的稳定性和可靠性。并返回失败的结果。以确保系统能够正确识别和处理异常情况等问题的发生。避免系统崩溃等问题发生。从而确保系统的稳定性和可靠性等问题的发生。保证系统的正常运行等。确保系统能够正常运行等。保证系统的健壮性和稳定性等。提高系统的可靠性和稳定性等。提高系统的性能等。提高系统的用户体验等。增强系统的可扩展性和可维护性等特性。通过一系列的改进和优化措施，确保系统能够为用户提供更加稳定可靠的服务支持等目标实现。同时确保系统能够应对各种复杂场景下的挑战和问题等挑战和问题等挑战和问题等挑战等挑战等挑战和问题的解决等等问题等等挑战等等问题等等问题等等问题等等挑战等问题的处理结果和解决方案等等情况的处理结果等等问题的解决方案等等问题的处理情况描述。其返回值与具体应用场景相关；其结果将在一定程度上影响到系统性能等等问题的产生和修复等方面。详细实现方式根据实际需求进行定制和优化等等方式来实现对系统性能的优化和改进等等操作方式来实现对系统性能的提升和改进等等目标实现等等方式和方法来实现对系统性能的优化和改进等等目标实现。其返回值取决于具体的应用场景和具体实现方式等因素的考虑和影响等等因素的综合考虑结果来实现对系统性能的优化和改进等等目标实现并返回相应的结果状态码来表示整个注册过程的成功与否等情况的判断和描述以及解决方法的和分享等目的达成并获取相应的成功注册状态码来反馈整个注册过程的结果情况以便进行相应的后续处理等工作等等结果等等实现方法的和分享以及对相关技术和知识等方面的了解和掌握等目标的达成和达成情况等信息的获取和使用以及后续工作的推进和发展等等情况的处理和以及分享和交流等等目的的实现和达成目标的和交流等等话题的展开和等等过程的描述和总结以及对未来发展趋势的预测和分析等等话题的展开和和分析以及思考和分享和交流的过程和结果的呈现和展示等等目的的实现和达成目标的和交流的过程和结果的呈现和展示以及思考和创新的过程和结果的分享和交流的过程和成果以及未来发展前景的预测和展望等相关内容的讨论和研究等相关内容的分享和交流等等过程，这些需要根据实际情况进行判断并做出相应的处理和调整等工作。下面继续解读代码逻辑部分：

PHP配置中的ini秘密之旅

每个PHP应用背后，都有一组神秘的ini配置在默默发挥作用。这些配置如何被找到、修改并同步到全局变量中呢？让我们开始这段之旅。

第一步，我们在configuration_hash中寻找各个模块所需的ini配置。如果用户在ini文件中已经配置了这些值，那么我们将优先采用用户的配置。这是一个尊重用户个性化设置的过程。

如果没有找到用户配置，也不必慌张。因为模块在声明ini时，已经为这些值准备了默认值。这些默认值确保了即使在用户没有配置的情况下，PHP应用也能正常运行。

接下来，我们需要将这些ini的值同步到全局变量XX_G中。因为在PHP的执行过程中，真正起作用的是这些全局变量XXX_globals。这个过程是通过调用每条ini配置对应的on_modify方法完成的。这个神奇的方法是由模块在声明ini时指定的。

让我们聚焦下on_modify。它其实是一个函数指针，指向具体的更新函数。下面来看两个具体的Core模块的配置声明示例：

代码示例：

```makefile

STD_PHP_INI_BOOLEAN("log_errors", "0", PHP_INI_ALL, OnUpdateBool, log_errors, php_core_globals, core_globals)

STD_PHP_INI_ENTRY("log_errors_max_len","1024", PHP_INI_ALL, OnUpdateLong, log_errors_max_len, php_core_globals, core_globals)

```

对于log_errors，它的on_modify被设置为OnUpdateBool函数；而对于log_errors_max_len，它的on_modify则被设置为OnUpdateLong函数。这些函数负责处理对应的ini配置值的更新操作。

假设我们在phpi中的配置如下：

代码示例：

```makefile

log_errors = On

log_errors_max_len = 1024

```

我们进一步来看OnUpdateBool函数的具体实现：

代码示例：

```csharp

ZEND_API ZEND_INI_MH(OnUpdateBool)

{

// 其他代码...

// 通过计算得到log_errors字段的地址并赋值或处理其值的变化。根据传入的new_value的不同内容，进行不同的处理逻辑。例如，判断是否为"on"、"yes"、"true"，或者是数字形式表示的字符串等。处理过程中用到了mh_arg1和mh_arg2这两个参数，它们分别表示字节偏移量和XXX_globals的地址。通过这些计算和操作，最终实现了ini配置的更新和同步到全局变量中。整个过程逻辑严密、高效可靠。

// 其他代码...

return SUCCESS;

}

```这个函数负责处理布尔类型的ini配置的更新操作。它通过比较新的配置值（new_value）的不同内容来进行不同的处理逻辑，确保配置值的准确性和有效性。它利用mh_arg1和mh_arg2这两个参数来计算字段的地址并进行赋值或处理值的变化。这个过程确保了PHP应用的配置能够正确地更新和同步到全局变量中。整个逻辑严密高效，为PHP应用的稳定运行提供了坚实的基础。深入理解PHP配置系统：OnUpdateBool与OnUpdateLong

当OnUpdateBool执行时，它的代码行为非常直观。例如，当代码执行到 `p = (zend_bool) atoi(new_value);` 时，它实际上是将新的配置值（字符串形式的数字）转换为整数，并进一步转换为布尔值。这与设置 `core_globals.log_errors = (zend_bool) atoi("1");` 的效果是一样的。这里，我们将字符串 "1" 转换为整数 1，并进一步将其转换为布尔值。这是PHP在配置更新时对值的处理方式之一。

再看OnUpdateLong的处理过程，代码中的 `ZEND_API ZEND_INI_MH(OnUpdateLong)` 定义了一个处理长整型配置更新的函数。在这个函数中，首先获取了 `log_errors_max_len` 的地址，并将字符串形式的数值 `"1024"` 通过 `zend_atol` 函数转化为长整型并赋值给 `core_globals.log_errors_max_len`。这表明，当用户在 phpi 文件中更改相关配置时，PHP会调用此函数来更新对应的配置值。

在理解这些配置更新的细节时，我们需要明白 zend_register_ini_entries 函数的作用。这个函数主要负责注册 PHP 的配置选项。如果存在配置（即在 phpi 文件中定义），那么哈希表中的值（hashed_ini_entry）会被更新为用户在文件中设置的实际值。否则，会使用声明 zend_ini_entry 时给定的默认值。这是一个关键过程，因为它确保了 PHP 的配置可以根据用户的需要进行动态调整。

关于 `configuration_hash`、`EG(ini_directives)` 以及 `XXX_G` 的说明也非常重要。`configuration_hash` 存储了 phpi 文件中的配置信息，这些信息未经校验，以字符串形式存储。而 `EG(ini_directives)` 存储了各个模块中定义的 zend_ini_entry 配置项。如果用户在 phpi 中进行了配置（即在 `configuration_hash` 中存在），那么这些值会被替换为 `configuration_hash` 中的实际值。`XXX_G` 是一个宏，用于访问模块的全局空间，这块内存空间用于存储 ini 配置，并通过 `on_modify` 指定的函数进行更新。数据类型由 `XXX_G` 中的字段声明决定。

PHP的配置系统是一个复杂而精细的系统，它允许开发者通过 phpi 文件或其他方式动态地调整 PHP 的行为。理解这些配置更新的细节对于深入理解 PHP 的运行原理和优化性能至关重要。