get_included_files
(PHP 4, PHP 5)
get_included_files — 返回被 include 和 require 文件名的 array
说明
array get_included_files
( void
)
返回所有被 include、 include_once、 require 和 require_once 的文件名。
返回值
返回所有文件名称的 array。
脚本最初被称为”被包含的文件“,所以脚本自身也会和 include 系列函数引用的脚本列在一起。
被多次 include 和 require 的文件在返回的 array 里只会列出一次。
更新日志
版本 说明 4.0.1 在 PHP 4.0.1 和之前的版本,本函数会假设所有被 required 的文件以 .php 结尾; 其他扩展名结尾的文件不会被返回。get_included_files() 返回的 array 仅仅列出被 include 和 include_once 所包含的文件。
范例
Example #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 "$filenamen";
}
?>
以上例程会输出:
abc.php test1.php test2.php test3.php test4.php
注释
Note:
使用 auto_prepend_file 配置指令所包含的文件不会包含在返回的数组里。
参见
include - include include_once - include_once require - require require_once - require_once get_required_files() - 别名 get_included_files