ConFoo 2025

php_ini_scanned_files

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

php_ini_scanned_filesRetourne la liste des fichiers .ini analysés dans les dossiers de configuration supplémentaires

Description

php_ini_scanned_files(): string|false

php_ini_scanned_files() retourne une liste de noms de fichiers de configuration analysés après php.ini. Cette liste est au format CSV. Les dossiers examinés sont définis par une option de configuration lors de la compilation, et optionnellement par une variable d'environnement lors de l'exécution : plus d'information sont disponible dans le guide d'installation.

Les fichiers de configuration retournés incluent le chemin entier.

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Retourne une chaîne de caractères où les fichiers .ini sont séparés par des virgules en cas de succès. Chaque virgule est suivie d'un retour à la ligne. Si la directive de configuration --with-config-file-scan-dir n'a pas était définit et que la variable d'environnement PHP_INI_SCAN_DIR n'est pas définit, false est retourné. Si c'était définit et que le dossier était vide, une chaîne vide est retournée. Si un fichier est méconnaissable, le fichier sera quand même inclus dans la chaîne de caractères retourné mais entraînera également une erreur PHP. Cette erreur PHP sera visible à la fois au moment de la compilation et lors de l'utilisation de php_ini_scanned_files().

Exemples

Exemple #1 Un exemple de liste retournée par php_ini_scanned_files()

<?php
if ($filelist = php_ini_scanned_files()) {
if (
strlen($filelist) > 0) {
$files = explode(',', $filelist);

foreach (
$files as $file) {
echo
"<li>" . trim($file) . "</li>\n";
}
}
}
?>

Voir aussi

  • ini_set() - Modifie la valeur d'une option de configuration
  • phpinfo() - Affiche de nombreuses informations sur la configuration de PHP
  • php_ini_loaded_file() - Récupère le chemin d'un fichier php.ini chargé

add a note

User Contributed Notes 1 note

up
2
atesin () gmail ! com
5 years ago
<warning>

until i load more .ini files from <php-dir>/php.d/ as listed in phpinfo() (sections "Scan this dir for additional .ini files" and "Additional .ini files parsed"), php_ini_scanned_files() returns me NOTHING!

then i realized my php binary was not compiled with the "--with-config-file-scan-dir" option as listed in phpinfo() (section "Configure Command")

then i remembered the additional .ini files dir was set through the "PHP_INI_SCAN_DIR" system variable (new since php 5.2.0, see https://php.net/manual/en/configuration.file.php#configuration.file.scan)

until confusing and annoying, is the documented behavior... too bad now i don't know how to get the additional ini files purely with php functions (except "shell_exec()" maybe?)

</warning>
To Top