PHP 选项/信息

## 简介
这些函数允许你获得许多关于PHP本身的参数，例如：运行时的配置，被加载的扩展，版本等。 你也将找到设置你的运行中的PHP的选项的函数。可能最好用的 PHP- 函数 phpinfo() 可以在这里找到。

> Improve This Page
[Learn how improve this page](https://github.com/php/doc-base/blob/master/README.md "Learn how improve this page") • [Submit a Pull Request](https://github.com/php/doc-zh/blob/master/reference/info/book.xml "Submit a Pull Request") • [Report a Bug](https://github.com/php/doc-zh/issues/new?body=From%20manual%20page:%20https:%2F%2Fphp.net%2Fintro.info%0A%0A--- "Report a Bug")

## 安装/配置

### 需求
构建此扩展不需要其他扩展。

### 安装
使用这些函数不需要安装，它们是 PHP 核心的一部分。

### 运行时配置
这些函数的行为受 `php.ini` 中的设置影响。

PHP 选项 / Info 配置选项

| 名字        | 默认   | 可修改范围      | 更新日志       |
|-----------|------|------------|---------------------|
| assert.active           | "1"  | INI_ALL    | 自 PHP 8.3.0 起弃用 |
| assert.bail             | "0"  | INI_ALL    | 自 PHP 8.3.0 起弃用 |
| assert.warning          | "1"  | INI_ALL    | 自 PHP 8.3.0 起弃用 |
| assert.callback         | NULL | INI_ALL    | 自 PHP 8.3.0 起弃用 |
| assert.quiet_eval       | "0"  | INI_ALL    | 从 PHP 8.0.0 移除           |
| assert.exception        | "1"  | INI_ALL    | 在 PHP 8.0.0 之前，默认是 "0"，自 PHP 8.3.0 起弃用 |
| enable_dl               | "1"  | INI_SYSTEM | 本过时特性将肯定会在未来被移除。    |
| max_execution_time      | "30" | INI_ALL    | &nbsp;                           |
| max_input_time          | "-1" | INI_PERDIR | &nbsp;                           |
| max_input_nesting_level | "64" | INI_PERDIR | &nbsp;                           |
| max_input_vars          | 1000 | INI_PERDIR | &nbsp;                           |
| zend.enable_gc          | "1"  | INI_ALL    | &nbsp;                           |

有关 INI_* 样式的更多详情与定义，见 [配置可被设定范围](https://www.php.net/manual/zh/configuration.changes.modes.php "配置可被设定范围")。
这是配置指令的简短说明。

`assert.active` `bool`
激活 assert() 断言评测。应该使用 [zend.assertions](https://www.php.net/manual/zh/ini.core.php#ini.zend.assertions "zend.assertions") 来控制 assert() 的行为。

警告
本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。

`assert.bail` `bool`
失败的断言将中止脚本。

> 警告
本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。

`assert.warning` `bool`
为每个失败的断言产生一条 PHP 警告信息。

> 警告
本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。

`assert.callback` `string`
断言失败后要调用的回调函数。

> 警告
本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。

`assert.quiet_eval` `bool`
> 警告
此功能自 PHP 8.0.0 起移除。

在断言表达式执行时 [error_reporting()](http://www.bixiaguangnian.com/manual/phpfunction/2288.html "error_reporting()") 使用当前的设置。如果启用了，在执行时错误将不会被显示（隐式的 error_reporting(0)）。如果禁用了，错误将根据 [error_reporting()](http://www.bixiaguangnian.com/manual/phpfunction/2288.html "error_reporting()") 的设置来显示。

`assert.exception` `bool`
在断言（assert）失败时产生 [AssertionError](https://www.php.net/manual/zh/class.assertionerror.php "AssertionError") 异常。

> 警告
本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。

`enable_dl` `bool`
该指令允许开启或关闭使用 dl() 动态加载 PHP 模块。

关闭动态加载的主要原因是为了安全。通过动态加载，有可能忽略所有 open_basedir 限制。默认允许动态加载。

`max_execution_time` `int`
这设置了脚本被解析器中止之前允许的最大执行时间，单位秒。这有助于防止写得不好的脚本占尽服务器资源。默认设置为 30。从[命令行](https://www.php.net/manual/zh/features.commandline.php "命令行")运行 PHP 时，默认设置为 0。

在非 Windows 系统上，最大执行时间不会影响系统调用和系统操作等。更多细节参见 set_time_limit()。

你的 web 服务器也可以有其他超时设置，也有可能中断 PHP 的执行。Apache 有一个 Timeout 指令，IIS 有一个 CGI 超时功能。他们默认都是 300 秒。更多具体信息参见你的 web 服务器的文档。

`max_input_time` `int`
脚本解析输入数据（类似 POST 和 GET）允许的最大时间，单位是秒。它从接收所有数据到开始执行脚本进行测量的。默认设置为 -1，意味着使用 max_execution_time 的值做为默认值，如果不想限制，请设置为 0。

`max_input_nesting_level` `int`
设置 [输入变量](https://www.php.net/manual/zh/language.variables.external.php "输入变量") 的最大允许嵌套的深度。（例如 [$_GET](https://www.php.net/manual/zh/reserved.variables.get.php "$_GET")、[$_POST](https://www.php.net/manual/zh/reserved.variables.post.php "$_POST")）

`max_input_vars` `int`
接受多少 [输入的变量](https://www.php.net/manual/zh/language.variables.external.php "输入的变量")（限制分别应用于 $_GET、$_POST 和 $_COOKIE 超全局变量）指令的使用减轻了以哈希碰撞来进行拒绝服务攻击的可能性。如有超过指令指定数量的输入变量，将会导致 [E_WARNING](http://www.bixiaguangnian.com/manual/phpfunction/1861.html#h2-u9884u5B9Au4E49u5E38u91CF "E_WARNING") 的产生，更多的输入变量将会从请求中截断。

`zend.enable_gc` `bool`
启用或禁用循环引用记数收集器。

### 资源类型
此扩展没有定义资源类型。

## 预定义常量
下列常量作为 PHP 核心的一部分总是可用的。

**预定义 phpcredits() 常量**

| 常量               | 值  | 说明       |
|------------------|----|--------------|
| CREDITS_GROUP    | 1  | 核心开发者名单     |
| CREDITS_GENERAL  | 2  | 总的贡献：语言设计和理念，PHP 作者 和 SAPI 模块。|
| CREDITS_SAPI     | 4  | PHP 的服务器 API 模块列表，以及它们的作者。|
| CREDITS_MODULES  | 8  | PHP 扩展的列表，以及它们的作者。|
| CREDITS_DOCS     | 16 | 文档组的贡献。|
| CREDITS_FULLPAGE | 32 | 通常与其他标志组合使用。通过其他标志指示了完整独立的 HTML 页面，用于打印包含信息。|
| CREDITS_QA       | 64 | 质量保证团队的贡献。|
| CREDITS_ALL      | -1 | 所有的贡献者，等于使用 CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + CREDITS_QA CREDITS_FULLPAGE。它以合适的标签产生了完整的独立 HTML 页面。这是默认的值。|

**phpinfo() 常量**

| 常量                 | 值  | 说明    |
|--------------------|----|-----------|
| INFO_GENERAL       | 1  | 配置行，php.ini 的位置、构建日期，Web 服务器、操作系统及其他。 |
| INFO_CREDITS       | 2  | PHP 贡献者。参见 phpcredits()。|
| INFO_CONFIGURATION | 4  | 当前 PHP 指令的本地（Local）和主（Master）值。参见 ini_get()。|
| INFO_MODULES       | 8  | 已加载的模块和各自的设置。|
| INFO_ENVIRONMENT   | 16 | 环境变量信息在 $_ENV 中亦有效。|
| INFO_VARIABLES     | 32 | 显示所有 EGPCS （环境变量、GET、POST、Cookie、Server）中的预定义变量。|
| INFO_LICENSE       | 64 | PHP 版权信息。参见 [» license faq](https://www.php.net/license/ "» license faq")。|
| INFO_ALL           | -1 | 显示以上所有。这是默认值。|

**INI 模式常量**

| 常量                                | 说明          |
|-------------------------------------|------------|
| INI_USER (int) | 可以在用户脚本（如使用 ini_set()）或 Windows 注册表中设置条目。可以在 .user.ini 中设置条目 |
| INI_PERDIR (int) | 可以在 php.ini、.htaccess、httpd.conf 或 .user.ini 中设置条目 |
| INI_SYSTEM (int) | 可以在 php.ini 或 httpd.conf 中设置条目 |
| INI_ALL (int) | 条目可以设置在任何地方 |

断言常量，这些值用于设置 assert_options() 中的断言标记。

**assert() 常量**

| 常量                | INI 设置            | 说明    |
|-------------------|-------------------|------------|
| ASSERT_ACTIVE     | assert.active     | 启用 assert()。<br/> <div class="callout callout-danger my-2">警告本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。</div>|
| ASSERT_CALLBACK   | assert.callback   | 失败断言的回调函数。<br/> <div class="callout callout-danger my-2">警告本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。</div>|
| ASSERT_BAIL       | assert.bail       | 断言失败时中止执行。<br/> <div class="callout callout-danger my-2">警告本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。</div>|
| ASSERT_EXCEPTION  | assert.exception  | 为每个失败的断言产生一条 PHP 警告。<br/> <div class="callout callout-danger my-2">警告本特性已自 PHP 8.3.0起废弃。强烈建议不要使用本特性。</div>|
| ASSERT_WARNING    | assert.warning    | 为每个失败的断言产生一条 PHP 警告。<br/> <div class="callout callout-danger my-2">警告本特性已自 PHP 8.3.0 起废弃。强烈建议不要使用本特性。</div>|
| ASSERT_QUIET_EVAL | assert.quiet_eval | 在执行断言表达式时禁用 error_reporting。<br/> <div class="callout callout-danger my-2">警告 此功能自 PHP 8.0.0 起移除。</div> |

以下常量仅在主机操作系统是 Windows的情况下有效，能得到不同版本信息，能够检测利用一些功能。

**Windows 特定常量**

| 常量                         | 描述             |
|------------------------------|-------------------|
| PHP_WINDOWS_VERSION_MAJOR        | windows 主版本，可以是 4（NT4/Me/98/95）、5（XP/2003 R2/2003/2000）或 6（Vista/2008/7/8/8.1）。 |
| PHP_WINDOWS_VERSION_MINOR        | Windows 副版本号，可以是 0 (Vista/2008/2000/NT4/95)、1 (XP)、2 (2003 R2/2003/XP x64)、10（98）或 90（ME）。  |
| PHP_WINDOWS_VERSION_BUILD        | Windows 内部版本号（例如 Windows Vista SP1 是 build 6001） |
| PHP_WINDOWS_VERSION_PLATFORM     | PHP 当前运行的平台， Windows Vista/XP/2000/NT4、Server 2008/2003 的值是 2，Windows ME/98/95 下值是 1。|
| PHP_WINDOWS_VERSION_SP_MAJOR     | 安装的 service pack 主版本号，没有安装是 0。例如 Windows XP service pack 3 上这个值是 3。|
| PHP_WINDOWS_VERSION_SP_MINOR     | 安装的 service pack 副版本号，如果没有安装则是 0。|
| PHP_WINDOWS_VERSION_SUITEMASK    | suitemask 是位掩码，用来判断 Windows 是否安装了各种功能，参阅下表获取可能的位阈值。 |
| PHP_WINDOWS_VERSION_PRODUCTTYPE  | 包含用于确定 PHP_WINDOWS_NT_* 常量的值。该值可能是 PHP_WINDOWS_NT_* 常量之一，表示平台类型的值。|
| PHP_WINDOWS_NT_DOMAIN_CONTROLLER | 这是域控制器       |
| PHP_WINDOWS_NT_SERVER            | 这是一个服务器系统（例如 Server 2008/2003/2000），注意，如果这是一个域控制器，通过 PHP_WINDOWS_NT_DOMAIN_CONTROLLER 报告。|
| PHP_WINDOWS_NT_WORKSTATION       | 这是一个工作站系统（例如 Vista/XP/2000/NT4）   |

此功能列表可以通过 PHP_WINDOWS_VERSION_SUITEMASK 位掩码检测。

**Windows suitemask 位字段**

| Bits       | 描述                                                                                                                       |
|------------|------------------------------|
| 0x00000004 | 安装的是 Microsoft BackOffice 组件。|
| 0x00000400 | 安装的是 Windows Server 2003 网络版。 |
| 0x00004000 | 安装的是 Windows Server 2003 计算集群版。 |
| 0x00000080 | 安装的是 Windows Server 2008 数据中心版、Windows Server 2003 数据中心版或者 Windows 2000 数据中心服务器。 |
| 0x00000002 | 安装的是 Windows Server 2008 企业版，Windows Server 2003 企业版，Windows 2000 高级服务器版或 Windows NT Server 4.0 企业版 。|
| 0x00000040 | 安装的是 Windows XP 嵌入版。    |
| 0x00000200 | 安装的是 Windows Vista 家庭高级版，Windows Vista 家庭普通版或 Windows XP 家庭版。|
| 0x00000100 | 支持远程桌面，但仅支持交互式会话。系统没有在应用服务器模式运行时则会设置此值。|
| 0x00000001 | Microsoft 小型商业服务器曾经安装在系统上，但可能已经升级到 Windows 的另外一个版本。|
| 0x00000020 | Microsoft 小型商业服务器安装时具有有效的限制性客户端许可证。|
| 0x00002000 | 安装的是 Windows 存储服务器 2003 R2 或 Windows 存储服务器 2003。  |
| 0x00000010 | 安装的是终端服务。该值始终设置。如果设置了该值但未设置 0x00000100，则系统运行在应用服务器模式。|
| 0x00008000 | 已安装 Windows Home Server。  |