ini_get_all

(PHP 4 >= 4.2.0, PHP 5)

ini_get_all — 获取所有配置选项

说明

array ini_get_all ([ string $extension [, bool $details = true ]] )

获取所有已注册的配置选项

参数

extension: 可选的扩展名称。如果设置了，此函数仅仅返回指定该扩展的选项。
details: 获取详细设置或者仅仅是每个设置的当前值。默认是 TRUE（获取详细信息）。

返回值

返回一个关联数组，指令名称是数组的键。

当 details 为 TRUE（默认），数组会包含 global_value（php.ini 中的设置）、local_value（可能是 ini_set() 或 .htaccess 中的设置）以及 access（访问级别）。

当 details 为 FALSE，这个值会是选项的当前值。

参见手册章节中访问级别含义的信息。

Note:
指令可以有多个访问级别，这也是为什么 access 会显示适当的位掩码。

更新日志

版本	说明
5.3.0	增加参数 `details`。

范例

Example #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
        )

    ...

)

Example #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() - 获取一个配置选项的值
ini_restore() - 恢复配置选项的值
ini_set() - 为一个配置选项设置值
get_loaded_extensions() - 返回所有编译并加载模块名的 array
phpinfo() - 输出关于 PHP 配置的信息

用户评论:

root at mantoru dot de (2008-01-21 13:33:48)

Since a certain PHP version (I think it's 5.2.5) it is no longer possible to override INI entrys set with php_admin_* in httpd.conf. The access level will be set to 4 (PHP_INI_SYSTEM), which is also returned by this function. The constants mentioned below are available in PHP, but without the prefix (e.g. INI_USER, INI_PERDIR).

justd@ntmailme (2002-12-20 08:15:06)

I guess the third entry is the required access level (to change this variable at runtime): Constant Value Meaning PHP_INI_USER 1 Entry can be set in user scripts PHP_INI_PERDIR 2 Entry can be set in php.ini, .htaccess or httpd.conf PHP_INI_SYSTEM 4 Entry can be set in php.ini or httpd.conf PHP_INI_ALL 7 Entry can be set anywhere See also the docs for ini_set() Hugo.