Introduce Statement::executeQuery and Statement::executeStatement.

[beberlei]

Feature Request

Q	A
New Feature	yes
RFC	no
BC Break	no
Refs	#4580

Summary

To differentiate between select and manipulation queries, the Statement should differentiate using two methods executeQuery() which returns a Result and executeStatement which returns the number of affected rows.

This was tackled in #4580 as a way to ensure forwards compatibility with the 3.x branch, but it also improves the API in the process.

In turn Statement::execute is also deprecated and gets removed in DBAL 4.0. You must replace the following code:

// old code
$sql = 'SELECT * FROM user';
$result = $connection->prepare($sql)->execute();

// new code
$sql = 'SELECT * FROM user';
$result = $connection->prepare($sql)->executeQuery();

and for manipulation or DDL statements:

// old code
$sql = 'UPDATE user SET disabled = 1';
$result = $connection->prepare($sql)->execute();

// new code
$sql = 'UPDATE user SET disabled = 1';
$result = $connection->prepare($sql)->executeStatement();

[beberlei]

Fixed by upmerging #4580 in #4606

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.