get_included_files

(PHP 4, PHP 5, PHP 7, PHP 8)

get_included_files — include または require で読み込まれたファイルの名前を配列として返す

説明

get_included_files(): array

この関数は、 include、include_once、 require あるいは require_once によりスクリプトにロードされたすべてのファイルの名前を取得します。

パラメータ

この関数にはパラメータはありません。

戻り値

すべてのファイル名を含む配列を返します。

最初にコールされたスクリプトは "include されたファイル" という扱いになります。そのため、 include やその仲間たちにより読み込まれたファイルの一覧に含めて表示されます。

複数回読み込まれているファイルも、返される配列には一度しかあらわれません。

例

例1 get_included_files() の例

<?php
// このファイルは abc.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";
}

?>

上の例の出力は以下となります。

/path/to/abc.php
/path/to/test1.php
/path/to/test2.php
/path/to/test3.php
/path/to/test4.php

参考

include - include
include_once - include_once
require - require
require_once - require_once
get_required_files() - get_included_files のエイリアス