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 - Oracle Database TAF에 대한 사용자 정의 콜백 함수 등록
설명
oci_register_taf_callback(resource $connection
, ?callable $callback
): bool
사용자 정의 콜백 함수를 connection
에 등록합니다. 인스턴스 또는 네트워크 장애로 인해 connection
이 실패하면 등록된 콜백 함수가 장애 조치(failover) 중에 여러 번 호출됩니다. 자세한 내용은 OCI8 TAF(Transparent Application Failover) 지원을 참조하십시오.
oci_register_taf_callback()이 여러 번 호출되면 각 등록이 이전 등록을 덮어씁니다.
oci_unregister_taf_callback()을 사용하여 사용자 정의 콜백을 명시적으로 등록 취소합니다.
TAF 콜백 등록은 영구 연결을 통해 저장되지 않으므로 새로운 영구 연결을 위해 콜백을 다시 등록해야 합니다.
매개변수
connection
- Oracle 연결 식별자입니다.
callback
- Oracle TAF에 등록하기 위한 사용자 정의 콜백입니다. 함수 이름의 문자열이거나 클로저(익명 함수)일 수 있습니다.
TAF 사용자 정의 콜백 함수의 인터페이스는 다음과 같습니다.
userCallbackFn(resource
$connection
, int$event
, int$type
): intOCI8 TAF(Transparent Application Failover) 지원 페이지에서 매개변수 설명 및 예를 참조하십시오.
반환 값
성공하면 true
를, 실패하면 false
를 반환합니다.
기타
- oci_unregister_taf_callback() - Oracle Database TAF에 대한 사용자 정의 콜백 함수 등록 취소