get_included_files

(PHP 4 , PHP 5)

get_included_files --  Retorna uma matriz com os nomes dos arquivos incluídos ou requeridos

Descrição

array get_included_files ( void )

Retorna uma matriz com os nomes de todos os arquivos que foram incluídos usando as funções include(), include_once(), require() ou require_once().

O script chamado originalmente é considerado um "arquivo incluído", assim será listado junto com os arquivos referenciados por include() e família.

Arquivos que forem incluídos ou requeridos varias vezes aparecem somente uma vez na matriz.

Nota: Arquivos incluídos usando a diretiva de configuração auto_prepend_file não são incluídos na matriz retornada.

Exemplo 1. Exemplo get_included_files() (abc.php)

<?php

include 'test1.php';
include_once
'test2.php';
require
'test3.php';
require_once
'test4.php';

$included_files = get_included_files();

foreach (
$included_files as $filename) {
    echo
"$filename\n";
}

?>

Irá gerar a seguinte saída:

abc.php
test1.php
test2.php
test3.php
test4.php

Nota: No PHP 4.0.1pl2 e versões anteriores get_included_files() assume que os arquivos requeridos terminem com a extensão .php; outras extensões não serão retornadas. A matriz retornada por get_included_files() era uma matriz associativa e listava somente os arquivos incluídos pelas funções include() e include_once().

Veja também include(), include_once(), require(), require_once() e get_required_files().