PHP Conference Japan 2024

php_ini_scanned_files

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

php_ini_scanned_filesDevuelve una lista de ficheros .ini procesados del directorio adicional ini

Descripción

php_ini_scanned_files(): string

php_ini_scanned_files() devuelve una lista separada por comas de los ficheros de configuración procesados por php.ini. Los directorios buscados se establecen por una opción de tiempo de compilación y, opcionalmente, por una variable de entorno en tiempo de ejecución: se puede encontrar más información en la guía de instalación.

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

Valores devueltos

Devuelve un string de archivos .ini separados por comas en caso de éxito. Cada coma va seguida por una nueva línea. Si la directiva de configuración --with-config-file-scan-dir no fué establecida y la variable de entorno PHP_INI_SCAN_DIR no es establecida, false es retornado. Si estaba configurado y el directorio está vacío, un string vacío es retornado. Si un archivo es irreconocible, el archivo todavía se convertirá en el string retornado pero un error de PHP también resultará. Este error de PHP puede ser visto en tiempo de compilación como mientras se usa php_ini_scanned_files().

Ejemplos

Ejemplo #1 Un ejemplo simple para enumerar los archivos ini devueltos

<?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() - Establece el valor de una directiva de configuración
  • phpinfo() - Muestra información sobre la configuración de PHP
  • php_ini_loaded_file() - Recupera la ruta de acceso al archivo php.ini cargado

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