cem Wed Oct 4 16:02:24 2006 UTC
Modified files:
/phpdoc/en/reference/sdo reference.xml
Log:
The XML DAS no longer has its own separate shared library.
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sdo/reference.xml?r1=1.23&r2=1.24&diff_format=u
Index: phpdoc/en/reference/sdo/reference.xml
diff -u phpdoc/en/reference/sdo/reference.xml:1.23
phpdoc/en/reference/sdo/reference.xml:1.24
--- phpdoc/en/reference/sdo/reference.xml:1.23 Thu Jun 8 14:43:55 2006
+++ phpdoc/en/reference/sdo/reference.xml Wed Oct 4 16:02:24 2006
@@ -1,8 +1,7 @@
<?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.23 $ -->
-<!-- Purpose: database.abstract -->
+<!-- $Revision: 1.24 $ -->
+<!-- Purpose: xml -->
<!-- Membership: pecl -->
-<!-- State: experimental -->
<reference id="ref.sdo">
<title>SDO Functions</title>
@@ -38,7 +37,7 @@
This extension is derived from concepts taken from the
<ulink url="&url.ibm.sdo;">Service Data Objects specification</ulink>.
It includes a version of the
- <ulink url="&url.apache.tuscany;">Apache Tuscany</ulink> SDO 2.0 for C++
project.
+ <ulink url="&url.apache.tuscany;">Apache Tuscany</ulink> SDO for C++
project.
</para>
<section id="sdo.intro.structure">
@@ -81,122 +80,168 @@
</section>
<section id="sdo.installation">
- &reftitle.install;
- <procedure id='sdo.install.unix'>
- <title>Unix systems</title>
- <step>
- <para> You can download and install the latest stable release of all
three SDO
- components - the SDO core, the XML DAS and the Relational DAS - with
the command:
- <screen> <![CDATA[
+ &reftitle.install;
+ <note>
+ <para>
+ Earlier versions of the SDO extension required a
separate
+ shared library for the XML DAS. This is now obsolete and
+ any references to
+ <command>php_sdo_das_xml.dll</command>
+ or
+ <command>sdo_das_xml.so</command>
+ should be removed from your &php.ini;.
+ .
+ </para>
+ </note>
+ <procedure id='sdo.install.unix'>
+ <title>Unix systems</title>
+ <step>
+ <para>
+ You can download and install the latest stable
release
+ of all three SDO components - the SDO core, the
XML
+ DAS and the Relational DAS - with the command:
+ <screen>
+ <![CDATA[
pecl install sdo
]]>
- </screen>
- </para>
- <para> This command will build the SDO and XML shared libraries as well
as installing
- the PHP files that make the Relational DAS.
- </para>
- <para>
- If you want to use the latest beta version, then instead run:
- <screen>
-<![CDATA[
+ </screen>
+ </para>
+ <para>
+ This command will build the SDO shared library
as well
+ as installing the PHP files that make the
Relational
+ DAS.
+ </para>
+ <para>
+ If you want to use the latest beta version, then
+ instead run:
+ <screen>
+ <![CDATA[
pecl install sdo-beta
]]>
- </screen>
- </para>
- </step>
- <step>
- <para> The
- <command>pecl</command> command automatically installs the SDO and
SDO_DAS_XML
- modules into your PHP extensions directory. To enable the SDO extensions
you must add
- the following lines to &php.ini;:
- <screen> <![CDATA[
+ </screen>
+ </para>
+ </step>
+ <step>
+ <para>
+ The
+ <command>pecl</command>
+ command automatically installs the SDO module
into
+ your PHP extensions directory. To enable the SDO
+ extension you must add the following line to
+ &php.ini;
+ :
+ <screen>
+ <![CDATA[
extension=sdo.so
-extension=sdo_das_xml.so
]]>
- </screen>
- </para>
- <para> For more information about building PECL packages, consult the
- <link linkend="install.pecl">PECL installation</link> section of the
manual.
- </para>
- </step>
- </procedure>
-
- <procedure id='sdo.install.win32'>
- <title>Windows</title>
- <step>
- <para>
- The latest DLLs for the SDO core and the XML DAS can be
- downloaded from
- <ulink url='&url.pecl.win.ext;php_sdo.dll'>php_sdo.dll</ulink> and
- <ulink
url='&url.pecl.win.ext;php_sdo_das_xml.dll'>php_sdo_das_xml.dll</ulink>
respectively.
- </para>
- <para>
- Note that currently the <ulink url='&url.pecl.win;'>pecl4win</ulink>
site does not provide
- these binaries at the current release level; you can only download the
latest level.
- </para>
- </step>
- <step>
- <para> The
- <command>pecl</command> command automatically installs the SDO and
SDO_DAS_XML
- modules into your PHP extensions directory. To enable the SDO extensions
you must add
- the following lines to &php.ini;:
- <screen>
- <![CDATA[
+ </screen>
+ </para>
+ <para>
+ For more information about building PECL
packages,
+ consult the
+ <link linkend="install.pecl">PECL
installation</link>
+ section of the manual.
+ </para>
+ </step>
+ </procedure>
+
+ <procedure id='sdo.install.win32'>
+ <title>Windows</title>
+ <step>
+ <para>
+ The latest SDO DLL can be downloaded from
+ <ulink url='&url.pecl.win.ext;php_sdo.dll'>
+ php_sdo.dll
+ </ulink>
+ .
+ </para>
+ <para>
+ Note that currently the
+ <ulink url='&url.pecl.win;'>pecl4win</ulink>
+ site does not provide this binary at the current
+ release level; you can only download the latest
level.
+ </para>
+ </step>
+ <step>
+ <para>
+ The
+ <command>pecl</command>
+ command automatically installs the SDO module
into
+ your PHP extensions directory. To enable the SDO
+ extension you must add the following line to
+ &php.ini;
+ :
+ <screen>
+ <![CDATA[
extension=php_sdo.dll
-extension=php_sdo_das_xml.dll
]]>
- </screen>
- </para>
- </step>
- <step>
- <para> The Relational DAS can be downloaded and installed with the
command:
- <screen>
- <![CDATA[
+ </screen>
+ </para>
+ </step>
+ <step>
+ <para>
+ The Relational DAS can be downloaded and
installed
+ with the command:
+ <screen>
+ <![CDATA[
pecl install -B sdo
]]>
- </screen>
- </para>
- <para> The Relational DAS is written in PHP. You may need to update your
- <link linkend="ini.include-path">include_path</link> in &php.ini; to
point to
- the directory that contains
- <filename>sdo/DAS/Relational</filename>.
- </para>
- </step>
- </procedure>
-
- <procedure id='sdo.build.linux.steps'>
- <title>Building SDO on Linux</title>
- <para> This section describes how to build the SDO core and XML DAS on
Linux. You would
- only need to know how to do this if you wish to build a recent version
that you have checked
- out of CVS.
- </para>
- <step>
- <para>
- Change to the main extension directory:
- <command>cd < wherever your sdo code is ></command>
- </para>
- </step>
- <step>
- <para>
- Run <command>phpize</command>, which will set up the environment to
- compile both SDO and the XML Data Access Service.
- </para>
- </step>
- <step>
- <para>
- Next, run <command>./configure; make; make install</command>.
- Please note, you may need to login as root to install the extension.
- </para>
- </step>
- <step>
- <para>
- Make sure that these modules are loaded by PHP, by adding
- <command>extension=sdo.so</command> and
- <command>extension=sdo_das_xml.so</command> to your
- &php.ini; file in the same order.
- </para>
- </step>
- </procedure>
+ </screen>
+ </para>
+ <para>
+ The Relational DAS is written in PHP. You may
need to
+ update your
+ <link
linkend="ini.include-path">include_path</link>
+ in
+ &php.ini;
+ to point to the directory that contains
+ <filename>sdo/DAS/Relational</filename>
+ .
+ </para>
+ </step>
+ </procedure>
+
+ <procedure id='sdo.build.linux.steps'>
+ <title>Building SDO on Linux</title>
+ <para>
+ This section describes how to build the SDO core and XML
+ DAS on Linux. You would only need to know how to do this
+ if you wish to build a recent version that you have
+ checked out of CVS.
+ </para>
+ <step>
+ <para>
+ Change to the main extension directory:
+ <command>
+ cd < wherever your sdo code is >
+ </command>
+ </para>
+ </step>
+ <step>
+ <para>
+ Run
+ <command>phpize</command>
+ , which will set up the environment to compile
SDO.
+ </para>
+ </step>
+ <step>
+ <para>
+ Next, run
+ <command>./configure; make; make
install</command>
+ . Please note, you may need to login as root to
+ install the extension.
+ </para>
+ </step>
+ <step>
+ <para>
+ Make sure that the module is loaded by PHP, by
adding
+ <command>extension=sdo.so</command>
+ to your
+ &php.ini;
+ file.
+ </para>
+ </step>
+ </procedure>
</section>
<section id="sdo.das.table">
