README

为 Yii 2 提供的 UUID 辅助工具和验证器。

此库通过 ramsey/uuid 接口生成 全球唯一标识符。

有关许可证信息，请查看 LICENSE 文件。

安装

安装此扩展的首选方法是通过 composer。

运行以下命令：

php composer.phar require --prefer-dist thamtech/yii2-uuid

或者将以下内容添加到您的 composer.json 文件的 require 部分：

"thamtech/yii2-uuid": "*"

使用方法

生成新的 UUID

生成新的 UUID（默认为版本 4）

$uuid = \thamtech\uuid\helpers\UuidHelper::uuid();

即时验证

验证字符串是否以十六进制文本的规范格式插入连字符进行格式化（不区分大小写）

$uuid = 'de305d54-75b4-431b-adb2-eb6b9e546014';
$isValid = \thamtech\uuid\helpers\UuidHelper::isValid($uuid); // true

$uuid = 'not-a-uuid';
$isValid = \thamtech\uuid\helpers\UuidHelper::isValid($uuid); // false

// or using the Validator class directly
$validator = new \thamtech\uuid\validators\UuidValidator();
if ($validator->validate($uuid, $error)) {
    // valid
} else {
    // not valid
    echo $error
}

或者您可以将 use 行包含在内，尤其是在文件中需要多次调用 uuid 的情况下

use thamtech\uuid\helpers\UuidHelper;
use thamtech\uuid\helpers\UuidValidator;

// ...

$uuid = 'de305d54-75b4-431b-adb2-eb6b9e546014';
$isValid = UuidHelper::isValid($uuid); // true

$uuid = 'not-a-uuid';
$isValid = UuidHelper::isValid($uuid); // false

// or using the Validator class directly
$validator = new UuidValidator();
if ($validator->validate($uuid, $error)) {
    // valid
} else {
    // not valid
    echo $error
}

字段验证

将此验证集成到您的模型中

public function rules()
{
    return [
        [['uuid'], 'thamtech\uuid\validators\UuidValidator'],
    ];
}

另请参阅

• ramsey/uuid

• 全球唯一标识符