Yii2自定义规则校验时间参数完整代码-php教程-PHP中文网

yii2中自定义时间校验推荐两种方案：一是内联校验器，适合简单场景，在model中用匿名函数校验格式、空值及时序；二是独立datetimevalidator类，支持格式、范围及时序比较，复用性强。

yii2自定义规则校验时间参数完整代码

<p>在 Yii2 中自定义时间参数校验规则，推荐通过继承 <strong>yii\validators\Validator</strong> 或使用匿名函数（inline validator）实现。下面提供两种常用、可直接运行的完整方案，支持如 <code>start_time</code>、<code>end_time</code> 格式校验（如 <code>"Y-m-d H:i:s"</code>）、空值处理、时序逻辑（如 start ≤ end）等典型需求。</p>

<h3>方案一：内联校验器（适合简单场景，代码写在 Model 中）</h3>
<p>在模型类（如 <code>EventForm.php</code>）中定义：</p>
<pre class="brush:php;toolbar:false;"><code class="php">
namespace app\models;

use yii\base\Model;
use yii\helpers\ArrayHelper;

class EventForm extends Model
{
    public $start_time;
    public $end_time;

    public function rules()
    {
        return [
            // 必填 + 时间格式校验（允许为空时去掉 required）
            [['start_time', 'end_time'], 'required'],
            [['start_time', 'end_time'], 'filter', 'filter' => 'trim'],
            [['start_time', 'end_time'], function ($attribute) {
                $value = $this->$attribute;
                if (empty($value)) {
                    $this->addError($attribute, "{$attribute} 不能为空");
                    return;
                }
                $timestamp = strtotime($value);
                if ($timestamp === false) {
                    $this->addError($attribute, "{$attribute} 格式不正确，应为 'Y-m-d H:i:s'（如：2024-05-20 14:30:00）");
                    return;
                }
                // 可选：限制时间范围（如不能早于当前时间）
                if ($attribute === 'start_time' && $timestamp addError($attribute, '开始时间不能早于一小时前');
                }
            }],
            // 时序校验：start_time start_time);
                $end = strtotime($this->end_time);
                if ($start !== false && $end !== false && $start > $end) {
                    $this->addError($attribute, '结束时间不能早于开始时间');
                }
            }],
        ];
    }
}
</code>

方案二：独立验证器类（推荐复用，结构清晰）

创建文件 common/validators/DateTimeValidator.php：

Yii Framework 2.0.51

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

下载

<code class="php">
<?php namespace common\validators;

use yii\validators\Validator;
use yii\helpers\Html;

class DateTimeValidator extends Validator
{
    public $format = 'Y-m-d H:i:s';
    public $allowEmpty = true;
    public $minTimestamp;
    public $maxTimestamp;
    public $compareAttribute;
    public $compareOperator = '<='; // 支持 <=, >=, ==

    public function validateAttribute($model, $attribute)
    {
        $value = $model->$attribute;

        if ($this->allowEmpty && empty($value)) {
            return;
        }

        $timestamp = strtotime($value);
        if ($timestamp === false) {
            $this->addError($model, $attribute, '时间格式错误，应为 {format}', ['format' => $this->format]);
            return;
        }

        if ($this->minTimestamp !== null && $timestamp minTimestamp) {
            $minTime = date($this->format, $this->minTimestamp);
            $this->addError($model, $attribute, '{attribute} 不能早于 {minTime}', ['minTime' => $minTime]);
        }

        if ($this->maxTimestamp !== null && $timestamp > $this->maxTimestamp) {
            $maxTime = date($this->format, $this->maxTimestamp);
            $this->addError($model, $attribute, '{attribute} 不能晚于 {maxTime}', ['maxTime' => $maxTime]);
        }

        if ($this->compareAttribute && isset($model->{$this->compareAttribute})) {
            $otherValue = $model->{$this->compareAttribute};
            $otherTimestamp = strtotime($otherValue);
            if ($otherTimestamp !== false && $timestamp !== false) {
                $result = match($this->compareOperator) {
                    ' $timestamp =' => $timestamp >= $otherTimestamp,
                    '==' => $timestamp == $otherTimestamp,
                    default => false,
                };
                if (!$result) {
                    $opText = match($this->compareOperator) {
                        ' '早于',
                        '>=' => '晚于',
                        '==' => '不等于',
                        default => '不符合比较要求',
                    };
                    $this->addError($model, $attribute, '{attribute} 不能{op} "{compareAttribute}"', [
                        'op' => $opText,
                        'compareAttribute' => $this->compareAttribute,
                    ]);
                }
            }
        }
    }
}
</code>

在模型中使用：

<code class="php">
use common\validators\DateTimeValidator;

// 在 rules() 中：
[
    ['start_time'], 
    DateTimeValidator::class, 
    'format' => 'Y-m-d H:i:s',
    'allowEmpty' => false,
    'minTimestamp' => time() - 86400, // 允许昨天起
],
[
    ['end_time'], 
    DateTimeValidator::class, 
    'format' => 'Y-m-d H:i:s',
    'compareAttribute' => 'start_time',
    'compareOperator' => '>=',
],
</code>

补充：控制器中调用与错误提示

确保控制器中正确触发验证并返回结构化错误：

<code class="php">
public function actionCreate()
{
    $model = new EventForm();
    if ($model->load(\Yii::$app->request->post()) && $model->validate()) {
        // 处理业务逻辑...
        return $this->asJson(['success' => true]);
    }

    return $this->asJson([
        'success' => false,
        'errors' => $model->getErrors(), // 自动返回字段级错误
    ]);
}
</code>

前端可直接读取 errors.start_time 显示提示。

关键注意事项

Yii2 默认不自动转换字符串时间为 timestamp，必须显式调用 strtotime() 或 DateTime::createFromFormat()；
若需严格格式（如拒绝 "2024-05-20 14:30" 缺少秒），建议用 DateTime::createFromFormat() 替代 strtotime()；
数据库存入前，建议统一转为 date('Y-m-d H:i:s', $timestamp) 或交由 ActiveRecord 的 datetime 类型自动处理；
时区问题：确保 PHP 和 MySQL 时区一致（推荐统一设为 Asia/Shanghai），或在校验前调用 date_default_timezone_set()。