PHP 行事准则：PHP 配置文件

参考

项目	描述
搜索引擎	Bing、Google
AI 大模型	文心一言、通义千问、讯飞星火认知大模型、ChatGPT
PHP 官方	PHP Manual

环境

项目	描述
PHP	8.0.0
PHP 编辑器	PhpStorm 2023.1.1（专业版）

PHP 行事准则

PHP 配置文件

在 PHP 中，配置文件是用来控制 PHP 运行时行为 的重要组成部分。PHP 配置文件包含一系列的配置指令，用于 定义 PHP 的工作方式和行为。

php.ini-production 与 php.ini-development

php.ini-production 和 php.ini-developer 是 PHP5.3 及后续版本 提供的两个不同的 PHP 配置文件。

生产配置文件

php.ini-production 配置文件的目的是 提供一个适用于生产服务器的配置，该配置文件更加偏向于 安全性 和 性能 的最佳实践。
通常，生产环境需要更严格的安全性和性能优化，因此这个配置文件中的选项可能被调整为更安全和更高性能的设置。例如，错误报告级别可能设置为较低以减少对终端用户的敏感信息泄漏，还可能启用了一些缓存机制以提高性能。

开发配置文件

php.ini-developer 配置文件的目的是为了 方便开发人员，以在开发和调试过程中 提供更多的信息 和 灵活性。
开发环境通常需要更多的错误报告和调试信息，以便开发人员更容易发现和修复问题。因此，这个配置文件中的选项可能会设置为内容输出更具详细性的值。例如，开启错误报告和调试日志，以帮助开发人员定位和解决问题。

配置文件的应用

在实际使用中，你可以根据需要选择使用哪个配置文件。在决定选择使用那个配置文件时，将该配置文件重命名为 php.ini 即可。

版本差异

在 PHP5.3 以后，PHP 官方提供的 PHP 文件中将包含 php.ini-development 和 php.ini-production，分别是 PHP 开发环境的配置文件以及 PHP 生产环境的配置文件。
在 PHP5.3 以前，PHP 官方也提供 PHP 配置文件，即 php.ini-dist 与 php.ini-recommended，分别与此后的 php.ini-development 及 php.ini-production 相对应。

修改配置的生效

在修改 PHP 配置文件后，被修改配置项的生效条件视具体情况而定。对此，请参考如下条目：

1. 重启 WEB 服务器
   如果您使用 Apache 或 Nginx 服务来运行 PHP，那么在您修改配置文件后，您 需要重启相应的服务。这是因为 PHP 的配置 在服务启动时加载，并保持在内存中，直到服务停止。
   
2. CLI
   如果您在命令行界面 (Command Line Interface，CLI) 中使用 PHP，那么 任何新的 CLI 进程都会立即使用最新的配置。正在运行的 PHP 进程则不受影响，如需使用最新配置，请将该进程关闭并开启新 PHP 进程。

PHP 运行时配置

ini_set()

除了 php.ini 文件之外，PHP 还允许 在脚本运行过程中通过 ini_set() 函数来动态修改某些配置选项的值，这些更改只在 当前脚本运行时生效，并不会影响全局配置。这为开发者提供了在单个脚本或应用的执行过程中调整配置的灵活性。

ini_set()

function ini_set(
     string $option,     
     $value 
): false|string

其中：

$option 用于指定需要修改的配置项，而 $value 则是配置项被修改后的结果值。ini_set() 函数在修改配置项成功时返回 被修改配置项的原有值，否则，返回 false。对此，请参考如下示例：

# ini_get() 函数可用于获取特定配置项的配置值。
var_dump(ini_get('display_errors'));

# 配置项的值若为 Off 则无论何种大小写形式，
# 该配置项都将被关闭。On 同理可得
var_dump(ini_set('display_errors', 'Off'));

var_dump(ini_get('display_errors'));

# 尝试通过 ini_get() 修改一个不存在的配置项
# 则该函数将因为修改配置项失败而返回 false。
var_dump(ini_set('Fantasy', 1));

执行效果

string(1) "1"
string(1) "1"
string(3) "Off"
bool(false)

布尔配置项

大多数配置项的取值只有 On 或 Off，分别表示开启该配置或关闭该配置，这些配置项被称为布尔配置项。$value 的取值的数据类型不仅仅局限于某一种，因此当某一配置项为布尔配置项时，该配置项（除 On、Off 外）作为字符串转化为布尔值的结果将决定这些配置是否被开启（在配置文件 php.ini 中亦是如此）。

限制

在 PHP 中，不同配置项所能够采取的配置方法可能是不同的，并不是所有的选项都可以在运行时通过 ini_set() 函数来修改。ini_set() 函数允许你在脚本运行时动态地设置配置选项，但有些选项可能由于 安全或系统级别的限制 而不能通过 ini_set() 来修改。对此，请参考如下示例：

# allow_url_include 配置项用于配置是否允许
# 通过 URL 包含并执行远程文件。
var_dump(ini_get('allow_url_include'));

# 由于 allow_url_include 不允许通过 ini_set() 
# 的方式进行设置，故 ini_set() 将返回 false
var_dump(ini_set('allow_url_include', 'On'));

执行效果

string(0) ""
bool(false)

如果您需要查看某个配置项所 允许的配置方式，请访问由 PHP 官方提供的 ini.list.php 页面。

phpinfo()

phpinfo 页面

phpinfo() 是 PHP 提供的一个非常有用的 内置函数，该函数用于显示有关 PHP 的配置信息。当你调用这个函数时，它将产生一个 详尽的 HTML 页面，列出 所有与 PHP 的配置和环境相关的信息。

Core

phpinfo() 是 PHP 提供的一个函数，用于输出关于 PHP 的配置信息。当你调用这个函数时，该函数将生成一个 详细的 HTML 页面，其中展示了诸如 PHP 版本、编译参数、模块信息 和 环境变量 等信息。phpinfo 页面中存在多个部分，其中 Core 部分是有关 PHP 核心设置的相关信息。具体请参考如下界面：

在 Core 部分，你会看到一系列的指令和它们的值。这些指令和值涉及到 PHP 的基本操作和行为。其中，Local Value 与 Master Value 分别表示 运行时配置（当前 PHP 运行环境中实际生效的值） 与 PHP 配置文件 php.ini 中存储的 默认配置。