array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'function.ini-get.php', 1 => 'ini_get', 2 => 'Отримує значення конфігураційного параметра', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'Функції налаштування та отримання інформації про PHP', ), 'prev' => array ( 0 => 'function.ini-alter.php', 1 => 'ini_alter', ), 'next' => array ( 0 => 'function.ini-get-all.php', 1 => 'ini_get_all', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'uk', 'path' => 'reference/info/functions/ini-get.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ini_get

(PHP 4, PHP 5, PHP 7, PHP 8)

ini_get — Отримує значення конфігураційного параметра

Опис

ini_get(string $varname): string

Повертає значення конфігураційного параметра, в разі успіху.

Параметри

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) значень

Логічне INI-значення off буде повертатись як пустий рядок або "0", в той час як INI-значення on буде повертатись у вигляді "1". Функція також може повертати INI-значення як рядок у вигляді літер.

Зауваження: При запитуванні значення розміру пам'яті

Багато ini-значень для розміру пам'яті, такі як upload_max_filesize, зберігаються у файлі php.ini зі скороченою нотацією. ini_get() буде повертати точно такий же рядок, який зберігається у файлі php.ini, а НЕ його чисельний (integer) еквівалент. При спробі виконувати звичайні арифметичні дії з такими значеннями, ви матимете непередбачуваний результат. Приклад, що вгорі, показує один з варіантів конвертації скорочених нотацій в байти, дуже подібно до того, як це відбувається в сирцевому коді PHP.

Журнал змін

Версія Опис
5.3.0 Раніше повертався пустий рядок, якщо параметра конфігурації не існувало. Тепер, замість цього, повертається false.

Прогляньте також