返回当前连接的线程 ID

# mysqli::$thread_id

# mysqli_thread_id

(PHP 5, PHP 7, PHP 8)

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

### 说明

面向对象风格

int $mysqli->thread_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

### 参见

- mysqli_kill() - 让服务器杀死一个 MySQL 线程

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open