Improvements to Install section - Include link to PECL snaps; describe alterations to php.ini.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@192390 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Matthew Peters 2005-08-04 11:41:38 +00:00
parent a9a7708550
commit 14ebe5615f

View file

@ -1,5 +1,5 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.12 $ -->
<!-- $Revision: 1.13 $ -->
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
<reference id="ref.sdo">
<title>SDO Functions</title>
@ -92,124 +92,153 @@
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>
</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/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. Follow the link to
<ulink url='&url.pecl.get.win.unstable;'>
"PECL extensions for the unstable win32 branch"
</ulink>
for the list of recently built DLLs. The latest sdo core DLL is
<filename>php_sdo.dll</filename>
and the latest XML DAS DLL 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
below 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>
<para>
Regardless of which platform or which level of the code you have installed
you will need add the two extension libraries to your &php.ini; file.
On Windows, add:
<programlisting role="php" id="sdo.installation.ini.windows">
<![CDATA[
extension=php_sdo.dll
extension=php_sdo_das_xml.dll
]]>
</programlisting>
On Linux, add:
<programlisting role="php" id="sdo.installation.ini.linux">
<![CDATA[
extension=sdo.so
extension=sdo_das_xml.so
]]>
</programlisting>
You may also need to update your
<link linkend="ini.extension-dir">extension_dir</link>
in &php.ini; to point to the location of these libraries.
</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>
<procedure id='sdo.build.linux.steps'>
<title>Building SDO on Linux</title>
<para>