mfp Tue Jul 26 11:28:57 2005 EDT
Modified files:
/phpdoc/en/reference/sdodasrel reference.xml
Log:
Alterations to the Requirements section
http://cvs.php.net/diff.php/phpdoc/en/reference/sdodasrel/reference.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/reference/sdodasrel/reference.xml
diff -u phpdoc/en/reference/sdodasrel/reference.xml:1.8
phpdoc/en/reference/sdodasrel/reference.xml:1.9
--- phpdoc/en/reference/sdodasrel/reference.xml:1.8 Tue Jul 26 10:13:17 2005
+++ phpdoc/en/reference/sdodasrel/reference.xml Tue Jul 26 11:28:57 2005
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc.
-->
<reference id="ref.sdo.das.rel">
<title>SDO Relational Data Access Service Functions</title>
@@ -151,8 +151,37 @@
The Relational DAS requires that the SDO extension be installed.
The SDO extension requires a version of PHP 5.1, and the
Relational DAS requires a recent version that contains
- an important fix for PDO. The Relational DAS requires a
- version of PHP 5.1 later than 20050711.
+ an important fix for PDO. The most up-to-date information about
+ required levels of PHP should be found in the changelog for the
+ package on PECL. At the time of writing, though, the Relational
+ DAS requires the most recent beta level of PHP 5.1, that is
+ PHP 5.1.0b3.
+ </para>
+ <para>
+ The Relational DAS uses PDO to access the relational database,
+ and so should run with a variety of different relational databases,
+ but at the time of writing has only been tested with MySQL 4.1.
+ On Windows it operates correctly with the php_pdo_mysql driver
+ that comes with the pre-built binaries in PHP 5.1.0b3.
+ On Linux it is necessary to have the most up-to-date PDO
+ driver for MySQL. It may be necessary to uninstall the usual
+ driver that would have come from PECL (using
+ <command>pear uninstall pdo_mysql</command>
+ ) and to enable pdo_mysql when configuring PHP, in order to pick up
+ the recent version built in to PHP.
+ </para>
+
+ <para>
+ The Relational DAS applies changes to the database within
+ a user-delimited transaction: that is, it issues a call to PDO's
+ <function>beginTransaction</function>
+ before beginning to apply changes, and
+ <function>commit</function>
+ or
+ <function>rollback</function>
+ on completion.
+ Whichever database is chosen, the database and the PDO driver
+ for the database must support these calls.
</para>
</section>
