本文介绍如何在多层 include/require 场景下，精准获取当前脚本的直接父级包含者（即上一层被 include 的脚本）名称，避免误用 SCRIPT_NAME 或 PHP_SELF 返回顶层入口文件的问题。
本文介绍如何在多层 include/require 场景下，精准获取当前脚本的**直接父级包含者**（即上一层被 include 的脚本）名称，避免误用 `script_name` 或 `php_self` 返回顶层入口文件的问题。
在 PHP 的模块化开发中，常通过 include、require 及其带 _once 后缀的变体实现脚本复用与分层组织。例如：index.php → helpers.php → utils.php。此时，若在 utils.php（第三层）中需要动态获知“是谁包含了我”，即 helpers.php 的文件路径，传统全局变量（如 $_SERVER['SCRIPT_NAME']）无法满足——它们始终指向最外层请求入口（如 index.php），而非直接父级。
PHP 提供了内置函数 get_included_files()，它返回自脚本启动以来所有已成功包含/引入的文件路径数组，且按执行顺序严格排列。关键特性在于：该数组是累积式、有序的，即后包含的文件总出现在数组靠后位置；而当前脚本自身必为该数组的最后一个元素，其前一个元素即为直接包含它的父脚本。
因此，在任意被包含脚本（如 utils.php）中，只需以下三行代码即可安全提取父级文件名：
$allIncluded = get_included_files(); $parentFile = $allIncluded[count($allIncluded) - 2] ?? null; echo basename($parentFile); // 输出 'helpers.php' // 或保留完整路径： // echo $parentFile; // 如 '/var/www/helpers.php'
✅ 推荐写法（更健壮）：
立即学习“PHP免费学习笔记（深入）”；
$included = get_included_files(); $parent = count($included) >= 2 ? $included[array_key_last($included) - 1] : null; if ($parent) { echo "Parent script: " . basename($parent); } else { echo "No parent — this is the top-level script."; }
注意事项：
- get_included_files() 包含所有 include/require/include_once/require_once 加载的文件，但不包含通过 eval()、file_get_contents() 或 CLI 参数加载的脚本；
- 若当前脚本是顶层入口（未被任何其他 PHP 文件包含），则数组长度为 1，$included[-2] 将越界，务必做存在性判断；
- 路径为绝对路径（由 PHP 解析器内部生成），可直接用于日志记录或条件逻辑，无需额外 realpath() 处理；
- 此方法完全依赖 PHP 运行时上下文，不涉及超全局变量或外部环境，因此在 CLI、Web、SAPI 等各类环境中均稳定可用。
综上，get_included_files() 是获取直接父级包含脚本的标准、可靠且无副作用的解决方案。它规避了手动维护调用栈或修改包含逻辑的复杂性，是 PHP 脚本间上下文感知的重要实践工具。
