array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.oci-set-call-timout.php', 1 => 'oci_set_call_timeout', 2 => 'Define un tiempo de espera en milisegundos para las llamadas a la base de datos', ), 'up' => array ( 0 => 'ref.oci8.php', 1 => 'Funciones de 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' => 'es', '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 — Define un tiempo de espera en milisegundos para las llamadas a la base de datos

Descripción

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

Define un tiempo de espera que limita el tiempo máximo que puede tomar un intercambio de base de datos utilizando esta conexión.

Cada operación OCI8 puede realizar cero o más llamadas a la biblioteca cliente de Oracle. Estas llamadas internas pueden luego realizar cero o más intercambios con la base de datos Oracle. Si alguno de estos intercambios toma más de time_out milisegundos, entonces la operación se cancela y se devuelve un error a la aplicación.

El valor time_out se aplica a cada intercambio individualmente, y no a la suma de todos los intercambios. El tiempo pasado procesando en PHP OCI8 antes o después de la finalización de cada intercambio no se cuenta.

Cuando una llamada es interrumpida, Oracle intentará limpiar la conexión para su reutilización. Esta operación está permitida para ejecutarse durante otro período de time_out. Dependiendo del resultado de la limpieza, la conexión puede o no ser reutilizable.

Cuando se utilizan conexiones persistentes, el valor del tiempo de espera será conservado entre las consultas PHP.

La función oci_set_call_timeout() está disponible cuando OCI8 utiliza las bibliotecas clientes de Oracle 18 (o posteriores).

Parámetros

connection

Un identificador de conexión Oracle, devuelto por la función oci_connect(), oci_pconnect() o la función oci_new_connect().

timeout

El tiempo máximo en milisegundos que puede tomar un intercambio entre PHP y la base de datos Oracle.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Configuración del tiempo de espera

<?php

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

?>