如何在PHPUnit模拟中校验方法传入的指定参数

嘿，这个需求在日常单元测试里太常见了，我给你分享几种最实用的实现方式：

方法1：用anything()忽略无关参数 #

如果arg1和arg3你完全不关心具体值，只想确保arg2符合预期，直接用anything()匹配前、后两个参数就行，这是最简单直接的方案：

// 假设你模拟的是MyClass类的myMethod方法
$mock = $this->createMock(MyClass::class);

// 设定预期：调用myMethod时，arg1任意值，arg2必须是"target_value"，arg3任意值
$mock->expects($this->once())
     ->method('myMethod')
     ->with(
         $this->anything(),       // 跳过arg1的校验
         $this->equalTo('target_value'), // 严格校验arg2的预期值
         $this->anything()        // 跳过arg3的校验
     );

方法2：用回调函数做复杂校验 #

如果arg2的校验规则比较灵活（比如需要判断是否是某个类的实例、是否满足自定义条件），可以用callback()编写自定义校验逻辑：

$mock->expects($this->once())
     ->method('myMethod')
     ->with(
         $this->anything(),
         $this->callback(function ($arg2) {
             // 这里写你的自定义校验逻辑，返回true表示校验通过
             return is_array($arg2) && count($arg2) === 3 && $arg2['key'] === 'expected';
         }),
         $this->anything()
     );

方法3：用withConsecutive适配多调用场景 #

如果你的模拟方法会被调用多次，且每次需要校验不同的arg2值，withConsecutive能精准匹配每次调用的参数：

// 比如第一次调用arg2是"first_val"，第二次是"second_val"
$mock->expects($this->exactly(2))
     ->method('myMethod')
     ->withConsecutive(
         [$this->anything(), 'first_val', $this->anything()],
         [$this->anything(), 'second_val', $this->anything()]
     );

注：如果是PHPUnit 9+版本，这些匹配器的底层命名空间是PHPUnit\Framework\MockObject\Matcher，但日常使用直接用$this->xxx()的语法糖就足够了。

内容的提问来源于stack exchange，提问作者ssk