sixd Sun Jul 27 17:50:41 2008 UTC
Modified files: (Branch: PHP_5_3)
/php-src/ext/oci8 README php_oci8.h package2.xml
Log:
MFH Update README. Bump ver ready for PECL release
http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/README?r1=1.1.2.2.2.1.2.7&r2=1.1.2.2.2.1.2.8&diff_format=u
Index: php-src/ext/oci8/README
diff -u php-src/ext/oci8/README:1.1.2.2.2.1.2.7
php-src/ext/oci8/README:1.1.2.2.2.1.2.8
--- php-src/ext/oci8/README:1.1.2.2.2.1.2.7 Fri Jun 27 18:26:16 2008
+++ php-src/ext/oci8/README Sun Jul 27 17:50:40 2008
@@ -2,12 +2,12 @@
---------------
0. Overview
-1. Common requirements.
-2. Installing as shared extension.
-3. Installing as statically compiled extension.
-4. Installing from PECL.
+1. Common requirements
+2. Installing as a shared extension
+3. Installing as a statically compiled extension
+4. Installing from PECL to an existing PHP
5. Testing OCI8
-6. DRCP and FAN Support
+6. Oracle DRCP and FAN Support
0. Overview
@@ -15,31 +15,50 @@
The OCI8 extension allows you to access Oracle databases. It can be
built using Oracle 9.2, 10.2 or 11.1 client libraries, and allows
-Oracle's standard cross-version connectivity. It can be used with PHP
-versions 4.3.9 to 5.3.
+Oracle's standard cross-version connectivity. This release can be
+used with PHP versions 4.3.9 to 5.x.
-The OCI8 extension is not related to or used by PDO_OCI, the PHP Data
-Objects (PDO) extension for Oracle.
+The OCI8 extension is not related to, or used by, PDO_OCI - the PHP
+Data Objects (PDO) extension for Oracle.
1. Common requirements
----------------------
-This version of PHP OCI8 will build with Oracle 9.2 (or more recent)
-client libraries.
+This version of PHP OCI8:
+
+ - Will build with Oracle 9.2 (or more recent) client libraries. The
+ same (or more recent) version of Oracle libraries used when
+ building OCI8 must also be used at runtime.
+
+ - Can be used with PHP versions 4.3.9 to 5.x.
+
+If you build PHP with the "ORACLE_HOME" Oracle database or full Oracle
+client libraries:
+
+ - you MUST set at least the ORACLE_HOME environment variable and
+ make it visible for your web server BEFORE it starts.
+
+ - the Oracle software must be readable by the web server. With
+ Oracle 10.2, see the $ORACLE_HOME/install/changePerm.sh script
+ included in patch releases.
+
+If you build PHP with Oracle Instant Client libraries from
+http://www.oracle.com/technology/tech/oci/instantclient/index.html
+
+ - either the "basic" or "basic-lite" package is required.
+
+ - the "devel" package is required.
-If you use a common Oracle Client installation that comes with the
-Oracle server installation, you MUST set at least the ORACLE_HOME
-environment variable and make it visible for your web-server BEFORE it
-starts.
-
-If you use Oracle Instant Client, you don't have to set ORACLE_HOME
-and many of the other environment variables to build PHP with OCI8
-support. The only variables you may have to set are:
+ - you don't have to set ORACLE_HOME and many of the other
+ environment variables to build PHP with OCI8 support.
- LD_LIBRARY_PATH - it must include the Instant Client library directory
+For both ORACLE_HOME and Instant Client installs you may have to set:
- NLS_LANG - if you want to change the default encoding used during
- interaction with Oracle servers
+ - LD_LIBRARY_PATH: it must include the $ORACLE_HOME/lib or Instant
+ Client library directory
+
+ - NLS_LANG: if you want to change the default encoding used during
+ interaction with Oracle servers
The most appropriate places to add the environment variables are:
@@ -47,55 +66,100 @@
/etc/profile.local
/etc/profile.d
-2. Installing as shared extension
----------------------------------
-To install OCI8 as a shared extension (i.e. the one you should put
-into your php.ini) use the following configure lines to configure PHP:
+2. Installing as a shared extension
+-----------------------------------
+
+Configure OCI8 using one of the the following configure options:
-a) if you use a common Oracle or Oracle Client installation:
+ a) if you use an Oracle server or Oracle Client installation:
- ./configure --with-oci8=shared,$ORACLE_HOME
+ ./configure --with-oci8=shared,$ORACLE_HOME
-b) with Oracle Instant Client:
+ b) with Oracle Instant Client:
- ./configure --with-oci8=shared,instantclient,/path/to/instant/client/lib
+ ./configure --with-oci8=shared,instantclient,/path/to/instant/client/lib
-If you use an RPM-based installation of Oracle Instant Client, your configure
-line will look like this:
+ If you use an 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
+ ./configure
--with-oci8=shared,instantclient,/usr/lib/oracle/<version>/client/lib
-Follow the usual building procedure after that and you'll get an OCI8
-shared extension (i.e. oci8.so). Add it into the php.ini file like
-this:
+Follow the usual building procedure, e.g. "make install". The OCI8
+shared extension oci8.so will be created. It may need to be manually
+moved to the PHP extension directory, specified by the extension_dir
+option in your php.ini file.
+
+Edit php.ini file and add the line:
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
-----------------------------------------------
+3. Installing as a statically compiled extension
+------------------------------------------------
+
+Configure OCI8 using one of the the following configure options:
+
+ a) with a common Oracle server or full Oracle client installation
+
+ ./configure --with-oci8=$ORACLE_HOME
+
+ b) with Oracle Instant Client
+
+ ./configure --with-oci8=instantclient,/path/to/instant/client/lib
-To install OCI8 as statically compiled module use the following
-configure lines:
+Run "make install".
-a) with a common Oracle or Oracle Client installation
+After successful compile, you do not need to add oci8.so to php.ini.
+The module will be usable without any additional actions.
- ./configure --with-oci8=$ORACLE_HOME
-b) with Oracle Instant Client
+4. Installing from PECL to an existing PHP
+------------------------------------------
- ./configure --with-oci8=instantclient,/path/to/instant/client/lib
+The OCI8 extension is also available as a PECL module on
+http://pecl.php.net/package/oci8.
-After successful compile, you don't have to add oci8.so to the
-php.ini. The module will be usable without any additional actions.
+Install using either (a) or (b) below.
-4. Installing from PECL
------------------------
+ a) Do an automated download and install:
+
+ Set PEARs proxy, if necessary:
+
+ pear config-set http_proxy http://my-proxy.example.com:80/
+
+ Run
+
+ pecl install oci8
+
+ When prompted, enter either the value of $ORACLE_HOME, or
+ "instantclient,/path/to/instant/client/lib" (without quotes).
+
+ b) Alternatively, manually download the PECL package, e.g. oci8-1.3.3.tgz
+
+ Extract and prepare the package:
+
+ tar -zxf oci8-1.3.3.tgz
+ cd oci8-1.3.3
+ phpize
+
+ Configure the package, either using $ORACLE_HOME or Instant Client
+
+ ./configure -with-oci8=shared,$ORACLE_HOME
+
+ or
+
+ ./configure -with-oci8=shared,instantclient,/path/to/instant/client/lib
+
+ Install the package:
+
+ make install
+
+After either install, edit your php.ini file, e.g. /etc/php.ini, and
+add the line:
+
+ extension=oci8.so
-TBD
5. Testing OCI8
---------------
@@ -179,8 +243,8 @@
5.2.5. Rerun the tests
-6. DRCP and FAN Support
------------------------
+6. Oracle DRCP and FAN Support
+------------------------------
The PHP OCI8 extension has support for the Oracle Database Resident
Connection Pool (DRCP) and Fast Application Notification (FAN).
@@ -331,7 +395,7 @@
6.3.4. Run your application, connecting to a 10gR2 or 11g database.
-6.4. Recommendations and Known Limitations
+6.4. Recommendations and Known Limitations
6.4.1 Changing Password for DRCP connections
http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/php_oci8.h?r1=1.36.2.2.2.1.2.8&r2=1.36.2.2.2.1.2.9&diff_format=u
Index: php-src/ext/oci8/php_oci8.h
diff -u php-src/ext/oci8/php_oci8.h:1.36.2.2.2.1.2.8
php-src/ext/oci8/php_oci8.h:1.36.2.2.2.1.2.9
--- php-src/ext/oci8/php_oci8.h:1.36.2.2.2.1.2.8 Thu Jul 24 15:24:14 2008
+++ php-src/ext/oci8/php_oci8.h Sun Jul 27 17:50:40 2008
@@ -25,7 +25,7 @@
+----------------------------------------------------------------------+
*/
-/* $Id: php_oci8.h,v 1.36.2.2.2.1.2.8 2008/07/24 15:24:14 sixd Exp $ */
+/* $Id: php_oci8.h,v 1.36.2.2.2.1.2.9 2008/07/27 17:50:40 sixd Exp $ */
#if HAVE_OCI8
# ifndef PHP_OCI8_H
@@ -46,7 +46,7 @@
*/
#undef PHP_OCI8_VERSION
#endif
-#define PHP_OCI8_VERSION "1.3.4-dev"
+#define PHP_OCI8_VERSION "1.3.4"
extern zend_module_entry oci8_module_entry;
#define phpext_oci8_ptr &oci8_module_entry
http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/package2.xml?r1=1.1.2.8.2.7&r2=1.1.2.8.2.8&diff_format=u
Index: php-src/ext/oci8/package2.xml
diff -u php-src/ext/oci8/package2.xml:1.1.2.8.2.7
php-src/ext/oci8/package2.xml:1.1.2.8.2.8
--- php-src/ext/oci8/package2.xml:1.1.2.8.2.7 Thu Jun 19 19:56:11 2008
+++ php-src/ext/oci8/package2.xml Sun Jul 27 17:50:41 2008
@@ -6,7 +6,7 @@
<name>oci8</name>
<channel>pecl.php.net</channel>
<summary>Extension for Oracle Database</summary>
- <description>This extension allows you to access Oracle databases using the
Oracle Call Interface (OCI8). It can be built using Oracle 9.2, 10.2 or 11.1
client libraries, and allows Oracle's standard cross-version connectivity.
+ <description>This extension allows you to access Oracle databases using the
Oracle Call Interface (OCI8). It can be built with PHP 4.3.9 to 5.x. It can be
linked with Oracle 9.2, 10.2 or 11.1 client libraries.
</description>
<lead>
<name>Antony Dovgal</name>
@@ -33,12 +33,12 @@
<active>yes</active>
</lead>
- <date>2008-06-19</date>
- <time>12:00:00</time>
+ <date>2008-07-27</date>
+ <time>16:00:00</time>
<version>
- <release>1.3.3</release>
- <api>1.3.3</api>
+ <release>1.3.4</release>
+ <api>1.3.4</api>
</version>
<stability>
<release>stable</release>
@@ -46,8 +46,10 @@
</stability>
<license uri="http://www.php.net/license";>PHP</license>
<notes>
-Changed OCI NLS initialization for consistency and technical correctness
-Removed obsolete macros
+Enhancement - Allow External Authentication (not supported on Windows)
+Enhancement - Reflection will show function and method arguments with PHP 5.x
+Increase default oci8.default_prefetch from 10 to 100
+Correctly define SQLT_BDOUBLE and SQLT_BFLOAT constants with Oracle 10g
ORACLE_HOME builds
</notes>
<contents>
<dir name="/">
@@ -205,6 +207,10 @@
<file name="error.phpt" role="test" />
<file name="exec_fetch.phpt" role="test" />
<file name="execute_mode.phpt" role="test" />
+ <file name="extauth_01.phpt" role="test" />
+ <file name="extauth_02.phpt" role="test" />
+ <file name="extauth_03.phpt" role="test" />
+ <file name="extauth_04.phpt" role="test" />
<file name="fetch_all2.phpt" role="test" />
<file name="fetch_all3.phpt" role="test" />
<file name="fetch_all.phpt" role="test" />
@@ -288,6 +294,8 @@
<file name="prefetch.phpt" role="test" />
<file name="privileged_connect1.phpt" role="test" />
<file name="privileged_connect.phpt" role="test" />
+ <file name="reflection1.phpt" role="test" />
+ <file name="reflection2.phpt" role="test" />
<file name="rowid_bind.phpt" role="test" />
<file name="select_null.phpt" role="test" />
<file name="serverversion.phpt" role="test" />
@@ -335,6 +343,22 @@
<release>
<version>
+ <release>1.3.3</release>
+ <api>1.3.3</api>
+ </version>
+ <stability>
+ <release>stable</release>
+ <api>stable</api>
+ </stability>
+ <license uri="http://www.php.net/license";>PHP</license>
+ <notes>
+Changed OCI NLS initialization for consistency and technical correctness
+Removed obsolete macros
+ </notes>
+</release>
+
+<release>
+ <version>
<release>1.3.2</release>
<api>1.3.2</api>
</version>
--
PHP CVS Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
