diff --git a/reference/oci8/functions/oci-bind-by-name.xml b/reference/oci8/functions/oci-bind-by-name.xml
index 89ffe60ecc..3ec4c130db 100644
--- a/reference/oci8/functions/oci-bind-by-name.xml
+++ b/reference/oci8/functions/oci-bind-by-name.xml
@@ -785,6 +785,35 @@ print '</table>';
     succeed.
    </para>
   </note>
+  <note>
+   <para>
+     The PHP <parameter>variable</parameter> argument is a reference.  Some
+     forms of loops do not work as expected:
+   </para>
+   <informalexample>
+     <programlisting role="php">
+<![CDATA[
+foreach ($myarray as $key => $value)  {
+    oci_bind_by_name($stid, $key, $value);
+}
+]]>
+     </programlisting>
+   </informalexample>
+   <para>
+     This binds each key to the location of $value, so all bound
+     variables end up pointing to the last loop iteration's
+     value. Instead use the following:
+   </para>
+   <informalexample>
+     <programlisting role="php">
+<![CDATA[
+foreach ($myarray as $key => $value) {
+    oci_bind_by_name($stid, $key, $myarray[$key]);
+}
+]]>
+     </programlisting>
+   </informalexample>
+  </note>
   <note>
    <para>
     In PHP versions before 5.0.0 you must