Class BinaryUuidType
Binary UUID type converter.
Use to convert binary uuid data between PHP and the database types.
- Cake\Database\Type implements Cake\Database\TypeInterface
- Cake\Database\Type\BinaryUuidType implements Cake\Database\TypeInterface
Properties summary
-
$_name
protectedstring|null
Identifier name for this type.
Inherited Properties
Method Summary
-
__construct() public
Constructor. -
convertBinaryUuidToString() protected
Converts a binary uuid to a string representation -
convertStringToBinaryUuid() protected
Converts a string uuid to a binary representation -
marshal() public
Marshalls 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.
(This method is declared here again so that the inheritance from Cake\Database\Type can be removed in the future.)
Parameters
- string|null $name optional null
- The name identifying this type
Overrides
convertBinaryUuidToString() protected ¶
convertBinaryUuidToString( mixed $binary )
Converts a binary uuid to a string representation
Parameters
- mixed $binary
- The value to convert.
Returns
Converted value.
convertStringToBinaryUuid() protected ¶
convertStringToBinaryUuid( mixed $string )
Converts a string uuid to a binary representation
Parameters
- mixed $string
- The value to convert.
Returns
Converted value.
marshal() public ¶
marshal( mixed $value )
Marshalls 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
Converted value.
Overrides
Implementation of
newId() public ¶
newId( )
Generate a new binary UUID
Returns
A new primary key value.
Overrides
Implementation of
toDatabase() public ¶
toDatabase( string|resource $value , Cake\Database\Driver
$driver )
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
- string|resource $value
- The value to convert.
-
Cake\Database\Driver
$driver - The driver instance to convert with.
Returns
Overrides
Implementation of
toPHP() public ¶
toPHP( null|string|resource $value , Cake\Database\Driver
$driver )
Convert binary uuid into resource handles
Parameters
- null|string|resource $value
- The value to convert.
-
Cake\Database\Driver
$driver - The driver instance to convert with.
Returns
Throws
Overrides
Implementation of
toStatement() public ¶
toStatement( mixed $value , Cake\Database\Driver
$driver )
Get the correct PDO binding type for Binary data.
Parameters
- mixed $value
- The value being bound.
-
Cake\Database\Driver
$driver - The driver.
Returns
Overrides
Implementation of
Methods inherited from Cake\Database\Type
__debugInfo() public ¶
__debugInfo( )
Returns an array that can be used to describe the internal state of this object.
Returns
_basicTypeCast() protected ¶
_basicTypeCast( mixed $value )
Checks whether this type is a basic one and can be converted using a callback If it is, returns converted value
Deprecated
Parameters
- mixed $value
- Value to be converted to PHP equivalent
Returns
boolval() public static ¶
boolval( mixed $value )
Type converter for boolean values.
Will convert string true/false into booleans.
Deprecated
Parameters
- mixed $value
- The value to convert to a boolean.
Returns
build() public static ¶
build( string $name )
Returns a Type object capable of converting a type identified by name.
Parameters
- string $name
- type identifier
Returns
Throws
If type identifier is unknown
buildAll() public static ¶
buildAll( )
Returns an arrays with all the mapped type objects, indexed by name.
Returns
clear() public static ¶
clear( )
Clears out all created instances and mapped types classes, useful for testing
getBaseType() public ¶
getBaseType( )
Returns the base type name that this class is inheriting.
Returns
The base type name that this class is inheriting.
Implementation of
getMap() public static ¶
getMap( string|null $type null )
Get mapped class name or instance for type(s).
Parameters
- string|null $type optional null
- Type name to get mapped class for or null to get map array.
Returns
Cake\Database\TypeInterface
|nullConfigured class name or instance for give $type or map array.
Since
getName() public ¶
getName( )
Returns type identifier name for this object.
Returns
The type identifier name for this object.
Implementation of
map() public static ¶
map( string|string[]|Cake\Database\Type[]
|null $type null , string|Cake\Database\Type
|null $className null )
Registers a new type identifier and maps it to a fully namespaced classname, If called with no arguments it will return current types map array If $className is omitted it will return mapped class for $type
Deprecated 3.6.2: - The usage of $type as string[]|\Cake\Database\Type[] is deprecated. Use Type::setMap() with string[] instead. - Passing $className as \Cake\Database\Type instance is deprecated, use class name string only. - Using this method as getter is deprecated. Use Type::getMap() instead.
Parameters
-
string|string[]|
Cake\Database\Type[]
|null $type optional null - If string name of type to map, if array list of arrays to be mapped
-
string|
Cake\Database\Type
|null $className optional null - The classname or object instance of it to register.
Returns
If $type is null then array with current map, if $className is null string configured class name for give $type, null otherwise
set() public static ¶
set( string $name , Cake\Database\Type
$instance )
Returns a Type object capable of converting a type identified by $name
Parameters
- string $name
- The type identifier you want to set.
-
Cake\Database\Type
$instance - The type instance you want to set.