SQLite3::busyTimeout
(PHP 5 >= 5.3.3, PHP 7, PHP 8)
SQLite3::busyTimeout — Définit le gestionnaire d'attente de la connexion
Description
public function SQLite3::busyTimeout(
int $milliseconds):
bool
Le gestionnaire d'attente est intégré à SQLite, aucune fonction de rappel
n'a donc besoin d'être fournie. Lorsqu'une requête trouve la base de données
verrouillée par une autre connexion, SQLite réessaie pendant
milliseconds millisecondes au maximum. Si la base de
données est toujours verrouillée au terme de ce délai, la requête échoue
avec l'erreur database is locked
(SQLITE_BUSY).
La manière dont cet échec se manifeste dépend de
SQLite3::enableExceptions(). Lorsque les exceptions
sont activées, une exception SQLite3Exception
est lancée. Sinon, une E_WARNING est émise et la
méthode qui a exécuté la requête, comme
SQLite3::exec() ou
SQLite3::query(), retourne false.
Par défaut, aucun gestionnaire d'attente n'est défini : une requête échoue
donc immédiatement si la base de données est verrouillée.
Liste de paramètres
milliseconds-
Le nombre maximal de millisecondes à attendre un verrou. Le fait de
définir cette valeur à une valeur inférieure ou égale à zéro désactivera
un gestionnaire d'attente précédemment défini.
Valeurs de retour
Retourne true si le délai d'attente a été défini, ou false si une erreur survient.
La valeur de retour indique seulement si le délai a été défini. Elle ne
signifie pas que les requêtes suivantes obtiendront le verrou à temps.
