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): int

OCI8 TAF(Transparent Application Failover) 지원 페이지에서 매개변수 설명 및 예를 참조하십시오.


반환 값

성공하면 true를, 실패하면 false를 반환합니다.


기타