mysqli::kill, mysqli_kill


Description

Object oriented stylebool mysqli::kill(int processid);

Procedural stylebool mysqli_kill(mysqli link,
int processid);

This function is used to ask the server to kill a MariaDB thread specified by the processid parameter. This value must be retrieved by calling the mysqli_thread_id function.

To stop a running query you should use the SQL command KILL QUERY processid.

Parameters

link

Procedural style only: A link identifier returned by mysqli_connect or mysqli_init

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example 20.125. mysqli::kill example

Object oriented style

<?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();
}
/* determine our thread id */
$thread_id = $mysqli->thread_id;
/* Kill connection */
$mysqli->kill($thread_id);
/* This should produce an error */
if (!$mysqli->query('CREATE TABLE myCity LIKE City')) {
 printf('Error: %s\n', $mysqli->error);
 exit;
}
/* close connection */
$mysqli->close();
?>

Procedural style

<?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();
}
/* determine our thread id */
$thread_id = mysqli_thread_id($link);
/* Kill connection */
mysqli_kill($link, $thread_id);
/* This should produce an error */
if (!mysqli_query($link, 'CREATE TABLE myCity LIKE City')) {
 printf('Error: %s\n', mysqli_error($link));
 exit;
}
/* close connection */
mysqli_close($link);
?>

The above examples will output:

Error: MariaDB server has gone away

See Also

mysqli_thread_id

Retornar