Class UuidType
Provides behavior for the uuid type
Property Summary
-
$_basicTypes protected static
array
List of basic type mappings, used to avoid having to instantiate a class for doing conversion on these
-
$_builtTypes protected static
array
Contains a map of type object instances to be reused if needed
-
$_name protected
string
Identifier name for this type
-
$_types protected static
array
List of supported database types. A human readable identifier is used as key and a complete namespaced class name as value representing the class that will do actual type conversions.
Method Summary
-
__construct() public
Constructor
-
_basicTypeCast() protected
Checks whether this type is a basic one and can be converted using a callback If it is, returns converted value
-
boolval() public static
Type converter for boolean values.
-
build() public static
Returns a Type object capable of converting a type identified by $name
-
clear() public static
Clears out all created instances and mapped types classes, useful for testing
-
getBaseType() public
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.
-
getName() public
Returns type identifier name for this object
-
map() public static
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
-
marshal() public
Marshalls request data into a PHP string
-
newId() public
Generate a new UUID
-
set() public static
Returns a Type object capable of converting a type identified by $name
-
strval() public static
Type converter for string values.
-
toDatabase() public
Casts given value from a PHP type to one acceptable by database
-
toPHP() public
Casts given value from a database type to PHP equivalent
-
toStatement() public
Casts give value to Statement equivalent
Method Detail
__construct() ¶ public
__construct(string $name = null)
Constructor
Parameters
-
string
$name optional The name identifying this type
_basicTypeCast() ¶ protected
_basicTypeCast(mixed $value): mixed
Checks whether this type is a basic one and can be converted using a callback If it is, returns converted value
Parameters
-
mixed
$value value to be converted to PHP equivalent
Returns
mixed
boolval() ¶ public static
boolval(mixed $value): bool
Type converter for boolean values.
Will convert string true/false into booleans.
Parameters
-
mixed
$value The value to convert to a boolean.
Returns
bool
build() ¶ public static
build(string $name): Type
Returns a Type object capable of converting a type identified by $name
Parameters
-
string
$name type identifier
Returns
Type
Throws
InvalidArgumentException
If type identifier is unknown
clear() ¶ public static
clear(): void
Clears out all created instances and mapped types classes, useful for testing
Returns
void
getBaseType() ¶ public
getBaseType(): string
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
map() ¶ public static
map(string|array|null $type = null, string|null $className = null): array|string|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
Parameters
-
string|array|null
$type optional if string name of type to map, if array list of arrays to be mapped
-
string|null
$className optional The classname to register.
Returns
array|string|null
marshal() ¶ public
marshal(mixed $value): string|null
Marshalls request data into a PHP string
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
string|null
newId() ¶ public
newId(): string
Generate a new UUID
This method can be used by types to create new primary key values when entities are inserted.
Returns
string
set() ¶ public static
set(string $name, Cake\Database\Type $instance): void
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.
Returns
void
strval() ¶ public static
strval(mixed $value): bool
Type converter for string values.
Will convert values into strings
Parameters
-
mixed
$value The value to convert to a string.
Returns
bool
toDatabase() ¶ public
toDatabase(mixed $value, Driver $driver): mixed
Casts given value from a PHP type to one acceptable by database
Parameters
-
mixed
$value value to be converted to database equivalent
-
Driver
$driver object from which database preferences and configuration will be extracted
Returns
mixed
toPHP() ¶ public
toPHP(mixed $value, Driver $driver): mixed
Casts given value from a database type to PHP equivalent
Parameters
-
mixed
$value value to be converted to PHP equivalent
-
Driver
$driver object from which database preferences and configuration will be extracted
Returns
mixed
toStatement() ¶ public
toStatement(mixed $value, Driver $driver): mixed
Casts give value to Statement equivalent
Parameters
-
mixed
$value value to be converted to PHP equivalent
-
Driver
$driver object from which database preferences and configuration will be extracted
Returns
mixed
Property Detail
$_basicTypes ¶ protected static
List of basic type mappings, used to avoid having to instantiate a class for doing conversion on these
Type
array
$_builtTypes ¶ protected static
Contains a map of type object instances to be reused if needed
Type
array
$_types ¶ protected static
List of supported database types. A human readable identifier is used as key and a complete namespaced class name as value representing the class that will do actual type conversions.
Type
array