Rewrite installation instructions to cover Windows/Linux X Release/latestCVS.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@192308 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Matthew Peters 2005-08-03 14:29:59 +00:00
parent 6b5fcd3f61
commit 500d41edab

View file

@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.11 $ -->
<!-- $Revision: 1.12 $ -->
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
<reference id="ref.sdo">
<title>SDO Functions</title>
@ -87,34 +87,141 @@
<section id="sdo.installation">
&reftitle.install;
<para>
SDO extension can be installed using pear. However as it is
still in it's beta you need set <command>pear</command> option 'preferred_state' to beta.
like <command> pear -D preferred_state=beta install sdo </command>.
If you want to install this extension manually on Linux, you
can do so by following steps described below.
</para>
<procedure id='sdo.installation.linux.steps'>
<title>Linux installation steps</title>
There are several options, depending on whether you are installing on
Windows or Linux, and depending on whether you are installing a released
version (a .tgz file from the PECL site) or the latest from CVS.
The Relational DAS also needs special attention as it is written in
PHP.
</para>
<para>
The instructions are likely to change as PHP 5.1 progresses in status
from beta to stable release. The instructions here were correct on 3rd
August 2005, when PHP 5.1.0b3 was the current beta release of
PHP, and 0.5.0 was the current beta release of SDO.
</para>
<para>
The options are summarised in the following table:
<informaltable>
<tgroup cols='3'>
<thead>
<row>
<entry>latest CVS/Release</entry>
<entry>Windows</entry>
<entry>Linux</entry>
</row>
</thead>
<tbody>
<row>
<entry>
latest CVS
</entry>
<entry>
<itemizedlist>
<listitem>
<para>
You will find the latest DLLs for the SDO core and the
XML DAS at the PHP snaps site.
The "PECL extensions for the unstable win32 branch" link points
to the list of recently built DLLs. The latest sdo core is
<filename>php_sdo.dll</filename>
.
The latest XML DAS is
<filename>php_sdo_das_xml.dll</filename>
.
</para>
</listitem>
<listitem>
<para>
Check out the Relational DAS from CVS to somewhere on the
PHP
<link linkend="ini.include-path">include_path</link>
.
</para>
</listitem>
</itemizedlist>
</entry>
<entry>
<itemizedlist>
<listitem>
<para>
Check out the SDO core and the XML DAS from CVS
and build according to the instructions
immediately following for building on Linux.
</para>
</listitem>
<listitem>
<para>
Check out the Relational DAS from CVS to somewhere on the
PHP
<link linkend="ini.include-path">include_path</link>
.
</para>
</listitem>
</itemizedlist>
</entry>
</row>
<row>
<entry>
Release
</entry>
<entry>
<itemizedlist>
<listitem>
<para>
There is currently no way provided for building the release
version of the SDO core and XML DAS on a user's machine.
You will only be able to pick up the latest DLLs from the
snaps site (see previous row of this table).
</para>
</listitem>
<listitem>
<para>
The Relational DAS can be downloaded and installed with
</para>
<para>
<command>
pear -B install sdo-0.5.0
</command>
.
</para>
</listitem>
</itemizedlist>
</entry>
<entry>
<itemizedlist>
<listitem>
<para>
You can download and install all three SDO components - the
SDO core, the XML DAS and the Relational DAS - with the
command
<command>
pear install sdo-0.5.0
</command>
.
This will build the SDO and XML shared libraries as well as
installing the PHP files that make the Relational DAS.
</para>
</listitem>
</itemizedlist>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<procedure id='sdo.build.linux.steps'>
<title>Building SDO on Linux</title>
<para>
The following instructions describe how to install the
SDO extension on Linux. Note, these steps will also install the
<link linkend="ref.sdo-das-xml">XML Data Access Service</link>
which is packaged as part of this extension.
This section describes how to build the SDO core and XML DAS on Linux.
Currently 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>
Download the SDO extension from the pecl/sdo directory on CVS.
</para>
</step>
<step>
<para>
Untar the downloaded image in your favourite folder.
</para>
</step>
<step>
<para>
Change to the main extension directory:
<command>cd sdo-&lt; version &gt;</command>
<command>cd &lt; wherever your sdo code is &gt;</command>
</para>
</step>
<step>