Interface ConnectionInterface
This interface defines the methods you can depend on in a connection.
Method Summary
-
config() public
Get the configuration data used to create the connection.
-
configName() public
Get the configuration name for this connection.
-
disableConstraints() public
Run an operation with constraints disabled.
-
execute() public @method
-
getLogger() public @method
Get the current logger instance
-
logQueries() public
Enables or disables query logging for this connection.
-
logger() public deprecated
Sets the logger object instance. When called with no arguments it returns the currently setup logger instance.
-
newQuery() public @method
-
prepare() public @method
-
quote() public @method
-
schemaCollection() public @method
-
setLogger() public @method
Set the current logger.
-
supportsDynamicConstraints() public @method
-
transactional() public
Executes a callable function inside a transaction, if any exception occurs while executing the passed callable, the transaction will be rolled back If the result of the callable function is
false, the transaction will also be rolled back. Otherwise the transaction is committed after executing the callback.
Method Detail
config() ¶ public
config(): arrayGet the configuration data used to create the connection.
Returns
arrayconfigName() ¶ public
configName(): stringGet the configuration name for this connection.
Returns
stringdisableConstraints() ¶ public
disableConstraints(callable $operation): mixedRun an operation with constraints disabled.
Constraints should be re-enabled after the callback succeeds/fails.
Parameters
-
callable$operation The callback to execute within a transaction.
Returns
mixedThrows
ExceptionWill re-throw any exception raised in $callback after rolling back the transaction.
execute() ¶ public @method
execute(mixed $query, mixed $params = [], array $types = []): Cake\Database\StatementInterfaceParameters
-
$query -
$params optional -
array$types optional
Returns
Cake\Database\StatementInterfacelogQueries() ¶ public
logQueries(bool|null $enable = null): boolEnables or disables query logging for this connection.
Parameters
-
bool|null$enable optional whether to turn logging on or disable it. Use null to read current value.
Returns
boollogger() ¶ public
logger(object|null $instance = null): objectSets the logger object instance. When called with no arguments it returns the currently setup logger instance.
Parameters
-
object|null$instance optional logger object instance
Returns
objectprepare() ¶ public @method
prepare(mixed $sql): Cake\Database\StatementInterfaceParameters
-
$sql
Returns
Cake\Database\StatementInterfacequote() ¶ public @method
quote(mixed $value, mixed $type = null): stringParameters
-
$value -
$type optional
Returns
stringschemaCollection() ¶ public @method
schemaCollection(): Cake\Database\Schema\CollectionReturns
Cake\Database\Schema\CollectionsetLogger() ¶ public @method
setLogger(mixed $logger): $thisSet the current logger.
Parameters
-
$logger
Returns
$thistransactional() ¶ public
transactional(callable $transaction): mixedExecutes a callable function inside a transaction, if any exception occurs
while executing the passed callable, the transaction will be rolled back
If the result of the callable function is false, the transaction will
also be rolled back. Otherwise the transaction is committed after executing
the callback.
The callback will receive the connection instance as its first argument.
Parameters
-
callable$transaction The callback to execute within a transaction.
Returns
mixedThrows
ExceptionWill re-throw any exception raised in $callback after rolling back the transaction.