php_ini_scanned_files

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

php_ini_scanned_files — 返回從額外 ini 目錄里解析的 .ini 文件列表

說明

php_ini_scanned_files(): string

php_ini_scanned_files() 返回解析的 php.ini 后逗號(hào)分隔的配置文件列表。 這些文件從編譯時(shí) --with-config-file-scan-dir 選項(xiàng)里指定的目錄里找到。

這些返回的配置文件也包括了 --with-config-file-scan-dir 選項(xiàng)里聲明的路徑。

返回值

成功時(shí)返回逗號(hào)分隔的 .ini 文件字符串。 每個(gè)逗號(hào)后緊跟新的一行。 如果未設(shè)置指令 --with-config-file-scan-dir 將會(huì)返回 false。 如果它設(shè)置了，并且目錄是空的，將會(huì)返回一個(gè)空字符串。 如果有未識(shí)別的文件，此文件也會(huì)進(jìn)入返回的字符串，但是會(huì)導(dǎo)致一個(gè) PHP 錯(cuò)誤。 此 PHP 錯(cuò)誤即會(huì)在編譯時(shí)出現(xiàn)也會(huì)在使用 php_ini_scanned_files() 函數(shù)時(shí)出現(xiàn)。

范例

示例 #1 列出返回的 ini 文件的簡單例子

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

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

參見