[prev in list] [next in list] [prev in thread] [next in thread]
List: php-doc-cvs
Subject: [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/reference/oci8/_configure.xml?=
From: Christopher_Jones <sixd () php ! net>
Date: 2020-11-30 0:30:38
Message-ID: svn-sixd-1606696238-351756-2039116210 () svn ! php ! net
[Download RAW message or body]
sixd Mon, 30 Nov 2020 00:30:38 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=351756
Log:
Update OCI8 install
Changed paths:
U phpdoc/en/trunk/reference/oci8/configure.xml
Modified: phpdoc/en/trunk/reference/oci8/configure.xml
===================================================================
--- phpdoc/en/trunk/reference/oci8/configure.xml 2020-11-29 23:43:47 UTC (rev 351755)
+++ phpdoc/en/trunk/reference/oci8/configure.xml 2020-11-30 00:30:38 UTC (rev 351756)
@@ -12,10 +12,6 @@
section before configuring OCI8.
</para>
<para>
- To enable the OCI8 extension, configure PHP with the option
- <option role="configure">--with-oci8</option>.
- </para>
- <para>
Before starting the web server, OCI8 typically requires several
Oracle environment variables (see below) to locate libraries, point
to configuration files, and set some basic properties such as the
@@ -31,15 +27,12 @@
</para>
</section>
<section>
- <title>Installing OCI8 from PECL</title>
+ <title>Installing OCI8 from PECL Using the pecl Command</title>
<para xmlns:xlink="http://www.w3.org/1999/xlink">
- The OCI8 extension can be added to an existing PHP installation
- by using <link xlink:href="&url.pecl.package;oci8">PECL</link>.
+ The OCI8 extension can be added to an existing PHP installation by using
+ the <link xlink:href="&url.pecl.package;oci8">PECL</link> repository.
</para>
<para>
- For an automated install follow these steps:
- </para>
- <para>
<itemizedlist>
<listitem>
<para>
@@ -71,21 +64,68 @@
<para>
For PHP 7, use <literal>pecl install oci8-2.2.0</literal>
</para>
+ </listitem>
+ <listitem>
<para>
When prompted, enter either the value of <literal>$ORACLE_HOME</literal>, or
<literal>instantclient,/path/to/instant/client/lib</literal>.
</para>
<para>
- Note: Do not enter the text <literal>$ORACLE_HOME</literal>
- because it will not be expanded. Instead, enter the actual path
- of the Oracle home directory.
+ Note: Do not enter variable names like <literal>$ORACLE_HOME</literal>
+ or <literal>$HOME</literal> because <literal>pecl</literal> will not
+ expand them. Instead, enter an expanded path, for
+ example <literal>/opt/oracle/product/19c/dbhome_1</literal>
+ or <literal>instantclient,/Users/myname/Downloads/instantclient_19_8</literal>
</para>
</listitem>
+ <listitem>
+ <para>
+ If you get an error <literal>oci8_dtrace_gen.h: No such file or
+ directory</literal>, it means PHP was built
+ with <link linkend="features.dtrace">DTrace Dynamic Tracing</link> enabled.
+ Install using:
+ </para>
+ <para>
+ <informalexample>
+ <screen>
+<![CDATA[
+$ export PHP_DTRACE=yes
+$ pecl install oci8
+]]>
+ </screen>
+ </informalexample>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Edit your &php.ini; file and add the line:
+ </para>
+ <para>
+ <informalexample>
+ <screen>
+ <![CDATA[
+extension=oci8.so
+]]>
+ </screen>
+ </informalexample>
+ </para>
+ <para>
+ Make sure the &php.ini;
+ directive <link linkend="ini.extension-dir">extension_dir</link> is
+ set to the directory that <filename>oci8.so</filename> was installed
+ in.
+ </para>
+ </listitem>
</itemizedlist>
</para>
- <para>
- For a manual install when the <literal>pecl</literal> command is not
- available, download the PECL OCI8 package, e.g. <filename>oci8-3.0.0.tgz</filename>.
+</section>
+<section>
+ <title>Installing OCI8 from PECL Using phpize</title>
+ <para xmlns:xlink="http://www.w3.org/1999/xlink">
+ To install OCI8 on an existing PHP installation when
+ the <literal>pecl</literal> command is not available, manually download
+ the <link xlink:href="&url.pecl.package;oci8">PECL</link> OCI8 package,
+ e.g. <filename>oci8-3.0.0.tgz</filename>.
</para>
<para>
<itemizedlist>
@@ -159,30 +199,49 @@
</informalexample>
</para>
</listitem>
- </itemizedlist>
- </para>
- <para>
- After either an automatic or manual install, edit your &php.ini;
- file and add the line:
- </para>
- <para>
- <informalexample>
- <screen>
+ <listitem>
+ <para>
+ If you get an error <literal>oci8_dtrace_gen.h: No such file or
+ directory</literal>, it means PHP was built
+ with <link linkend="features.dtrace">DTrace Dynamic Tracing</link> enabled.
+ Re-run the <literal>configure</literal> and <literal>make</literal>
+ commands after setting this environment variable:
+ </para>
+ <para>
+ <informalexample>
+ <screen>
<![CDATA[
+$ export PHP_DTRACE=yes
+]]>
+ </screen>
+ </informalexample>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Edit your &php.ini; file and add the line:
+ </para>
+ <para>
+ <informalexample>
+ <screen>
+ <![CDATA[
extension=oci8.so
]]>
- </screen>
- </informalexample>
+ </screen>
+ </informalexample>
+ </para>
+ <para>
+ Make sure the &php.ini;
+ directive <link linkend="ini.extension-dir">extension_dir</link> is
+ set to the directory that <filename>oci8.so</filename> was installed
+ in.
+ </para>
+ </listitem>
+ </itemizedlist>
</para>
- <para>
- Make sure the &php.ini;
- directive <link linkend="ini.extension-dir">extension_dir</link> is
- set to the directory that <filename>oci8.so</filename> was installed
- in.
- </para>
</section>
<section>
- <title>Installing OCI8 as a Shared Extension</title>
+ <title>Installing OCI8 as a Shared Extension when Building PHP</title>
<para>
If you are building PHP from source code, the
configuration <literal>shared</literal> option can be used to build OCI8 as a shared library
@@ -286,7 +345,7 @@
</para>
</section>
<section>
- <title>Installing OCI8 as a Statically Compiled Extension</title>
+ <title>Installing OCI8 as a Statically Compiled Extension when Building PHP</title>
<para>
If you are building PHP from source code, you can configure PHP to include
OCI8 as a static extension using one of the following configure options.
@@ -332,6 +391,11 @@
</section>
<section>
<title>Installing OCI8 on Windows</title>
+ <para xmlns:xlink="http://www.w3.org/1999/xlink">
+ The OCI8 extension can be added to an existing PHP installation by using the
+ DLLs from <link xlink:href="&url.pecl.package;oci8">PECL</link> repository or
+ the libraries in your PHP installation's <literal>ext</literal> directory.
+ </para>
<para>
With Oracle 12<emphasis>c</emphasis> (or later) libraries, uncomment one of
the &php.ini; lines <literal>extension=php_oci8_12c.dll</literal>
@@ -415,7 +479,7 @@
location of the Oracle libraries, for
example <filename>$ORACLE_HOME/lib</filename>
or <filename>/usr/lib/oracle/18.5/client/lib</filename>. Note with Instant
- Client 19 ZIP files on Linux it is more reliable to
+ Client ZIP files on Linux it is more reliable to
use <filename>ldconfig</filename> instead, see the Instant Client
installation instructions. With Instant Client 19 (or later) RPM
files, <literal>ldconfig</literal> is automatically run for you. Some
--
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic