Files
php-doc-ru/reference/oci8/functions/oci-register-taf-callback.xml
Alexey Pyltsyn 8f8d4016fe Upd
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@343999 c90b9560-bf6c-de11-be94-00142212c4b1
2018-01-28 09:37:16 +00:00

117 lines
4.3 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fa994a739c769e155f6b6848f66f1f9a24ec9eb0 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.oci-register-taf-callback" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>oci_register_taf_callback</refname>
<refpurpose>Регистрирует пользовательскую функцию обратного вызова для Oracle Database TAF</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>oci_register_taf_callback</methodname>
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>callbackFn</parameter></methodparam>
</methodsynopsis>
<para>
Регистрирует пользовательскую функцию обратного вызова для соединения
<parameter>connection</parameter>.
Если соединение <parameter>connection</parameter> оборвалось из-за проблем с БД или
сетью, будет произведено несколько запусков зарегистрированной функции в процессе
восстановления. Более подробно читайте <link linkend="oci8.taf">OCI8 Transparent Application Failover (TAF) Support</link> .
</para>
<para>
Каждый новый вызов <function>oci_register_taf_callback</function> будет затирать
предыдущие регистрации.
</para>
<para>
Для явного удаления регистрации используйте функцию
<function>oci_unregister_taf_callback</function>.
</para>
<para>
Регистрация функции обратного вызова НЕ сохраняется для постоянных соединений,
следовательно при каждом новом постоянном соединении ее необходимо
перерегистрировать.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
Идентификатор соединения Oracle.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>callbackFn</parameter></term>
<listitem>
<para>
Пользовательская функция для регистрации для Oracle TAF. Может быть как
строкой с именем функции, так и замыканием (анонимной функцией).
</para>
<para>
Интерфейс функции следующий:
</para>
<methodsynopsis>
<type>int</type><methodname>userCallbackFn</methodname>
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
<methodparam><type>int</type><parameter>event</parameter></methodparam>
<methodparam><type>int</type><parameter>type</parameter></methodparam>
</methodsynopsis>
<para>
Описание параметров и примеры смотрите на странице <link linkend="oci8.taf">
OCI8 Transparent Application Failover (TAF) Support</link>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>oci_unregister_taf_callback</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->