Class BinaryUuidType
Binary UUID type converter.
Use to convert binary uuid data between PHP and the database types.
Property Summary
-
$_name protected
string|null
Identifier name for this type
Method Summary
-
__construct() public
Constructor
-
convertBinaryUuidToString() protected
Converts a binary uuid to a string representation
-
convertStringToBinaryUuid() protected
Converts a string UUID (36 or 32 char) to a binary representation.
-
getBaseType() public
Returns the base type name that this class is inheriting.
-
getName() public
Returns type identifier name for this object.
-
marshal() public
Marshals flat data into PHP objects.
-
newId() public
Generate a new binary UUID
-
toDatabase() public
Convert binary uuid data into the database format.
-
toPHP() public
Convert binary uuid into resource handles
-
toStatement() public
Get the correct PDO binding type for Binary data.
Method Detail
__construct() ¶ public
__construct(string|null $name = null)
Constructor
Parameters
-
string|null
$name optional The name identifying this type
convertBinaryUuidToString() ¶ protected
convertBinaryUuidToString(mixed $binary): string
Converts a binary uuid to a string representation
Parameters
-
mixed
$binary The value to convert.
Returns
string
convertStringToBinaryUuid() ¶ protected
convertStringToBinaryUuid(string $string): string
Converts a string UUID (36 or 32 char) to a binary representation.
Parameters
-
string
$string The value to convert.
Returns
string
getBaseType() ¶ public
getBaseType(): string|null
Returns the base type name that this class is inheriting.
This is useful when extending base type for adding extra functionality, but still want the rest of the framework to use the same assumptions it would do about the base type it inherits from.
Returns
string|null
getName() ¶ public
getName(): string|null
Returns type identifier name for this object.
Returns
string|null
marshal() ¶ public
marshal(mixed $value): mixed
Marshals flat data into PHP objects.
Most useful for converting request data into PHP objects that make sense for the rest of the ORM/Database layers.
Parameters
-
mixed
$value The value to convert.
Returns
mixed
newId() ¶ public
newId(): string
Generate a new binary UUID
This method can be used by types to create new primary key values when entities are inserted.
Returns
string
toDatabase() ¶ public
toDatabase(mixed $value, Cake\Database\DriverInterface $driver): string|resource|null
Convert binary uuid data into the database format.
Binary data is not altered before being inserted into the database. As PDO will handle reading file handles.
Parameters
-
mixed
$value The value to convert.
-
Cake\Database\DriverInterface
$driver The driver instance to convert with.
Returns
string|resource|null
toPHP() ¶ public
toPHP(mixed $value, Cake\Database\DriverInterface $driver): resource|string|null
Convert binary uuid into resource handles
Parameters
-
mixed
$value The value to convert.
-
Cake\Database\DriverInterface
$driver The driver instance to convert with.
Returns
resource|string|null
Throws
Cake\Core\Exception\Exception
toStatement() ¶ public
toStatement(mixed $value, Cake\Database\DriverInterface $driver): int
Get the correct PDO binding type for Binary data.
Parameters
-
mixed
$value The value being bound.
-
Cake\Database\DriverInterface
$driver The driver.
Returns
int