(PHP 5, PHP 7, PHP 8)
mysqli::kill -- mysqli_kill — Demande au serveur de terminer un thread MySQL
Description
Style orienté objet
public
mysqli::kill(int
$process_id
): bool
mysqli_kill(mysqli
$mysql
, int
$process_id
): bool
Pour arrêter une requête en cours d'exécution, utilisez la commande SQL
KILL QUERY process_id
.
Liste de paramètres
-
mysql
-
Seulement en style procédural : Un objet mysqli
retourné par la fonction mysqli_connect() ou par la
fonction mysqli_init().
Valeurs de retour
Cette fonction retourne true
en cas de succès ou false
si une erreur survient.
Erreurs / Exceptions
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.
Exemples
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
Voir aussi
- mysqli_thread_id() - Retourne l'identifiant du thread pour la connexion courante