PHP 8.6 新增 mysqli_quote_string:real_escape_string 在双引号 + NO_BACKSLASH_ESCAPES 下仍可注入
- 状态:Implemented,已合并,目标 PHP 8.6
- 投票:15 赞成 / 2 反对 / 4 弃权(88%),2026-03-08 关闭
- 作者:Kamil Tekiela
- RFC:https://wiki.php.net/rfc/mysqli_quote_string
- 实现 PR:https://github.com/php/php-src/pull/20729
为什么加这个函数
mysqli::real_escape_string() 只做转义,不补引号。它唯一正确的用法,是调用方自己在外面包一对引号——单引号或双引号。现实中 100% 的有效调用都长这样,得靠 sprintf 手动拼:
$sql = sprintf("SELECT '%s'", $mysqli->real_escape_string($value));
$sql = sprintf('SELECT "%s"', $mysqli->real_escape_string($value));
函数名又长又绕,漏掉引号或者引号包错位置,就是一个致命注入。这个 RFC 把 PDO 已有的 PDO::quote() 搬到 mysqli:先按 real_escape_string 的方式转义,再把结果包进单引号,调用方不用再操心引号。
"'Don\\'t!'" === $link->quote_string("Don't!");
签名:
public function quote_string(string $string): string {}
// AND
function mysqli_quote_string(mysqli $mysql, string $string): string {}
双引号下的注入实测
real_escape_string 不知道调用方用的是单引号还是双引号。连接上开了 NO_BACKSLASH_ESCAPES 之后,它只转义单引号,双引号包住的字符串就能被提前闭合。
当前 PHP 下这段代码会注入:
$mysqli->query('CREATE TABLE IF NOT EXISTS foo (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(255))');
$mysqli->query('INSERT INTO foo (name) VALUES ("normal")');
$mysqli->query('SET SQL_MODE="NO_BACKSLASH_ESCAPES"');
$value = '" OR 1=1 -- foo';
$sql = sprintf('SELECT id FROM foo WHERE name="%s"', $mysqli->real_escape_string($value));
$result = $mysqli->query($sql);
var_dump($result->fetch_column()); // string(1) "1"
real_escape_string 原样放回了 " OR 1=1 -- foo,双引号闭合了外层的 name="...",OR 1=1 生效,返回 string(1) "1"。
换成新函数:
$mysqli->query('CREATE TABLE IF NOT EXISTS foo (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(255))');
$mysqli->query('INSERT INTO foo (name) VALUES ("normal")');
$mysqli->query('SET SQL_MODE="NO_BACKSLASH_ESCAPES"');
$value = '" OR 1=1 -- foo';
$sql = sprintf('SELECT id FROM foo WHERE name=%s', $mysqli->quote_string($value));
$result = $mysqli->query($sql);
var_dump($result->fetch_column()); // bool(false)
quote_string 把结果包进单引号," 落在字符串内部不再有语法意义,查询不到行,返回 bool(false)。
为什么只给单引号
MySQL 修这个漏洞的方式是新增 mysql_real_escape_string_quote,多带一个参数让调用方指定引号字符,函数再在字符串里把该字符双写。PDO 没有走这条路:PDO::quote() 不接受引号字符参数,永远用单引号,所以它天然没有这个洞。
这个 RFC 跟 PDO,不跟 MySQL。双引号本身就是非标准 SQL。新函数固定单引号包裹,调用方没有选择,也就没有选错的机会。删掉选择,就删掉 bug。
转义字符集合
普通模式下编码的字符是:NUL(ASCII 0)、\n、\r、\、'、"、CTRL+Z。
连接上启用了 NO_BACKSLASH_ESCAPES 时,只编码 ',方式是双写。
名字里为什么带 string
quote_string 只处理字符串。非严格模式下,PHP 会把 int/float 强制转成 string 参数,RFC 把这视为编程错误。名字里的 string 是提醒:传整数就先用 (int) 强转,或者直接走参数绑定。
手册里的行为
mysqli::quote_string(PHP 8 >= 8.6.0):生成可用于 SQL 语句的合法字符串字面量。转义方式与 mysqli::real_escape_string() 相同,会考虑连接的当前字符集,结果用单引号包裹。返回值必须原样插入查询,不要再在外面加引号。与 real_escape_string 不同,连接开启 NO_BACKSLASH_ESCAPES 时结果同样安全。字符集必须在服务器级设置,或者用 mysqli_set_charset() 设置,才会影响 quote_string。
注意:引号只适用于字符串字面量,不能保护表名、列名这类标识符。能用预处理语句就用预处理语句。
示例:
$city = "'s-Hertogenbosch";
$query = sprintf("SELECT CountryCode FROM City WHERE name=%s", $mysqli->quote_string($city));
返回 1 行。同样的值不转义、直接拼进去,会抛 mysqli_sql_exception 语法错误。
mysqli.real_escape_string 的手册页现在补了一段:本函数不给结果加引号,必须由调用方添加。连接开启 NO_BACKSLASH_ESCAPES 时只转义单引号,放在双引号之间的值可以终止字符串并造成 SQL 注入。优先用预处理语句;做不到就用 mysqli::quote_string(),它始终把结果包在单引号里。
向后不兼容
无。
迁移陷阱
真正麻烦的地方在不弃用 real_escape_string 的前提下做迁移。两种手误方向相反:
- 删了引号,忘了把函数换掉 → 上线即注入。
- 换了函数,忘了删引号 → 语法错误。
后者是安全方向上的失败,至少不会静默放行。
迁移清单:
- 搜出每一处
real_escape_string/mysqli_real_escape_string调用。 - 一次只改一处,删外围引号和换函数在同一次编辑里完成。
- 用含单引号的值和含双引号的值各测一遍。
- 检查框架里那些只转义、不加引号的 wrapper。
- 不要做盲目的正则替换。
PHPUnit 断言:
public function testQuoteStringHandlesHostileInput(): void
{
$hostile = '" OR 1=1 -- ';
$this->db->query('SET SQL_MODE="NO_BACKSLASH_ESCAPES"');
$sql = sprintf('SELECT COUNT(*) FROM sessions WHERE speaker = %s', $this->db->quote_string($hostile));
$this->assertSame('0', (string) $this->db->query($sql)->fetch_column());
}
未来范围
理想情况下,mysqli::real_escape_string 应该在本 RFC 落地后的下一个次版本里弃用。这不在本 RFC 范围内,时间也没定。8.6 不会弃用。
限制
quote_string 不能用于标识符:表名、列名、ORDER BY 字段都不行。查询构造能走预处理语句的,仍然优先预处理。