mysqli::real_escape_string
(PHP 5, PHP 7)
mysqli :: real_escape_string - mysqli_real_escape_string - 转义字符串中的特殊字符以便在SQL语句中使用，同时考虑连接的当前字符集
描述
面向对象的风格
string mysqli::escape_string ( string $escapestr )string mysqli::real_escape_string ( string $escapestr )程序风格
string mysqli_real_escape_string ( mysqli $link , string $escapestr )该函数用于创建可在SQL语句中使用的合法SQL字符串。给定的字符串编码为转义的SQL字符串，并考虑到连接的当前字符集。
警告
字符集必须设置在服务器级别，或者使用API??函数mysqli_set_charset（）来影响mysqli_real_escape_string（）。有关更多信息，请参阅字符集的概念部分。
参数
`link` 仅过程样式：由mysqli_connect（）或mysqli_init（）返回的链接标识符
escapestr
要转义的字符串。
编码的字符是NUL（ASCII 0），\ n，\ r，\，'，“和Control-Z。
返回值
返回一个转义字符串。
错误/异常
如果没有通过有效的MySQLi连接，执行此函数将返回NULL并发出E_WARNING级别错误。
例子
示例＃1 mysqli :: real_escape_string（）示例
面向对象的风格
<?php
$mysqli?=?new?mysqli("localhost",?"my_user",?"my_password",?"world");
/*?check?connection?*/
if?(mysqli_connect_errno())?{
????printf("Connect?failed:?%s\n",?mysqli_connect_error());
????exit();
}
$mysqli->query("CREATE?TEMPORARY?TABLE?myCity?LIKE?City");
$city?=?"'s?Hertogenbosch";
/*?this?query?will?fail,?cause?we?didn't?escape?$city?*/
if?(!$mysqli->query("INSERT?into?myCity?(Name)?VALUES?('$city')"))?{
????printf("Error:?%s\n",?$mysqli->sqlstate);
}
$city?=?$mysqli->real_escape_string($city);
/*?this?query?with?escaped?$city?will?work?*/
if?($mysqli->query("INSERT?into?myCity?(Name)?VALUES?('$city')"))?{
????printf("%d?Row?inserted.\n",?$mysqli->affected_rows);
}
$mysqli->close();
?>程序风格
<?php
$link?=?mysqli_connect("localhost",?"my_user",?"my_password",?"world");
/*?check?connection?*/
if?(mysqli_connect_errno())?{
????printf("Connect?failed:?%s\n",?mysqli_connect_error());
????exit();
}
mysqli_query($link,?"CREATE?TEMPORARY?TABLE?myCity?LIKE?City");
$city?=?"'s?Hertogenbosch";
/*?this?query?will?fail,?cause?we?didn't?escape?$city?*/
if?(!mysqli_query($link,?"INSERT?into?myCity?(Name)?VALUES?('$city')"))?{
????printf("Error:?%s\n",?mysqli_sqlstate($link));
}
$city?=?mysqli_real_escape_string($link,?$city);
/*?this?query?with?escaped?$city?will?work?*/
if?(mysqli_query($link,?"INSERT?into?myCity?(Name)?VALUES?('$city')"))?{
????printf("%d?Row?inserted.\n",?mysqli_affected_rows($link));
}
mysqli_close($link);
?>上面的例子会输出：
Error: 42000
1 Row inserted.注意
注意：对于习惯于使用mysql_real_escape_string（）的用户，请注意mysqli_real_escape_string（）的参数与mysql_real_escape_string（）所期望的不同。所述
link标识符至上在mysqli_real_escape_string（），而进行转义字符串至上在mysql_real_escape_string（） 。
扩展内容
- mysqli_set_charset（） - 设置默认的客户端字符集
- mysqli_character_set_name（） - 返回数据库连接的默认字符集
← mysqli::real_connect
mysqli::real_query →
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
