Class StringType
String type converter.
Use to convert string data between PHP and the database types.
- Cake\Database\Type implements Cake\Database\TypeInterface
- Cake\Database\Type\StringType implements Cake\Database\Type\OptionalConvertInterface, Cake\Database\TypeInterface
Direct Subclasses
Inherited Properties
Method Summary
-
marshal() public
Marshalls request data into PHP strings. -
requiresToPhpCast() public
Returns whether the cast to PHP is required to be invoked, since it is not a identity function.
-
toDatabase() public
Convert string data into the database format. -
toPHP() public
Convert string values to PHP strings. -
toStatement() public
Get the correct PDO binding type for string data.
Method Detail
marshal() public ¶
marshal( mixed $value )
Marshalls request data into PHP strings.
Parameters
- mixed $value
- The value to convert.
Returns
Converted value.
Overrides
Implementation of
requiresToPhpCast() public ¶
requiresToPhpCast( )
Returns whether the cast to PHP is required to be invoked, since it is not a identity function.
Returns
False as database results are returned already as strings
Implementation of
toDatabase() public ¶
toDatabase( mixed $value , Cake\Database\Driver
$driver )
Convert string data into the database format.
Parameters
- mixed $value
- The value to convert.
-
Cake\Database\Driver
$driver - The driver instance to convert with.
Returns
Overrides
Implementation of
toPHP() public ¶
toPHP( mixed $value , Cake\Database\Driver
$driver )
Convert string values to PHP strings.
Parameters
- mixed $value
- The value to convert.
-
Cake\Database\Driver
$driver - The driver instance to convert with.
Returns
Overrides
Implementation of
toStatement() public ¶
toStatement( mixed $value , Cake\Database\Driver
$driver )
Get the correct PDO binding type for string data.
Parameters
- mixed $value
- The value being bound.
-
Cake\Database\Driver
$driver - The driver.
Returns
Overrides
Implementation of
Methods inherited from Cake\Database\Type
__construct() public ¶
__construct( string|null $name null )
Constructor
Parameters
- string|null $name optional null
- The name identifying this 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
newId() public ¶
newId( )
Generate a new primary key value for a given type.
Returns
A new primary key value.
Implementation of
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.