PHP类型化私有属性测试及PHPUnit运行语法错误解决方法

一、解决语法报错问题 #

你遇到的ParseError是因为类属性类型声明是PHP 7.4才新增的特性，运行PHPUnit的环境PHP版本低于7.4就会触发该语法错误，可任选以下一种方案解决：

• 方案1：升级运行环境的PHP版本到7.4及以上，同时在FileNavigate.php顶部补全IBase接口的命名空间导入：

use interfaces\IBase;

如果FileNavigate类本身也有命名空间，需要同步调整导入规则，确保能正确识别IBase接口。

• 方案2：如果不能升级PHP版本，将属性的强类型声明改为PHPDoc注释形式，既保留IDE的类型提示能力，也兼容低版本PHP：
  把FileNavigate.php第5行的private IBase $f3;替换为：

/** @var IBase */
private $f3;

同样需要补全IBase的命名空间导入。

二、完成接口校验与私有属性测试 #

构造函数的参数类型声明本身就有校验能力：如果传入的参数未实现IBase接口，PHP会直接抛出TypeError，只要实例化FileNavigate时没有报错，就已经验证了参数符合接口要求。如果需要显式断言私有属性被正确赋值，可以通过反射读取私有属性的值进行校验，测试代码修改如下：

declare(strict_types=1);

use PHPUnit\Framework\TestCase;
use ReflectionClass;

class FileNavigateTest extends TestCase {

    public function testInterface() {
        $mock = $this->createMock(\interfaces\IBase::class);
        // 实例化无异常即证明参数符合IBase接口要求
        $instance = new FileNavigate($mock);
        
        // 反射读取私有属性验证赋值结果
        $reflection = new ReflectionClass($instance);
        $f3Prop = $reflection->getProperty('f3');
        $f3Prop->setAccessible(true);
        $propValue = $f3Prop->getValue($instance);
        
        $this->assertInstanceOf(\interfaces\IBase::class, $propValue);
    }

}

内容的提问来源于stack exchange，提问作者Born-kes