(PHP 4, PHP 5, PHP 7)
ini_get — Получает значение настройки конфигурации
$varname
)В случае успеха возвращает значение настройки конфигурации.
varnameИмя настройки конфигурации.
Возвращает значение настройки конфигурации в виде строки. Для значений
null будет возвращаться пустая строка. Функция вернет
FALSE, если указанная настройка не существует.
Пример #1 Несколько примеров использования ini_get()
<?php
/*
Наш файл php.ini содержит следующие настройки:
display_errors = On
register_globals = Off
post_max_size = 8M
*/
echo 'display_errors = ' . ini_get('display_errors') . "\n";
echo 'register_globals = ' . ini_get('register_globals') . "\n";
echo 'post_max_size = ' . ini_get('post_max_size') . "\n";
echo 'post_max_size+1 = ' . (ini_get('post_max_size')+1) . "\n";
echo 'post_max_size in bytes = ' . return_bytes(ini_get('post_max_size'));
function return_bytes($val) {
$val = trim($val);
$last = strtolower($val[strlen($val)-1]);
switch($last) {
// Модификатор 'G' доступен, начиная с PHP 5.1.0
case 'g':
$val *= 1024;
case 'm':
$val *= 1024;
case 'k':
$val *= 1024;
}
return $val;
}
?>
Результатом выполнения данного примера будет что-то подобное:
display_errors = 1 register_globals = 0 post_max_size = 8M post_max_size+1 = 9 post_max_size in bytes = 8388608
Замечание: Возвращаемые boolean-значения
Boolean-значение ini-настройки off будет возвращено в виде пустой строки или строки "0", в то время как значению on будет соответствовать строка "1". Функция также может возвращать буквенные значения INI настройки.
Замечание: Возвращаемые значения количества памяти
Многие ini настройки, значения которых измеряются количеством памяти, такие как upload_max_filesize, записаны в php.ini в сокращенном виде. ini_get() вернет именно то, что записано в файле php.ini, а НЕ целочисленный integer эквивалент этой величины. Попытка использования полученной величины в арифметических операциях не даст желаемого результата. В приведенном выше примере продемонстрировано, как можно перевести сокращенную запись в число байт.
Замечание:
ini_get() не может прочесть опции типа "массив", такие как pdo.dsn.*, и возвращает
FALSEтаких случаях.
| Версия | Описание |
|---|---|
| 5.3.0 |
Раньше возвращалась пустая строка, если конфигурационная опция отсутствует.
Теперь вместо этого возвращается FALSE.
|