diff --git a/reference/mysqli/mysqli/real-escape-string.xml b/reference/mysqli/mysqli/real-escape-string.xml
index 6e7e47e8f0..909df41c95 100644
--- a/reference/mysqli/mysqli/real-escape-string.xml
+++ b/reference/mysqli/mysqli/real-escape-string.xml
@@ -68,6 +68,14 @@
    Returns an escaped string.
   </para>
  </refsect1>
+ 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Executing this function without a valid MySQLi connection passed in will
+   return &null; and emit <constant>E_WARNING</constant> level errors.
+  </para>
+ </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;