oci_register_taf_callback()
(PHP 7.0 >= 7.0.21, PHP 7 >= 7.1.7, PECL OCI8 >= 2.1.7)
Register a user-defined callback function for Oracle Database TAF
说明
oci_register_taf_callback(resource $connection[,mixed $callbackFn]): bool
Registers a user-defined callback function to$connection. If$connectionfails due to instance or network failure, the registered callback function will be invoked for several times during failover. See OCI8 Transparent Application Failover(TAF)Support for information.
When oci_register_taf_callback() is called multiple times, each registration overwrites the previous one.
Use oci_unregister_taf_callback() to explicitly unregister a user-defined callback.
TAF callback registration will NOT be saved across persistent connections, therefore the callback needs to be re-registered for a new persistent connection.
参数
- $connection
An Oracle connection identifier.
- $callbackFn
A user-defined callback to register for Oracle TAF. It can be a string of the function name or a Closure(anonymous function).
The interface of a TAF user-defined callback function is as follows:
userCallbackFn(resource $connection,int $event,int $type): int
See the parameter description and an example on OCI8 Transparent Application Failover(TAF)Support page.
返回值
成功时返回TRUE
,或者在失败时返回FALSE
。
参见
oci_unregister_taf_callback()
Unregister a user-defined callback function for Oracle Database TAF