# phpinfo

(PHP 4, PHP 5, PHP 7)

phpinfo — 输出关于 PHP 配置的信息

### 说明

phpinfo ([ int `$what` = INFO_ALL ] ) : bool

输出 PHP 当前状态的大量信息，包含了 PHP 编译选项、启用的扩展、PHP 版本、服务器信息和环境变量（如果编译为一个模块的话）、PHP环境变量、操作系统版本信息、path 变量、配置选项的本地值和主值、HTTP 头和PHP授权信息(License)。

因为每个系统安装得有所不同，phpinfo() 常用于在系统上检查 配置设置和 预定义变量。

phpinfo() 同时是个很有价值的、包含所有 EGPCS(Environment, GET, POST, Cookie, Server) 数据的调试工具。

### 参数

`what`

  可以用以下的一个或多个 constants 用位运算传递给可选的 `what` 参数来定制输出的信息。 该参数可以把常量相加或者用 or 操作符按位运算。

  phpinfo() 选项
  Name (constant) | Value | Description
  --- | --- | ---
  INFO_GENERAL | 1 | 配置的命令行、 php.ini 的文件位置、建立的时间、Web 服务器、系统及更多其他信息。
  INFO_CREDITS | 2 | PHP 贡献者名单。参加 phpcredits()。
  INFO_CONFIGURATION | 4 | 当前PHP指令的本地值和主值。参见 ini_get()。
  INFO_MODULES | 8 | 已加载的模块和模块相应的设置。参见 get_loaded_extensions()。
  INFO_ENVIRONMENT | 16 | 环境变量信息也可以用 $_ENV 获取。
  INFO_VARIABLES | 32 | 显示所有来自 EGPCS (Environment, GET, POST, Cookie, Server) 的 预定义变量。
  INFO_LICENSE | 64 | PHP许可证信息。参见 » license FAQ。
  INFO_ALL | -1 | 显示以上所有信息。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

5.5.0 | Logo GUIDs were replaced with data URIs, and so turning off expose_php now has no effect on the result of phpinfo(). Credits are also now embedded within the output itself instead of linked.
--- | ---
版本 | 说明
5.2.2 | 增加了“已加载的配置文件”信息，之前只存在“配置文件路径(php.ini)"。

### 范例

Example #1 phpinfo() 范例

    <?php

    // 显示所有信息，默认显示 INFO_ALL
    phpinfo();

    // Show just the module information. 仅仅显示PHP模块信息，
    // phpinfo(8) 返回同样的结果。
    phpinfo(INFO_MODULES);

    ?>

### 注释

> Note:

> 在 PHP 5.5 之前版本，当 expose_php 设置为 off 可以禁用一部分信息。 这包括了 PHP 和 Zend 的 logo，以及贡献者名单。

> Note:

> 在命令行（CLI）模式下 phpinfo() 仅会输出纯文本，而不是HTML。

### 参见

- phpversion() - 获取当前的PHP版本
- phpcredits() - 打印 PHP 贡献者名单
- php_logo_guid() - 获取 logo 的 guid
- ini_get() - 获取一个配置选项的值
- ini_set() - 为一个配置选项设置值
- get_loaded_extensions() - 返回所有编译并加载模块名的 array
- Predefined Variables