在 Yii2 中应使用类常量+getStatusList()统一管理枚举值，rules()中动态生成验证范围并自定义中文错误提示，数据库查询必须引用常量而非魔法数字，确保可维护性与用户体验。
在 Yii2 中验证数据库字段对应的枚举值，必须避免硬编码数字范围、防止新增状态后规则与提示脱节、确保错误信息显示中文名而非 0/1/2，否则表单提交失败时用户看到“Status must be either 0, 1 or 2”会完全无法理解。
用类常量 + getStatusList() 统一管理枚举定义
在模型类顶部一次性定义所有状态常量，例如：const STATUS_DRAFT = 0;、const STATUS_PUBLISHED = 1;、const STATUS_ARCHIVED = 2;。这一步是后续所有验证复用的基础，漏定义任一常量，后续 getStatusList() 和 rules() 都会出错。
紧接着写一个 【getStatusList() 必须返回键值对且键与常量名严格一致】 的公共方法，返回关联数组：return [self::STATUS_DRAFT => '草稿', self::STATUS_PUBLISHED => '已发布', self::STATUS_ARCHIVED => '已归档'];。GridView 列展示、下拉框选项、API 响应都复用这个方法，改一处全生效。
rules() 中不再写死 ['status', 'in', 'range' => [0, 1, 2]]，而是调用 array_keys(static::getStatusList()) 动态生成范围。这样以后新增 const STATUS_DELETED = 3;，只需在常量和 getStatusList() 里加一行，验证逻辑自动覆盖，不用翻 rules() 手动补数字。
让错误提示显示中文名而不是数字
默认的 in 验证器报错是 “Status must be either 0, 1 or 2”，用户根本看不懂。必须重写 message 内容，让它拼接中文名列表。
在 rules() 对应规则中，用 'message' => Yii::t('app', 'Status must be one of: {list}', ['list' => implode(', ', array_values($this->getStatusList()))])。注意：这里不能用 static::getStatusList()，因为验证阶段模型可能未初始化，$this 才能安全调用实例方法。
这行代码直接把 ['草稿', '已发布', '已归档'] 拼成字符串填进提示语，用户看到的就是自然语言。如果 getStatusList() 返回空数组，整个验证会失效，所以务必确认该方法始终有返回值。
数据库查询时按语义写代码，不写魔法数字
第一步：在控制器或服务层中，永远使用常量代替数字进行查询，例如 User::find()->where(['status' => User::STATUS_PUBLISHED])->all()。
第二步：检查 IDE 是否能正常跳转到 STATUS_PUBLISHED 定义处。如果点不了，说明常量没定义或命名不一致，立刻修正——这是语义可维护的关键证据。
第三步：禁止在任何地方出现 ->where(['status' => 1]) 这类写法。它绕过了常量约束，一旦常量值变更（比如把 1 改成 10），这段代码立即失效，且全局搜索不到上下文关联。
