/**
* Get any open connection to a given server index, local or foreign
*
- * Use CONN_TRX_AUTOCOMMIT to only look for connections opened with that flag
+ * Use CONN_TRX_AUTOCOMMIT to only look for connections opened with that flag.
+ * Avoid the use of begin() or startAtomic() on any such connections.
*
* @param int $i Server index or DB_MASTER/DB_REPLICA
* @param int $flags Bitfield of CONN_* class constants
* (e.g. sqlite) in order to avoid deadlocks. ILoadBalancer::getServerAttributes()
* can be used to check such flags beforehand.
*
- * If the caller uses $domain or sets CONN_TRX_AUTOCOMMIT in $flags, then it must also
- * call ILoadBalancer::reuseConnection() on the handle when finished using it.
+ * If the caller uses $domain or sets CONN_TRX_AUTOCOMMIT in $flags, then it must
+ * also call ILoadBalancer::reuseConnection() on the handle when finished using it.
* In all other cases, this is not necessary, though not harmful either.
+ * Avoid the use of begin() or startAtomic() on any such connections.
*
* @param int $i Server index (overrides $groups) or DB_MASTER/DB_REPLICA
* @param array|string|bool $groups Query group(s), or false for the generic reader
*
* The CONN_TRX_AUTOCOMMIT flag is ignored for databases with ATTR_DB_LEVEL_LOCKING
* (e.g. sqlite) in order to avoid deadlocks. ILoadBalancer::getServerAttributes()
- * can be used to check such flags beforehand.
+ * can be used to check such flags beforehand. Avoid the use of begin() or startAtomic()
+ * on any CONN_TRX_AUTOCOMMIT connections.
*
* @see ILoadBalancer::getConnection() for parameter information
*
*
* The CONN_TRX_AUTOCOMMIT flag is ignored for databases with ATTR_DB_LEVEL_LOCKING
* (e.g. sqlite) in order to avoid deadlocks. ILoadBalancer::getServerAttributes()
- * can be used to check such flags beforehand.
+ * can be used to check such flags beforehand. Avoid the use of begin() or startAtomic()
+ * on any CONN_TRX_AUTOCOMMIT connections.
*
* @see ILoadBalancer::getConnection() for parameter information
*
*
* The CONN_TRX_AUTOCOMMIT flag is ignored for databases with ATTR_DB_LEVEL_LOCKING
* (e.g. sqlite) in order to avoid deadlocks. ILoadBalancer::getServerAttributes()
- * can be used to check such flags beforehand.
+ * can be used to check such flags beforehand. Avoid the use of begin() or startAtomic()
+ * on any CONN_TRX_AUTOCOMMIT connections.
*
* @see ILoadBalancer::getConnection() for parameter information
*
* The index must be an actual index into the array. If a connection to the server is
* already open and not considered an "in use" foreign connection, this simply returns it.
*
- * Avoid using CONN_TRX_AUTOCOMMIT for databases with ATTR_DB_LEVEL_LOCKING (e.g. sqlite) in
- * order to avoid deadlocks. ILoadBalancer::getServerAttributes() can be used to check
+ * Avoid using CONN_TRX_AUTOCOMMIT for databases with ATTR_DB_LEVEL_LOCKING (e.g. sqlite)
+ * in order to avoid deadlocks. ILoadBalancer::getServerAttributes() can be used to check
* such flags beforehand.
*
- * If the caller uses $domain or sets CONN_TRX_AUTOCOMMIT in $flags, then it must also
- * call ILoadBalancer::reuseConnection() on the handle when finished using it.
+ * If the caller uses $domain or sets CONN_TRX_AUTOCOMMIT in $flags, then it must
+ * also call ILoadBalancer::reuseConnection() on the handle when finished using it.
* In all other cases, this is not necessary, though not harmful either.
+ * Avoid the use of begin() or startAtomic() on any such connections.
*
* @note This method throws DBAccessError if ILoadBalancer::disable() was called
*
* Return the server info structure for a given index, or false if the index is invalid.
* @param int $i
* @return array|bool
+ * @since 1.31
*/
public function getServerInfo( $i );