array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.ini-get.php', 1 => 'ini_get', 2 => 'Lit la valeur d\'une option de configuration', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'Fonctions sur les options et les informations de 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' => 'fr', '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 — Lit la valeur d'une option de configuration

Description

ini_get(string $option): string|false

Retourne la valeur de l'option de configuration option en cas de succès.

Liste de paramètres

option

Le nom de l'option de configuration.

Valeurs de retour

Retourne la valeur de l'option de configuration option en cas de succès, ou une chaîne de caractères vide pour les valeurs null. Retourne false si l'option de configuration n'existe pas.

Exemples

Exemple #1 Exemples avec ini_get()

<?php

/*
Notre fichier php.ini contient les directives suivantes :

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'));

?>

Résultat de l'exemple ci-dessus est similaire à :

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

Notes

Note: Lecture de valeurs booléennes

Une directive de configuration ayant la valeur de off sera retournée sous la forme d'une chaîne vide ou "0" alors que la valeur on retournera "1". Cette fonction peut également retourner la valeur littérale du fichier INI.

Note: Lors de la lecture des tailles de mémoire

Plusieurs directives traitant de taille mémoire, comme upload_max_filesize, sont stockées dans le fichier php.ini avec une notation courte. ini_get() retourne la chaîne exacte stockée dans le fichier php.ini et NON PAS son équivalent entier. Appliquer des opérations arithmétiques classiques sur ces valeurs ne conduira à rien de bon. La fonction ini_parse_quantity() peut être utilisée pour convertir la notation abrégée en octets.

Note:

ini_get() ne peut pas lire les options ini de type "array" tel que pdo.dsn.*, et retourne false dans ce cas.

Voir aussi