Reuse MySQL connections within requests

2026-07-13 00:08:07 +00:00
parent 0ff42f357f
commit b1dfe6c807
5 changed files with 73 additions and 21 deletions
@@ -15,7 +15,7 @@ Establishes a connection to a MySQL server and returns a pointer to the connecti

 This connection handle is then used with helpers such as `mysql_query()`, `mysql_error()`, and `mysql_disconnect()`.

-MySQL handles are request-scoped framework resources. If a request exits without calling `mysql_disconnect()`, UCE closes any remaining MySQL handles during request cleanup. Call `mysql_disconnect()` when you want to close early, but never store a `MySQL*` in globals, sessions, or other state that can outlive the current request.
+MySQL handles are request-scoped framework resources. Repeated `mysql_connect()` calls with the same host and credentials reuse one server connection within the current request. Each call creates a lease; `mysql_disconnect()` releases that lease, and UCE closes the pooled server connection during request cleanup. Never store a `MySQL*` in globals, sessions, or other state that can outlive the current request.

 :example
 MySQL* db = mysql_connect();