PHP 8.0.12 Released!
    Submit a Pull Request Report a Bug

    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)); // PHP 5.3.0 で追加されました
    print_r(ini_get_all(null, false)); // 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() は、"配列" 形式の ini オプション (pdo.dsn.* など) を無視します。

    参考

    add a note add a note

    User Contributed Notes 5 notes

    up
    3
    Julien MOREAU aka PixEye
    2 years ago
    If you want to load and parse your own ini file, have a look at parse_ini_file() function. Example:

    <?php
    // ...
    $my_data = parse_ini_file($my_file, true);
    up
    10
    justd@ntmailme
    18 years ago
    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.
    up
    2
    pmdumuid at gmail dot com
    5 years ago
    echo recreate_php_ini();

    /**
      * Sample function to re-create a php ini config file.
      *
      * @return string
      */
    function recreate_php_ini() {
        $a = ini_get_all();

        $data = [];
        foreach (array_keys($a) as $k) {
            $ss = split("\.", $k);
            if (count($ss) == 1) {
                $sec = "PHP";
                $v = $k;
            } else {
                $sec = $ss[0];
                $v = $ss[1];
            }
            $data[$sec][$v] = $a[$k]['global_value'];
        }
        ksort($data);
        $out = "";
        foreach ($data as $sec => $data) {
            $out .= "[$sec]\n";
            ksort($data);
            foreach ($data as $k => $v) {
                if (is_numeric($v)) {
                    $out .= sprintf("%-40s = %s\n", $k, $v);
                } else {
                    $out .= sprintf("%-40s = \"%s\"\n", $k, $v);
                }
            }
            $out .= "\n";
        }
        return $out;
    }
    up
    -3
    peter at peteraba dot com
    5 years ago
    You can use the following snippet on servers to grab the live/staging configs in order to be able to replicate those in your development environment. (I use `php -a` for this)
    <?php
    foreach (ini_get_all(null, false) as $key => $value) echo "$key=$value;\n";
    ?>
    up
    -5
    root at mantoru dot de
    13 years ago
    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).
    add a note add a note
    To Top