php_ini_scanned_files
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
php_ini_scanned_files — Retorna uma lista de arquivos .ini analisados do diretório ini adicional
Descrição
php_ini_scanned_files() retorna uma lista separada por vírgulas de arquivos de configuração analisados após o php.ini. Os diretórios pesquisados são definidos por uma opção em tempo de compilação e, opcionalmente, por uma variável de ambiente em tempo de execução: mais informações podem ser encontradas no guia de instalação.
Os arquivos de configuração retornados incluem o caminho completo.
Parâmetros
Esta função não possui parâmetros.
Valor Retornado
Retorna uma sequência separada por vírgulas de arquivos .ini em caso de sucesso. Cada vírgula é
seguida por uma nova linha. Se a diretiva --with-config-file-scan-dir do comando configure não tiver sido definida e a
variável de ambiente PHP_INI_SCAN_DIR também não estiver definida, false
é retornado. Se foi definida e o diretório estiver vazio, uma string vazia será
retornada. Se um arquivo estiver irreconhecível, o arquivo ainda aparecerá na
string retornada, mas também ocorrerá um erro de PHP. Este erro do PHP será
visto tanto em tempo de compilação quanto durante o uso de
php_ini_scanned_files().
Exemplos
Example #1 Um exemplo simples para listar os arquivos ini retornados
<?php
if ($filelist = php_ini_scanned_files()) {
if (strlen($filelist) > 0) {
$files = explode(',', $filelist);
foreach ($files as $file) {
echo "<li>" . trim($file) . "</li>\n";
}
}
}
?>
Veja Também
- ini_set() - Define o valor de uma opção de configuração
- phpinfo() - Mostra informações sobre a configuração do PHP
- php_ini_loaded_file() - Obtém o caminho para o arquivo php.ini carregado