php-doc-en/reference/oci8/setup.xml

115 lines
4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="oci8.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="oci8.requirements">
&reftitle.required;
<para>
The OCI8 1.4 extension is included with PHP 5.3, PHP 5.4 and PHP
5.5. It is also available
from <link xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xlink:href="&url.pecl;">PECL</link>. A newer OCI8 2.0 version is
available only from <link xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xlink:href="&url.pecl;">PECL</link>. OCI8 1.4 requires Oracle
12<emphasis>c</emphasis>, 11<emphasis>g</emphasis>,
10<emphasis>g</emphasis> or 9<emphasis>i</emphasis>R2 client
libraries and will install on PHP 4.3.9 onwards. OCI8 2.0 requires
Oracle 12<emphasis>c</emphasis>, 11<emphasis>g</emphasis> or
10<emphasis>g</emphasis> client libraries and will install on PHP
5.2 onwards.
</para>
<para>
If the Oracle Database is on the same machine as PHP, the database
software already contains the necessary libraries. When PHP is on
a different machine, use the free
<link xlink:href="&url.oracle.instant.client;">Oracle Instant Client</link> libraries.
</para>
<para>
To use Oracle Instant Client, install the <literal>basic</literal>
or <literal>basiclite</literal> Oracle Instant Client ZIP file or
RPM package. When building PHP from source code, also install
the <literal>sdk</literal> ZIP file or <literal>devel</literal> RPM
package.
</para>
<para>
You must run PHP with the same, or a more recent, version of the
Oracle libraries that OCI8 was built with.
</para>
<para>
On Windows, the php_oci8 DLL needs Oracle client libraries from version
10<emphasis>g</emphasis>R2 or greater. In PHP 5.3 up to and
including PHP 5.3.5, the php_oci8_11g DLL requires Oracle
11<emphasis>g</emphasis>R1 or greater client libraries. From PHP
5.3.6 the php_oci8_11g DLL requires Oracle
11<emphasis>g</emphasis>R2 or greater client libraries. The
php_oci8_12c DLL from PECL requires Oracle
12<emphasis>c</emphasis>R1 client libraries. With some versions of
Instant Client you may additionally
need <filename>mfc71.dll</filename>
and <filename>msvcr71.dll</filename> libraries.
</para>
<note>
<para>
If OCI8 uses 9<emphasis>i</emphasis>R2 client libraries, then PHP
can connect to Oracle Database 8<emphasis>i</emphasis>,
9<emphasis>i</emphasis>R2, 10<emphasis>g</emphasis> or
11<emphasis>g</emphasis>. If OCI8 uses 10<emphasis>g</emphasis>R2
client libraries, the database can be 9<emphasis>i</emphasis>R2,
10<emphasis>g</emphasis>, 11<emphasis>g</emphasis> or
12<emphasis>c</emphasis>. If OCI8 uses 11<emphasis>g</emphasis>
client libraries, the database can be 9<emphasis>i</emphasis>R2,
10<emphasis>g</emphasis>, 11<emphasis>g</emphasis> or
12<emphasis>c</emphasis>. If OCI8 uses 12<emphasis>c</emphasis>
client libraries, the database can be 10<emphasis>g</emphasis>R2,
11<emphasis>g</emphasis> or 12<emphasis>c</emphasis>.
</para>
</note>
<note>
<para>
Full OCI8 feature support is only available when using the most
recent versions of the Oracle client libraries and database.
</para>
</note>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.oci8.configure;
<!-- }}} -->
<!-- {{{ Testing -->
&reference.oci8.testing;
<!-- }}} -->
<!-- {{{ Configuration -->
&reference.oci8.ini;
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->