ini_get
(PHP 4, PHP 5, PHP 7)
ini_get — Lit la valeur d'une option de configuration
Description
$varname
) : string
Retourne la valeur de l'option de configuration
varname en cas de succès.
Valeurs de retour
Retourne la valeur de l'option de configuration
varname 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
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) {
// Le modifieur 'G' est disponible depuis PHP 5.1.0
case 'g':
$val *= 1024;
case 'm':
$val *= 1024;
case 'k':
$val *= 1024;
}
return $val;
}
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
display_errors = 1 register_globals = 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é 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. L'exemple ci-dessous montre une façon de convertir la notation sténographique en octets, de la même façon dont le fait le source PHP.
Note:
ini_get() ne peut pas lire les options ini de type "array" tel que pdo.dsn.*, et retourne
FALSEdans ce cas.
Historique
| Version | Description |
|---|---|
| 5.3.0 | Précédemment, une chaîne vide était retournée si l'option
de configuration n'existait pas. Maintenant, FALSE sera retourné
dans ce cas.
|
Voir aussi
- get_cfg_var() - Retourne la valeur d'une option de PHP
- ini_get_all() - Lit toutes les valeurs de configuration
- ini_restore() - Restaure la valeur de l'option de configuration
- ini_set() - Modifie la valeur d'une option de configuration
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.ini-get.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
