The XML DAS no longer has its own separate shared library.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@221129 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Caroline Maynard 2006-10-04 16:02:24 +00:00
parent ffc56c954b
commit 42533a7a7b

View file

@ -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 &lt; wherever your sdo code is &gt;</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 &lt; wherever your sdo code is &gt;
</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">