验证Yii2模型规则需直接调用validate()并检查errors;使用Codeception单元测试,确保启用Yii2模块,通过手动赋值或haveModel()触发校验,邮箱、自定义方法及场景验证均需按规则显式处理。

要验证Yii2模型的规则是否按预期生效,比如必填、邮箱格式、长度限制等,必须绕过HTTP请求直接调用模型方法,在隔离环境中触发validate()并检查errors属性。
创建模型测试类
在tests/unit/models/目录下执行命令生成测试文件:vendor/bin/codecept generate:test unit models/User。
生成的UserTest.php默认继承Codeception\Test\Unit,这是正确起点——别改成PHPUnit\Framework\TestCase,否则无法使用$this->tester和haveModel()等辅助方法。
确保tests/unit.suite.yml中已启用Yii2模块且part包含orm,否则$this->tester->haveModel()会报错找不到模块。
测试必填字段验证失败
方法一:手动构造模型并赋空值
实例化模型→设空字符串→调用validate()→断言errors包含指定属性名。
这一步不能跳过validate()直接查errors,因为Yii2的errors是懒加载的,没触发校验时永远为空数组。
方法二:用Codeception内置辅助方法
【$I->haveModel(User::class, ['username' => ''])】自动完成实例化+赋值+validate,返回带errors的模型对象,后续可链式断言。
注意:此方法只对ActiveRecord或继承自Model的类有效,普通PHP对象不支持。
测试邮箱格式验证通过与失败
第一步:准备合法邮箱数据
创建模型实例→赋值$model->email = 'test@example.com'→调用$model->validate(['email'])→断言$model->hasErrors('email') === false。
第二步:准备非法邮箱数据
赋值$model->email = 'invalid-email'→再次调用$model->validate(['email'])→断言$model->getError('email')返回非空字符串,且内容包含“email”关键词。
第三步:验证错误消息是否可翻译
若项目启用了i18n,需确认$model->getError('email')返回的是翻译后文本而非原始message模板,否则说明app/i18n未正确初始化。
测试自定义验证方法
若模型中定义了public function rules()里引用了['status', 'statusCheck']这样的自定义场景,必须在测试中显式调用该方法并传入参数。
例如:$model->statusCheck($model, 'status'),不能只靠validate()自动触发——除非rules中明确声明为['status', 'statusCheck']且未加on条件。
自定义方法内若调用$this->addError(),错误会正确写入$model->errors,断言方式与内置规则一致。
测试场景(scenario)下的验证行为
方法一:设置场景后验证
实例化模型→执行$model->setScenario('login')→赋值$model->password = ''→调用$model->validate()→检查$model->errors是否含password错误。
方法二:用辅助方法指定场景
$I->haveModel(User::class, [], 'login'),第三个参数即scenario名称,会自动调用setScenario()并完成validate。
注意:若rules中某条规则写了on => ['register'],在login场景下该规则完全不执行,validate()不会报错也不会警告。











