yii2自定义邮箱验证需绕过内置规则，通过编写validateemailunique（查重）、validatecompanydomain（限域名）等方法并在rules()中声明；结合ajax验证时需配置enableajaxvalidation、validationurl及控制器action返回json校验结果。

Yii2 中自定义邮箱验证，核心在于：不依赖内置 email 验证器，而是根据业务需要（比如校验邮箱是否已注册、是否属于指定域名、是否被禁用等）编写专属逻辑，并在模型规则中调用。下面给出三个典型且实用的实现案例。

校验邮箱是否已被注册（唯一性 + 自定义提示）

适用于注册/修改邮箱场景，要求该邮箱在用户表中尚未存在。

• 在模型（如 User）的 rules() 中添加：

[['email'], 'validateEmailUnique']

• 在模型中定义验证方法：

public function validateEmailUnique($attribute, $params)
{
  if ($this->hasErrors($attribute)) {
    return;
  }
  $exists = self::find()
    ->where(['email' => $this->email])
    ->andFilterWhere(['!=', 'id', $this->id ?? null])
    ->exists();
  if ($exists) {
    $this->addError($attribute, '该邮箱已被注册，请换一个');
  }
}

限制邮箱域名（仅允许公司邮箱）

例如只接受 @company.com 结尾的邮箱，增强企业账号管理规范性。

Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板，适合旧项目兼容、升级验证和开发测试。

下载

• 规则写法：

[['email'], 'validateCompanyDomain']

• 验证方法：

public function validateCompanyDomain($attribute, $params)
{
  $email = trim($this->email);
  if (empty($email) || !filter_var($email, FILTER_VALIDATE_EMAIL)) {
    return;
  }
  $domain = substr(strrchr($email, '@'), 1);
  if (!in_array($domain, ['company.com', 'subsidiary.com'])) {
    $this->addError($attribute, '仅支持 company.com 或 subsidiary.com 域名邮箱');
  }
}

结合 AJAX 实时验证（表单失焦即查）

提升用户体验，避免提交后才提示邮箱问题。需前后端协同配置。

• 模型中保持上述任一自定义方法（如 validateEmailUnique）
• 视图中启用 AJAX 验证：

  'enableAjaxValidation' => true,
  'validationUrl' => ['user/validate-email'], // 单独路由，专用于校验
]); ?>

• 控制器中新增 action（返回 JSON 格式验证结果）：

public function actionValidateEmail()
{
  $model = new User();
  $model->load(Yii::$app->request->post());
  Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
  return ActiveForm::validate($model, ['email']);
}

注意：AJAX 验证默认只触发客户端已定义的规则，因此必须确保 rules() 中已声明对应字段+自定义方法，且该方法内调用 addError() 才会返回错误。