From dc6fde31966914a9102fc00e7463140c39743915 Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Wed, 30 Mar 2005 02:07:56 +0000
Subject: [PATCH] A MySQL connection is required before using
 mysql_real_escape_string().

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@183132 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../mysql/functions/mysql-real-escape-string.xml      | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/reference/mysql/functions/mysql-real-escape-string.xml b/reference/mysql/functions/mysql-real-escape-string.xml
index 4348c0a648..4db3623b71 100644
--- a/reference/mysql/functions/mysql-real-escape-string.xml
+++ b/reference/mysql/functions/mysql-real-escape-string.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.20 $ -->
+<!-- $Revision: 1.21 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.100 -->
   <refentry id="function.mysql-real-escape-string">
    <refnamediv>
@@ -35,6 +35,15 @@
      <function>mysql_query</function>. If binary data is to be inserted, this function
      must be used.
     </para>
+    <note>
+     <para>
+      A MySQL connection is required before using 
+      <function>mysql_real_escape_string</function> otherwise an error of
+      level <literal>E_WARNING</literal> is generated, and &false; is 
+      returned. If <parameter>link_identifier</parameter> isn't defined, the
+      last MySQL connection is used.
+     </para>
+    </note>
     <para>
      <function>mysql_real_escape_string</function> calls MySQL's library function
      mysql_escape_string, which prepends backslashes to the following characters: