[12.x] Add missing @throws annotations to Database Connection class #57452
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR adds missing
@throwsannotations to the Database Connection class methods that throw exceptions but were missing proper documentation.Changes Made
escape()method: Added@throws \RuntimeExceptionannotationescapeBinary()method: Added@throws \RuntimeExceptionannotationWhy This Matters
These methods throw
RuntimeExceptionwhen the PDO connection is not available, but were missing the proper@throwsannotations in their docblocks. This improvement:Implementation Details
Both methods check for PDO availability and throw
RuntimeExceptionwith descriptive messages when the connection is not available:escape(): Throws when trying to escape values without a PDO connectionescapeBinary(): Throws when trying to escape binary data without a PDO connectionTesting
No functional changes were made - only documentation improvements. The existing test suite should continue to pass without modification.