array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.oci-register-taf-callback.php', 1 => 'oci_register_taf_callback', 2 => 'Registra uma função de retorno definida pelo usuário para o TAF do Oracle Database', ), 'up' => array ( 0 => 'ref.oci8.php', 1 => 'Funções OCI8', ), 'prev' => array ( 0 => 'function.oci-pconnect.php', 1 => 'oci_pconnect', ), 'next' => array ( 0 => 'function.oci-result.php', 1 => 'oci_result', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/oci8/functions/oci-register-taf-callback.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

oci_register_taf_callback

(PHP 7.0 >= 7.0.21, PHP 8, PHP 7 >= 7.1.7, PHP 8, PECL OCI8 >= 2.1.7)

oci_register_taf_callback — Registra uma função de retorno definida pelo usuário para o TAF do Oracle Database

Descrição

oci_register_taf_callback(resource $connection, ?callable $callback): bool

Registra uma função de retorno definida pelo usuário para a conexão connection. Se a conexão de connection falhar devido a uma falha de instância ou de rede, a função de retorno registrada será invocada várias vezes durante o failover. Consulte Suporte para Failover Transparente de Aplicativos (TAF) OCI8 para obter informações.

Quando oci_register_taf_callback() é chamada várias vezes, cada registro substitui o anterior.

Use oci_unregister_taf_callback() para cancelar explicitamente o registro de uma função de retorno definida pelo usuário.

O registro de função de retorno do TAF NÃO será salvo em conexões persistentes, portanto, a função de retorno precisa ser registrada novamente para uma nova conexão persistente.

Parâmetros

connection

Um identificador de conexão Oracle.

callback

Uma função de retorno definida pelo usuário para registro no Oracle TAF. Pode ser uma string com o nome da função ou um Closure (função anônima).

A interface de uma função de retorno definida pelo usuário do TAF é a seguinte:

userCallbackFn(resource $connection, int $event, int $type): int

Veja a descrição do parâmetro e um exemplo na página Suporte ao Failover Transparente de Aplicativos (TAF) do OCI8.

Valor Retornado

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

Veja Também