(PHP 5, PHP 7, PHP 8)
mysqli::kill -- mysqli_kill — Demande au serveur de terminer un thread MySQL
Cette fonction est OBSOLÈTE à partir de PHP 8.4.0. Il est fortement déconseillé de s'appuyer sur cette fonction.
Style orienté objet
Style procédural
mysqli_kill() est utilisée pour demander au serveur de
terminer un thread MySQL spécifié par le paramètre
process_id
. Cette valeur doit être obtenue en
appelant la fonction mysqli_thread_id().
Pour arrêter une requête en cours d'exécution, utilisez la commande SQL
KILL QUERY process_id
.
mysql
Seulement en style procédural : Un objet mysqli retourné par la fonction mysqli_connect() ou mysqli_init().
Si le rapport d'erreurs mysqli est activé (MYSQLI_REPORT_ERROR
) et que l'opération demandée échoue,
un avertissement est généré. Si, en plus, le mode est défini sur MYSQLI_REPORT_STRICT
,
une mysqli_sql_exception est lancée à la place.
Version | Description |
---|---|
8.4.0 |
Les méthodes mysqli::kill() et
mysqli_kill() sont désormais obsolètes. Utilisez
plutôt la commande SQL KILL .
|
Exemple #1 Exemple avec mysqli::kill()
Style orienté objet
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
/* Détermine l'id du thread */
$thread_id = $mysqli->thread_id;
/* Termine le thread */
$mysqli->kill($thread_id);
/* Ceci devrait produire une erreur */
if (!$mysqli->query("CREATE TABLE myCity LIKE City")) {
printf("Erreur : %s\n", $mysqli->error);
exit;
}
/* Fermeture de la connexion */
$mysqli->close();
?>
Style procédural
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
/* Détermine l'id du thread */
$thread_id = mysqli_thread_id($link);
/* Termine le thread */
mysqli_kill($link, $thread_id);
/* Ceci devrait produire une erreur */
if (!mysqli_query($link, "CREATE TABLE myCity LIKE City")) {
printf("Erreur : %s\n", mysqli_error($link));
exit;
}
/* Fermeture de la connexion */
mysqli_close($link);
?>
Les exemples ci-dessus vont afficher :
Erreur : MySQL server has gone away