get_included_files

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

get_included_files — 返回被 include 和 require 文件名的 array

说明

get_included_files(): array

返回所有被 include、 include_once、 require 和 require_once 的文件名。

返回值

返回所有文件名称的 array。

脚本最初被称为”被包含的文件“，所以脚本自身也会和 include 系列函数引用的脚本列在一起。

被多次 include 和 require 的文件在返回的 array 里只会列出一次。

范例

示例 #1 get_included_files() 范例

<?php 
// 本文件是 abc.phpinclude '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

注释

注意:
使用 auto_prepend_file 配置指令所包含的文件不会包含在返回的数组里。

参见

include - include
include_once - include_once
require - require
require_once - require_once
get_required_files() - 别名 get_included_files

PHP（0）