大网数据广告活动
PHP 语言与运行手册

mysqli::$thread_id · 返回当前连接的线程 ID

· 52CE 我爱测

mysqli::$thread_id -- mysqli_thread_id — 返回当前连接的线程 ID

mysqli::$thread_id

mysqli_thread_id

(PHP 5, PHP 7, PHP 8)

mysqli::$thread_id -- mysqli_thread_id — 返回当前连接的线程 ID

说明

面向对象风格

过程化风格

function mysqli_thread_id(mysqli $mysql): int

mysqli_thread_id() 函数返回当前连接的线程 ID,然后可以使用 mysqli_kill() 函数将其终止。如果连接中断且使用 mysqli_ping() 重新连接,线程 ID 会不同。所以,仅在需要时获取线程 ID。

注意:

线程 ID 是连接的基础上分配的。因此,如果连接断开然后重新建立,将分配新的线程 ID。

要终止正在查询的命令,可以使用 SQL 命令 KILL QUERY processid。

参数

mysql

仅以过程化样式:由 mysqli_connect() 或 mysqli_init() 返回的 mysqli 对象。

返回值

返回当前连接的线程 ID。

示例

示例 #1 $mysqli->thread_id 示例

面向对象风格

<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* 检查连接 */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* 确定线程 ID */
$thread_id = $mysqli->thread_id;

/* 杀掉连接 */
$mysqli->kill($thread_id);

/* 这句代码应该会报错 */
if (!$mysqli->query("CREATE TABLE myCity LIKE City")) {
    printf("Error: %s\n", $mysqli->error);
    exit;
}

/* 关闭连接 */
$mysqli->close();
?>

过程化风格

<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* 检查连接 */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* 确定线程 ID */
$thread_id = mysqli_thread_id($link);

/* 杀掉连接 */
mysqli_kill($link, $thread_id);

/* 这句代码应该会报错 */
if (!mysqli_query($link, "CREATE TABLE myCity LIKE City")) {
    printf("Error: %s\n", mysqli_error($link));
    exit;
}

/* close connection */
mysqli_close($link);
?>

以上示例会输出:

Error: MySQL server has gone away

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。