Jira issue originally created by user stof:
Currently, the main entry point Doctrine\DBAL\Connection is documented as a wrapper around Doctrine\DBAL\Driver\Connection.
This is very misleading and encourages other library to typehint against Doctrine\DBAL\Driver\Connection rather than Doctrine\DBAL\Connection. See symfony/symfony#10720 for the original discussion.
However, the discussion in #414 (comment) implies that they should actually not be related together (but it cannot be fixed for BC reasons). The phpdoc should at least be changed
Comment created by @guilhermeblanco:
This issue was fixed some time ago.
Commit reference: 5fdedc4
Comment created by @deeky666:
[~guilhermeblanco] How is your commit reference related to this issue?
[deeky666] The suggestion about Doctrine\DBAL\Connection and Doctrine\DBAL\Driver\Connection started around the misleading support of ping and how to consistently support it across different drivers.
The commit reference I pointed out is [beberlei]'s resolution to remove misleading phpdoc around ping support (which is also highlighted in the ticket as "phpdoc should at least be changed").
If there's anything else that is missing, I'm probably not seeing. All I've done is followed dbal's discussion. =\
Comment created by stof:
Your commit does not fix it at all. [~beberlei]'s comment was about the ping method only indeed. But he explained that Doctrine\DBAL\Connection should actually not be a Doctrine\DBAL\Driver\Connection except for legacy reasons, which is why makign it implement Doctrine\DBAL\Driver\PingableConnection was a bad idea even if it has a ping method.
My issue is related to the description of the class itself: https://github.com/doctrine/dbal/blob/aa2ed45ade6582a24e4f72f674f6989873d72112/lib/Doctrine/DBAL/Connection.php#L36
It still describes it as a wrapper around the driver connection, making other devs think that the right typehint in other libraries is the internal driver connection. See the discussion in the Symfony PR I linked
So... it's reopened. I'll look into this later today.
Comment created by @ocramius:
[~guilhermeblanco] can you re-check this?