Class BinaryType
Binary type converter.
Use to convert binary data between PHP and the database types.
Property Summary
-
$_name protected
string|null
Identifier name for this type
Method Summary
-
__construct() public
Constructor
-
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 primary key value for a given type.
-
toDatabase() public
Convert binary data into the database format.
-
toPHP() public
Convert binary 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
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(): mixed
Generate a new primary key value for a given type.
This method can be used by types to create new primary key values when entities are inserted.
Returns
mixed
toDatabase() ¶ public
toDatabase(mixed $value, Cake\Database\DriverInterface $driver): resource|string
Convert binary 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
resource|string
toPHP() ¶ public
toPHP(mixed $value, Cake\Database\DriverInterface $driver): resource|null
Convert binary into resource handles
Parameters
-
mixed
$value The value to convert.
-
Cake\Database\DriverInterface
$driver The driver instance to convert with.
Returns
resource|null
Throws
Cake\Core\Exception\CakeException
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