Merge r1308718 from trunk:

Added a note about MySQL's reconnect option and its effects on prepared statements

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1308720 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_dbd.xml b/docs/manual/mod/mod_dbd.xml
index 3021e2988339849fb5c4bebbfdf61ccbe3776c53..74b1f4d219d6ab63bdaa24c80bcc10e2c87827bb 100644 (file)
--- a/docs/manual/mod/mod_dbd.xml
+++ b/docs/manual/mod/mod_dbd.xml
@@ -112,6 +112,14 @@ APR_DECLARE_OPTIONAL_FN(void, ap_dbd_prepare, (server_rec*, const char*, const c
     <p>It is up to dbd user modules to use the prepared statements
     and document what statements can be specified in httpd.conf,
     or to provide their own directives and use <code>ap_dbd_prepare</code>.</p>
+       
+       <note type="warning"><title>Caveat</title>
+       When using prepared statements with a MySQL database, it is preferred to set
+       <code>reconnect</code> to 0 in the connection string as to avoid errors that
+       arise from the MySQL client reconnecting without properly resetting the
+       prepared statements. If set to 1, any broken connections will be attempted
+       fixed, but as mod_dbd is not informed, the prepared statements will be invalidated.
+       </note>
 </section>
 
 <section id="security">