Fix phpdoc Connection classes. (#567)

src/Connection/AbstractConnection.php

@@ -18,8 +18,8 @@
 use Yiisoft\Db\Transaction\TransactionInterface;
 
 /**
- * The AbstractConnection class represents a connection to a database. It provides methods for interacting with the
- * database, such as executing SQL queries and performing data manipulation.
+ * Represents a connection to a database. It provides methods for interacting with the database, such as executing SQL
+ * queries and performing data manipulation.
  */
 abstract class AbstractConnection implements ConnectionInterface, LoggerAwareInterface
 {
@@ -112,6 +112,8 @@ public function transaction(Closure $closure, string $isolationLevel = null): mi
      *
      * @param TransactionInterface $transaction TransactionInterface object given from {@see beginTransaction()}.
      * @param int $level TransactionInterface level just after {@see beginTransaction()} call.
+     *
+     * @throws Throwable If transaction was not rolled back.
      */
     private function rollbackTransactionOnLevel(TransactionInterface $transaction, int $level): void
     {

src/Connection/AbstractDsn.php

@@ -9,8 +9,8 @@
 use function implode;
 
 /**
- * The Dsn class is typically used to parse a DSN string, which is a string that contains all the necessary information
- * to connect to a database, such as the database driver, hostname, database name, port and options.
+ * it's typically used to parse a DSN string, which is a string that contains all the necessary information to connect
+ * to a database, such as the database driver, hostname, database name, port and options.
  *
  * It also allows you to access individual components of the DSN, such as the driver or the database name.
  */

src/Connection/AbstractDsnSocket.php

@@ -9,8 +9,8 @@
 use function implode;
 
 /**
- * The Dsn class is typically used to parse a DSN string, which is a string that contains all the necessary information
- * to connect to a database, such as the database driver, unix socket, database name, options.
+ * It's typically used to parse a DSN string, which is a string that contains all the necessary information to connect
+ * to a database, such as the database driver, unix socket, database name, options.
  *
  * It also allows you to access individual components of the DSN, such as the driver or the database name.
  */

src/Connection/ConnectionInterface.php

@@ -20,11 +20,9 @@
 use Yiisoft\Db\Schema\TableSchemaInterface;
 use Yiisoft\Db\Transaction\TransactionInterface;
 
-use function version_compare;
-
 /**
- * The ConnectionInterface provides methods for establishing a connection to a database, executing SQL statements, and
- * performing other tasks related to interacting with a database.
+ * This interface provides methods for establishing a connection to a database, executing SQL statements, and performing
+ * other tasks related to interacting with a database.
  *
  * It allows you to access and manipulate databases in a database-agnostic way, so you can write code that works with
  * different database systems without having to worry about the specific details of each one.
@@ -138,7 +136,7 @@ public function getQuoter(): QuoterInterface;
     public function getSchema(): SchemaInterface;
 
     /**
-     * Returns a server version as a string comparable by {@see version_compare()}.
+     * Returns a server version as a string comparable by {@see \version_compare()}.
      *
      * @return string The server version as a string.
      */

src/Connection/ConnectionPoolInterface.php

@@ -7,6 +7,10 @@
 use Closure;
 use Throwable;
 
+/**
+ * This interface represents a connection pool. It provides a way to get a connection from the pool. It also provides
+ * methods to set and get the master and slave connections.
+ */
 interface ConnectionPoolInterface
 {
     /**
@@ -89,8 +93,8 @@ public function setSlave(string $key, ConnectionInterface $slave): void;
      * });
      * ```
      *
-     * @param Closure $callback a PHP Closure to be executed by this method. Its signature is
-     * `function (ConnectionInterface $db)`. Its return value will be returned by this method.
+     * @param Closure $closure a PHP Closure to be executed by this method.
+     * Its signature is `function (ConnectionInterface $db)`. Its return value will be returned by this method.
      *
      * @throws Throwable If there is any exception thrown from the callback.
      *

src/Connection/DsnInterface.php

@@ -5,7 +5,7 @@
 namespace Yiisoft\Db\Connection;
 
 /**
- * DsnInterface represents a Data Source Name. It is used to configure a {@see ConnectionInterface} instance. The DSN
+ * This interface represents a Data Source Name. It is used to configure a {@see ConnectionInterface} instance. The DSN
  * string format is described in {@see asString()}.
  */
 interface DsnInterface