PHP 8.4.1 Released!

php_ini_scanned_files

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

php_ini_scanned_filesRetorna uma lista de arquivos .ini analisados ​​do diretório ini adicional

Descrição

php_ini_scanned_files(): string|false

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

Exemplo #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

adicione uma nota

Notas Enviadas por Usuários (em inglês) 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