php_ini_scanned_files

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

php_ini_scanned_filesDevuelve la lista de ficheros .ini analizados en los directorios de configuración adicionales

Descripción

php_ini_scanned_files(): string|false

php_ini_scanned_files() devuelve una lista de nombres de ficheros de configuración analizados después de php.ini. Esta lista está en formato CSV. Los directorios examinados son definidos por una opción de configuración durante la compilación, y opcionalmente por una variable de entorno durante la ejecución: más información está disponible en el guía de instalación.

Los ficheros de configuración devueltos incluyen la ruta completa.

Parámetros

Esta función no tiene parámetros.

Valores devueltos

Devuelve un string donde los ficheros .ini están separados por comas en caso de éxito. Cada coma es seguida por un retorno de línea. Si la directiva de configuración --with-config-file-scan-dir no ha sido definida y la variable de entorno PHP_INI_SCAN_DIR no está definida, false es devuelto. Si estaba definida y el directorio estaba vacío, una cadena vacía es devuelta. Si un fichero es ilegible, el fichero será igualmente incluido en el string devuelto pero también provocará un error PHP. Este error PHP será visible tanto durante la compilación como al utilizar php_ini_scanned_files().

Ejemplos

Ejemplo #1 Un ejemplo de lista devuelta por 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";
}
}
}
?>

Ver también

  • ini_set() - Modifica el valor de una opción de configuración
  • phpinfo() - Muestra numerosas informaciones sobre la configuración de PHP
  • php_ini_loaded_file() - Obtiene la ruta de un archivo php.ini cargado

add a note

User Contributed Notes 1 note

up
0
atesin () gmail ! com
6 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