php-src/ext/oci8
Hannes Magnusson 176b72284c Error message clean up
(patch by Matt W (php_lists -AT- realpain.com))
2006-10-08 13:34:24 +00:00
..
tests new test 2006-10-06 09:57:29 +00:00
config.m4 add 4.3.10 dependency to package.xml 2006-06-22 20:28:51 +00:00
config.w32 re-enable OCILobRead2() support on win32 2006-05-22 04:17:24 +00:00
CREDITS fix credits 2005-09-06 21:42:26 +00:00
oci8_collection.c fix PECL bug #8112 (OCI8 persistent connections misbehave when Apache process times out) 2006-08-21 16:40:46 +00:00
oci8_interface.c minor improvements 2006-08-22 11:08:28 +00:00
oci8_lob.c Error message clean up 2006-10-08 13:34:24 +00:00
oci8_statement.c fix PECL bug #8816 (issue in php_oci_statement_fetch with more than one piecewise column) 2006-10-06 12:46:08 +00:00
oci8.c uhm.. declare oci_lob_seek() along with OCI-Lob->seek() method 2006-09-12 20:26:59 +00:00
oci8.dsp Update php4 build file, compile against istantclient 2005-09-28 22:31:45 +00:00
package.xml prepare to 1.2.2 release 2006-08-24 11:53:37 +00:00
php_oci8_int.h minor improvements 2006-08-22 11:08:28 +00:00
php_oci8.h bump year and license version 2006-01-01 13:10:10 +00:00
README Updated OCI8 driver 2005-09-06 19:31:59 +00:00

Installing OCI8
---------------

1. Common requirements.
2. Installing as shared extension.
3. Installing as statically compiled extension.
4. Installing from PECL.


1. Common requirements
----------------------
In case if you use Oracle Instant Client, you don't have to set ORACLE_HOME and 
most of the other environment variables to build PHP with OCI8 support. 
The only variables you may have to set are:
LD_LIBRARY_PATH - it must include Instant Client libraries dir
NLS_LANG - in case if you want to change the default encoding used during 
interaction with Oracle servers

If you use common Oracle Client installation that comes along with the Oracle 
server installation, you MUST set at least ORACLE_HOME environment variable 
and make it visible for your web-server BEFORE it starts. Most appropriate 
places to add ORACLE_HOME definition are:
- /etc/profile
- /etc/profile.local
- /etc/profile.d
and others.

2. Installing as shared extension
---------------------------------
To install OCI8 as shared extension (i.e. the one you should put into 
your php.ini) use the following configure lines to configure PHP:
a) if you use common Oracle Client installation:
./configure --with-oci8=shared,$ORACLE_HOME

b) with Oracle Instant Client:
./configure --with-oci8=shared,instantclient,/path/to/instant/client/lib
If you use rpm-based installation of Oracle Instant Client, your configure 
line will look like this:
./configure --with-oci8=shared,instantclient,/usr/lib/oracle/<OIC version>/client/lib

Follow the usual building procedure after that and you'll get OCI8 shared 
extension (i.e. oci8.so). Add it into the php.ini file like this:
extension=oci8.so
and don't forget to specify the right extension_dir for PHP to be able 
to find shared extensions correctly.

3. Installing as statically compiled extension
----------------------------------------------
To install OCI8 as statically compiled module use the following configure lines:
a) with common Oracle Client installation
./configure --with-oci8=$ORACLE_HOME

b) with Oracle Instant Client
./configure --with-oci8=instantclient,/path/to/instant/client/lib

After successful compile, you don't have to add oci8.so to the php.ini, the module will 
be usable without any additional actions.

4. Installing from PECL
-----------------------
TBD