PHP8 ini_get_all — 获取所有配置选项
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
ini_get_all — 获取所有配置选项
说明
ini_get_all(?string $extension
= null
, bool $details
= true
): array|false
获取所有已注册的配置选项
参数
extension
可选的扩展名称。如果不是
null
或字符串core
,此函数仅仅返回指定扩展的选项。details
获取详细设置或者仅仅是每个设置的当前值。 默认是
true
(获取详细信息)。
返回值
返回一个关联数组,指令名称是数组的键。 如果 extension 不存在,返回 false 并产生 E_WARNING 级错误。
当 details 为 true(默认),数组会包含 global_value(php.ini 中的设置)、local_value(可能是 ini_set() 或 .htaccess 中的设置) 以及 access(访问级别)。
当 details 为 false,这个值会是选项的当前值。
参见手册章节中访问级别含义的信息。
注意:指令可以有多个访问级别,这也是为什么 access 会显示适当的位掩码。
示例
示例 #1 ini_get_all() 例子
<?php
print_r(ini_get_all("pcre"));
print_r(ini_get_all());
?>
以上示例的输出类似于:
Array
(
[pcre.backtrack_limit] => Array
(
[global_value] => 100000
[local_value] => 100000
[access] => 7
)
[pcre.recursion_limit] => Array
(
[global_value] => 100000
[local_value] => 100000
[access] => 7
)
)
Array
(
[allow_call_time_pass_reference] => Array
(
[global_value] => 0
[local_value] => 0
[access] => 6
)
[allow_url_fopen] => Array
(
[global_value] => 1
[local_value] => 1
[access] => 4
)
...
)
示例 #2 禁用 details
<?php
print_r(ini_get_all("pcre", false)); // Added in PHP 5.3.0
print_r(ini_get_all(null, false)); // Added in PHP 5.3.0
?>
以上示例的输出类似于:
Array
(
[pcre.backtrack_limit] => 100000
[pcre.recursion_limit] => 100000
)
Array
(
[allow_call_time_pass_reference] => 0
[allow_url_fopen] => 1
...
)
注释
注意:ini_get_all() 忽略 "array" 的 ini 选项,例如 pdo.dsn.*。
参见
- 怎样修改配置设定
- ini_get() - 获取一个配置选项的值
- ini_restore() - 恢复配置选项的值
- ini_set() - 为一个配置选项设置值
- get_loaded_extensions() - 返回所有编译并加载模块名的 array
- phpinfo() - 输出关于 PHP 配置的信息
- ReflectionExtension::getINIEntries() - 获取 ini 配置