编程 PHP 8.6 新增 mysqli_quote_string:real_escape_string 在双引号 + NO_BACKSLASH_ESCAPES 下仍可注入

2026-11-16 20:02:48

PHP 8.6 新增 mysqli_quote_string:real_escape_string 在双引号 + NO_BACKSLASH_ESCAPES 下仍可注入

为什么加这个函数

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 字段都不行。查询构造能走预处理语句的,仍然优先预处理。

复制全文 生成海报 PHP MySQL 安全 注入 RFC SLA

推荐文章

程序员茄子在线接单