Sets a millisecond timeout for database calls

# 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 — Sets a millisecond timeout for database calls

### Descrição

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

Define um tempo limite máximo que uma viagem de ida e volta ao banco de dados usando esta conexão pode levar.

Cada operação OCI8 pode fazer zero ou mais chamadas à biblioteca cliente da Oracle. Essas chamadas internas podem, então, fazer zero ou mais viagens de ida e volta ao banco de dados Oracle. Se qualquer uma dessas viagens de ida e volta levar mais de `time_out` milissegundos, a operação será cancelada e um erro será retornado ao aplicativo.

O valor `time_out` se aplica a cada viagem de ida e volta individualmente, não à soma de todas as viagens de ida e volta. O tempo gasto no processamento em PHP OCI8 antes ou depois da conclusão de cada viagem de ida e volta não é contabilizado.

Quando uma chamada é interrompida, a Oracle tentará limpar a conexão para reutilização. Esta operação pode ser executada por outro período de `time_out`. Dependendo do resultado da limpeza, a conexão pode ou não ser reutilizável.

Quando conexões persistentes são usadas, o valor de tempo limite será mantido em todas as solicitações PHP.

A função oci_set_call_timeout() está disponível quando o OCI8 usa bibliotecas de cliente Oracle 18 (ou posterior).

### Parâmetros

`connection`
  Um identificador de conexão Oracle, retornado por oci_connect(), oci_pconnect() ou oci_new_connect().
`timeout`

  O tempo máximo em milissegundos que qualquer viagem de ida e volta entre PHP e Oracle Database pode levar.

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

### Exemplos

Exemplo #1 Definindo o tempo limite

    <?php

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

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open