aracoool / yii2-uuid
Yii 2 UUID Extension. A PHP 7.0+ library for generating RFC 4122 version 3, 4, and 5 universally unique identifiers (UUID).
Installs: 47 554
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 3
Forks: 1
Open Issues: 0
Type:yii2-extension
Requires
- php: >=7.0
- yiisoft/yii2: *
Requires (Dev)
- phpunit/phpunit: ^5.6
This package is auto-updated.
Last update: 2024-12-08 11:06:35 UTC
README
Yii 2 UUID Extension. A PHP 7.0+ library for generating RFC 4122 version 3, 4, and 5 universally unique identifiers (UUID).
About
From Wikipedia:
The intent of UUIDs is to enable distributed systems to uniquely identify information without significant central coordination. In this context the word unique should be taken to mean "practically unique" rather than "guaranteed unique". Since the identifiers have a finite size, it is possible for two differing items to share the same identifier. The identifier size and generation process need to be selected so as to make this sufficiently improbable in practice. Anyone can create a UUID and use it to identify something with reasonable confidence that the same identifier will never be unintentionally created by anyone to identify something else. Information labeled with UUIDs can therefore be later combined into a single database without needing to resolve identifier (ID) conflicts.
Installation
The preferred method of installation is via Packagist and Composer. Run the following command to install the package and add it as a requirement to your project's composer.json
:
composer require --prefer-dist aracoool/yii2-uuid
Usage
Behavior usage for V4
use \aracoool\yii2-uuid\UuidBehavior /** * @return array */ public function behaviors() { return [ [ 'class' => UuidBehavior::class, 'version' => Uuid::V4 ], ... ]; }
Behavior usage for V3 and V5
use \aracoool\yii2-uuid\UuidBehavior /** * @return array */ public function behaviors() { return [ [ 'class' => UuidBehavior::class, 'version' => Uuid::V3, // Uuid::V5 'namespace' => Uuid::NAMESPACE_NIL, 'nameAttribute' => 'title' // Value of this attribute SHOULD be unique in your database ], ... ]; }
use \aracoool\yii2-uuid\Uuid Uuid::v3(Uuid::NAMESPACE_URL, 'http://example.com/'); Uuid::v5(Uuid::NAMESPACE_DSN, 'www.google.com'); Uuid::v3(Uuid::NAMESPACE_OID, '1.3.6.1'); Uuid::v5(Uuid::NAMESPACE_X500, 'c=ca'); Uuid::v4();
Validator usage
use \aracoool\yii2-uuid\UuidValidator; /** * @return array */ public function rules() { return [ ... ['attribute_id', UuidValidator::class], ... ]; }