(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
php_ini_scanned_files — Ek ini dizininden ayrıştırılan dosyaların listesi ile döner
php_ini_scanned_files() işlevi php.ini dosyasından sonra ayrıştırılan yapılandırma dosyalarını bir virgül ayraçlı liste olarak döndürür. Bu dizinler, derleme sırasında bir seçenek ile ve çalışma zamanında isteğe bağlı olarak bir ortam değişkeni tarafından taranır. Daha fazla bilgi Tarama Dizinleri bölümünde bulunabilir.
Döndürülen yapılandırma dosyaları tam dosya yolunu içerir.
Bu işlevin bağımsız değişkeni yoktur.
Başarı durumunda .ini dosyalarının virgül ayraçlı listesini bir dizge olarak döndürür. Derleme sırasında --with-config-file-scan-dir seçeneği kullanılmamışsa ve PHP_INI_SCAN_DIR ortam değişkenine bir dizin atanmamışsa false
döner. Bunlara dizin atanmış ama dizin tarandığında boşsa, boş dizge döner. INI dosyası olmayan bir dosyanın varlığı halinde dosya ismi listeye konur, fakat ek olarak bir PHP hatası çıktılanır. Bu PHP hatası hem derleme sırasında hem de php_ini_scanned_files() işlevi kullanıldığında görüntülenir.
Örnek 1 - Dönen ini dosyalarının listelenmesi
<?php
if ($filelist = php_ini_scanned_files()) {
if (strlen($filelist) > 0) {
$files = explode(',', $filelist);
foreach ($files as $file) {
echo "<li>" . trim($file) . "</li>\n";
}
}
}
?>