Yii2自定义规则校验身份证参数实操示例-php教程-PHP中文网

Yii2中校验身份证号需继承Validator类或使用内联验证器，核心是验证18位格式（前17位数字、第18位数字/X）、出生日期合法性及ISO 7064 MOD 11-2加权校验码。

yii2自定义规则校验身份证参数实操示例

Yii2 中自定义规则校验身份证号，核心是继承 yii\validators\Validator 或直接在模型中使用 inline validator，重点在于实现中国 18 位身份证的合法性验证：前 17 位为数字、第 18 位为数字或 X/x，且需通过加权校验码（ISO 7064:1983 MOD 11-2）校验。

一、创建独立的身份证校验器类

推荐封装为可复用的验证器类，便于多处调用和测试：

在 common/validators/（或 components/validators/）下新建 IDCardValidator.php
继承 yii\validators\Validator，重写 validateAttribute()
校验逻辑包含：长度判断、字符格式、出生日期合理性（年份不早于1900、不晚于当前年）、地区码有效性（可选）、最后一位校验码计算

示例关键代码：

namespace common\validators;
<p>use yii\validators\Validator;</p><p>class IDCardValidator extends Validator
{
public function validateAttribute($model, $attribute)
{
$value = $model->$attribute;
if (!$this->isValidIDCard($value)) {
$this->addError($model, $attribute, '{attribute} 不是有效的身份证号码');
}
}</p><pre class="brush:php;toolbar:false;">protected function isValidIDCard($id)
{
    if (empty($id)) return false;
    $id = strtoupper(trim($id));
    if (!preg_match('/^\d{17}[\dX]$/', $id)) return false;

    // 校验出生日期（YYYYMMDD）
    $year = substr($id, 6, 4);
    $month = substr($id, 10, 2);
    $day = substr($id, 12, 2);
    if (!checkdate((int)$month, (int)$day, (int)$year)) return false;
    if ($year  date('Y')) return false;

    // 校验码权重与对照表
    $weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
    $checkCodes = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];

    $sum = 0;
    for ($i = 0; $i <p>}</p>

二、在模型中使用该验证器

在 ActiveRecord 或 FormModel 类中，将字段加入 rules() 方法即可：

Yii Framework 2.0.51

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

下载

确保已正确引入命名空间：use common\validators\IDCardValidator;
规则写法简洁明确，支持自定义错误消息

示例：

public function rules()
{
    return [
        // ... 其他规则
        ['id_card', IDCardValidator::class, 'message' => '请输入正确的身份证号码'],
        // 或启用严格模式（空值也校验）
        ['id_card', IDCardValidator::class, 'skipOnEmpty' => false],
    ];
}

三、快速验证：内联验证器（适合简单场景）

若仅某一个模型临时使用，可不用单独建类，直接在 rules() 中写匿名函数：

注意闭包内访问 $this 需用 use ($this)（PHP 7.4+ 支持直接 use $this）
逻辑同上，但复用性差，调试和单元测试不便

示例：

['id_card', function ($attribute) {
    $v = $this->$attribute;
    if ($v && !preg_match('/^\d{17}[\dX]$/i', $v)) {
        $this->addError($attribute, '身份证格式不正确');
        return;
    }
    // 此处补充加权校验逻辑（同上 isValidIDCard 内容）
    // ...
}]