array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.oci-set-call-timout.php', 1 => 'oci_set_call_timeout', 2 => 'Définit un délai d\'attente en millisecondes pour les appels de base de données', ), 'up' => array ( 0 => 'ref.oci8.php', 1 => 'Fonctions OCI8', ), 'prev' => array ( 0 => 'function.oci-set-action.php', 1 => 'oci_set_action', ), 'next' => array ( 0 => 'function.oci-set-client-identifier.php', 1 => 'oci_set_client_identifier', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/oci8/functions/oci-set-call-timeout.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

oci_set_call_timeout

(PHP 7.2 >= 7.2.14, PHP 8, PHP 7 >= 7.3.1, PHP 8, PECL OCI8 >= 2.2.0)

oci_set_call_timeout — Définit un délai d'attente en millisecondes pour les appels de base de données

Description

oci_set_call_timeout(resource $connection, int $timeout): bool

Définit un délai d'attente limitant le temps maximum qu'un aller-retour de base de données utilisant cette connexion peut prendre.

Chaque opération OCI8 peut effectuer zéro ou plusieurs appels à la bibliothèque cliente d'Oracle. Ces appels internes peuvent ensuite effectuer zéro ou plusieurs aller-retours vers la base de données Oracle. Si l'un de ces aller-retours prend plus de time_out millisecondes, alors l'opération est annulée et une erreur est renvoyée à l'application.

La valeur time_out s'applique à chaque aller-retour individuellement, et non à la somme de tous les aller-retours. Le temps passé à traiter en PHP OCI8 avant ou après l'achèvement de chaque aller-retour n'est pas compté.

Lorsqu'un appel est interrompu, Oracle tentera de nettoyer la connexion pour la réutiliser. Cette opération est autorisée à s'exécuter pendant une autre période de time_out. En fonction du résultat du nettoyage, la connexion peut ou non être réutilisable.

Lorsque des connexions persistantes sont utilisées, la valeur de délai d'attente sera conservée entre les requêtes PHP.

La fonction oci_set_call_timeout() est disponible lorsque OCI8 utilise les bibliothèques clientes Oracle 18 (ou ultérieures).

Liste de paramètres

connection

Un identifiant de connexion Oracle, retourné par la fonction oci_connect(), oci_pconnect() ou la fonction oci_new_connect().

timeout

Le temps maximum en millisecondes qu'un aller-retour entre PHP et la base de données Oracle peut prendre.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Mise en place du délai d'attente

<?php

$conn = oci_connect('hr', 'welcome', 'localhost/XE');
oci_set_call_timeout($conn, 5000);

?>