ini_get

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

ini_getLee el valor de una opción de configuración

Descripción

ini_get(string $option): string|false

Devuelve el valor de la opción de configuración varname en caso de éxito.

Parámetros

option

El nombre de la opción de configuración.

Valores devueltos

Devuelve el valor de la opción de configuración varname en caso de éxito, o un chaîne de caractères vacío para los valores null. Devuelve false si la opción de configuración no existe.

Ejemplos

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

Notas

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 valor on 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 entier. 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 devuelve false en este caso.

Ver también