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 или строке (string) core.

details

Возвращать для каждого параметра подробную информацию или только текущее значение. Значение по умолчанию равно true: возвращать подробные сведения.

Возвращаемые значения

Функция возвращает ассоциативный массив с именами директив в качестве ключей. Функция возвращает false и вызывает ошибку уровня E_WARNING, если модуль extension не существует.

Если параметр 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.*.

Смотрите также