如何通过PHPUnit进行PHP私有函数和保护方法的单元测试？

本文共计1088个文字，预计阅读时间需要5分钟。

如果您在编写PHPUnit测试时需要验证类中私有函数或受保护方法的行为，但又无法直接调用它们，可以通过以下几种技术来实现可测试性：

一、使用反射机制调用私有/受保护方法

PHP 的 ReflectionMethod 类允许临时绕过访问控制限制，使私有或受保护方法可在测试中被显式调用。该方式不修改原类结构，适用于临时验证逻辑或遗留代码测试。

1、创建 ReflectionMethod 实例，传入目标类名与方法名。

2、调用 setAccessible(true) 方法解除访问限制。

立即学习“PHP免费学习笔记（深入）”；

3、使用 invoke() 或 invokeArgs() 执行方法：若方法为实例方法，第一个参数传入类实例；若为静态方法，传入 null。

4、若方法接收参数，使用 invokeArgs($instance, [$arg1, $arg2]) 传递参数数组。

5、捕获返回值或异常，结合 PHPUnit 断言进行验证。

二、将私有方法重构为受保护方法后使用 partial mock

将 private 方法改为 protected 后，PHPUnit 可通过 partial mock 机制覆盖其行为，从而实现对依赖路径的隔离控制。此方式符合可测试性设计原则，且避免反射带来的脆弱性。

1、修改原类，将待模拟的私有方法访问修饰符由 private 改为 protected。

2、在测试中使用 getMockBuilder() 构建类的 partial mock 对象。

3、通过 onlyMethods(['methodName']) 明确指定仅 mock 目标受保护方法。

4、调用 expects()->method() 配置期望调用次数、参数与返回值。

5、调用被测的公共或受保护方法，触发内部对已 mock 方法的调用。

三、通过继承子类覆盖受保护方法

对于原本即为 protected 的方法，可创建一个测试专用的子类，在其中重写该方法以注入可控行为或返回值。该方式无需反射，语义清晰，且完全兼容 PHPUnit 原生机制。

1、定义一个匿名类或具名测试子类，继承自待测类。

2、在子类中重写目标受保护方法，替换为返回预设值或执行断言逻辑的实现。

3、在测试中实例化该子类而非原类。

4、调用上层方法，确认其行为符合预期，包括对重写方法的调用结果。

四、利用 __get/__set 或魔术方法暴露私有属性用于断言

当测试需验证私有属性是否被正确赋值（如构造过程或方法执行后的状态变更），可通过临时扩展类行为，允许测试上下文读取私有属性值。该方式适用于状态驱动型验证场景。

1、在待测类中添加条件性 __get 魔术方法，检查调用栈是否来自 tests/ 目录或 PHPUnit 运行环境。

2、若满足条件，直接返回对应私有属性值；否则抛出错误或静默拒绝。

3、在测试中通过对象箭头语法（如 $obj->propertyName）读取该属性。

4、使用 assertEquals 或 assertSame 等断言比对实际值与预期值。

五、使用 ReflectionProperty 操作私有属性

对于需验证或预设私有属性初始状态的测试，ReflectionProperty 提供了 setValue() 和 getValue() 接口，可在测试中直接读写私有字段，适用于 setup 阶段的状态注入或 post-execution 状态检查。

1、实例化 ReflectionClass 并传入待测类名。

2、调用 getProperty('propertyName') 获取对应私有属性的反射对象。

3、调用 setAccessible(true) 解除访问限制。

4、调用 setValue($instance, $value) 在测试前注入特定值。

5、在方法执行后调用 getValue($instance) 获取当前值并进行断言。