array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), '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' => 'ru', '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 $option): string|false

Функция возвращает значение параметра конфигурации в случае успешного выполнения.

Список параметров

option

Название параметра конфигурации.

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

Функция возвращает значение параметра конфигурации в виде строки. Для значений null функция вернёт пустую строку. Функция вернёт false, если опция не существует.

Примеры

Пример #1 Примеры использования функции ini_get()

<?php

/**
* Файл php.ini содержит следующие настройки:
*
* display_errors = On
* opcache.enable_cli = Off
* post_max_size = 8M
*/

echo 'display_errors = ' . ini_get('display_errors') . "\n";
echo 'opcache.enable_cli = ' . (int) ini_get('opcache.enable_cli') . "\n";
echo 'post_max_size = ' . ini_get('post_max_size') . "\n";
echo 'post_max_size + 1 = ' . (rtrim(ini_get('post_max_size'), 'KMG') + 1) . "\n";
echo 'post_max_size in bytes = ' . ini_parse_quantity(ini_get('post_max_size'));

?>

Вывод приведённого примера будет похож на: 

display_errors = 1
opcache.enable_cli = 0
post_max_size = 8M
post_max_size+1 = 9
post_max_size in bytes = 8388608

Примечания

Замечание: Логические значения

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

Замечание: Значения размера памяти

В файле php.ini размер памяти во многих ini-значениях директив наподобие upload_max_filesize хранится в сокращённой нотации. Функция ini_get() вернёт точную строку, которая хранится в файле php.ini, а не целочисленный (int) эквивалент строкового значения. Попытка передать значения таких директив в стандартные арифметические функции не даст того же результата, который функции вернули бы при работе с целочисленными значениями. Для преобразования сокращённой нотации в байты вызывают функцию ini_parse_quantity().

Замечание:

Функция ini_get() не умеет читать «массив» ini-опций наподобие pdo.dsn.* и возвращает false для таких параметров.

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