(PHP 4, PHP 5, PHP 7, PHP 8)
ini_get — Lee el valor de una opción de configuración
Devuelve el valor de la opción de configuración
varname
en caso de éxito.
option
El nombre de la opción de configuración.
Devuelve el valor de la opción de configuración
varname
en caso de éxito, o un
string vacío para los valores null
. Devuelve false
si la opción de configuración no existe.
Ejemplo #1 Ejemplos con ini_get()
<?php
/*
Nuestro archivo php.ini contiene las siguientes directivas:
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'));
?>
El resultado del ejemplo sería algo similar a:
display_errors = 1 opcache.enable_cli = 0 post_max_size = 8M post_max_size+1 = 9 post_max_size in bytes = 8388608
Nota: Lectura de valores booleanos
Una directiva de configuración con el valor
off
será devuelta en forma de cadena vacía o "0" mientras que el valoron
devolverá "1
". Esta función también puede devolver el valor literal del archivo INI.
Nota: Al leer los tamaños de memoria
Varias directivas que tratan sobre tamaño de memoria, como upload_max_filesize, están almacenadas en el archivo php.ini con una notación corta. ini_get() devuelve la cadena exacta almacenada en el archivo php.ini y NO su equivalente int. Aplicar operaciones aritméticas clásicas sobre estos valores no conducirá a nada bueno. La función ini_parse_quantity() puede ser utilizada para convertir la notación abreviada en bytes.
Nota:
ini_get() no puede leer las opciones ini de tipo "array" como
pdo.dsn.*
, y devuelvefalse
en este caso.