abies Thu Sep 11 05:31:32 2003 EDT
Modified files:
/phpdoc/en/reference/ibase/functions ibase-trans.xml
Log:
Add stuff about multi-DB transactions
Index: phpdoc/en/reference/ibase/functions/ibase-trans.xml
diff -u phpdoc/en/reference/ibase/functions/ibase-trans.xml:1.4
phpdoc/en/reference/ibase/functions/ibase-trans.xml:1.5
--- phpdoc/en/reference/ibase/functions/ibase-trans.xml:1.4 Tue Sep 2 07:56:46
2003
+++ phpdoc/en/reference/ibase/functions/ibase-trans.xml Thu Sep 11 05:31:31 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/ibase.xml, last change in rev 1.23 -->
<refentry id="function.ibase-trans">
<refnamediv>
@@ -30,6 +30,21 @@
will be rolled back at the end of the script if they were not committed or
rolled back by either <function>ibase_commit</function> or
<function>ibase_rollback</function>.
+ </para>
+ </note>
+ <note>
+ <para>
+ In PHP 5.0.0. and up, this function will accept multiple
<parameter>trans_args</parameter>
+ and <parameter>link_identifier</parameter> arguments. This allows transactions
+ over multiple database connections, which are committed using a 2-phase commit
+ algorithm. This means you can rely on the updates to either succeed in every
+ database, or fail in every database. It does NOT mean you can use tables from
+ different databases in the same query!
+ </para>
+ <para>
+ If you use transactions over multiple databases, you will have to specify both
+ the <parameter>link_id</parameter> and <parameter>transaction_id</parameter>
+ in calls to <function>ibase_query</function> and
<function>ibase_prepare</function>.
</para>
</note>
</refsect1>
