New #1152: Add UuidValue expression for DBMS-independent UUID values

[KalimeroMK]

Q	A
Is bugfix?	❌
New feature?	✔️
Breaks BC?	❌
Fixed issues	#1152

Adds UuidValue, an expression that carries a UUID and is bound in the representation the current DBMS expects — raw bytes for MySQL, MariaDB, SQLite and Oracle, canonical string for PostgreSQL and MSSQL:

$db->createCommand()->insert('{{%page}}', ['id' => new UuidValue(Uuid::uuid7())])->execute();

It accepts the canonical form, 32 hexadecimal characters, 16 raw bytes or any Stringable. Passing raw bytes or a raw string directly keeps working as before.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.62%. Comparing base (11032c2) to head (69c141d).

Additional details and impacted files

@@            Coverage Diff            @@
##             master    #1199   +/-   ##
=========================================
  Coverage     98.62%   98.62%           
- Complexity     1641     1644    +3     
=========================================
  Files           120      122    +2     
  Lines          4283     4291    +8     
=========================================
+ Hits           4224     4232    +8     
  Misses           59       59           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Tigrov]

This looks like a part of realization, with canonical string form. What about realizations for other concrete DBMS?

[KalimeroMK]

@Tigrov correct, this is only the core half — the default builder covers PostgreSQL and MSSQL, while MySQL/MariaDB/SQLite/Oracle override prepareValue() to bind the raw bytes.

Correction to what I wrote earlier about CI: no tag is needed. install-packages resolves yiisoft/db from a same-named branch in my fork, so I can open the driver PRs from add-1152-uuid-value and they will be green against this branch right away. I will do that, so you can review the whole thing as one unit.

[KalimeroMK]

@Tigrov driver PRs are up, green against this branch on real databases:

• New: Add SQLite implementation of UuidValue expression db-sqlite#432 — blob(16)
• New: Add MySQL implementation of UuidValue expression db-mysql#482 — binary(16), MariaDB included
• New: Add Oracle implementation of UuidValue expression db-oracle#411 — raw(16)

db-pgsql and db-mssql need nothing.

Oracle could not use the prepareValue() seam: PDO_OCI inserts NULL for a raw(16) column bound as DataType::LOB, so it emits a HEXTORAW() literal instead, as prepareBinary() already does there.

Correction to my earlier note about CI: composer-dependency-analyser does a plain composer install, so it stays red in all three until 2.0.2 is tagged and the drivers bump yiisoft/db to ^2.0.2. I will push that bump when you tag.

[KalimeroMK]

@Tigrov both review comments are addressed in 6795ad2 and CI is green (82 checks, mergeable).

Could you merge this and tag 2.0.2? The three driver PRs — yiisoft/db-sqlite#432, yiisoft/db-mysql#482, yiisoft/db-oracle#411 — are ready and only waiting on that tag: their composer-dependency-analyser failures clear as soon as UuidValue exists in a released version.

[Tigrov]

@KalimeroMK Thanks 👍