sixd Sun Jul 27 17:48:16 2008 UTC Modified files: /php-src/ext/oci8 README php_oci8.h Log: Update README. Bump ver ready for PECL release
http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/README?r1=1.8&r2=1.9&diff_format=u Index: php-src/ext/oci8/README diff -u php-src/ext/oci8/README:1.8 php-src/ext/oci8/README:1.9 --- php-src/ext/oci8/README:1.8 Fri Jun 27 18:26:05 2008 +++ php-src/ext/oci8/README Sun Jul 27 17:48:16 2008 @@ -2,19 +2,21 @@ --------------- 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 ----------- 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. +Oracle's standard cross-version connectivity. This release can be +used with PHP 6. The OCI8 extension is not related to or used by PDO_OCI, the PHP Data Objects (PDO) extension for Oracle. @@ -22,22 +24,41 @@ 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. -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: + - the "devel" package is required. - LD_LIBRARY_PATH - it must include the Instant Client library directory + - you don't have to set ORACLE_HOME and many of the other + environment variables to build PHP with OCI8 support. - NLS_LANG - if you want to change the default encoding used during - interaction with Oracle servers +For both ORACLE_HOME and Instant Client installs you may have to set: + + - 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: @@ -45,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 --------------- @@ -177,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). @@ -329,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 @@ -339,11 +405,11 @@ 6.4.2 Closing Connections -With the PHP 6 OCI8 extension, persistent connections can now be -closed by the user, allowing greater control over connection resource -usage. Persistent connections will now also be closed automatically -when there is no PHP variable referencing them, such as at the end of -scope of a PHP user function. This will rollback any uncommitted +With the PHP OCI8 extension, persistent connections can now be closed +by the user, allowing greater control over connection resource usage. +Persistent connections will now also be closed automatically when +there is no PHP variable referencing them, such as at the end of scope +of a PHP user function. This will rollback any uncommitted transaction. These changes to persistent connections make them behave similarly to non-persistent connections, simplifying the interface, allowing for greater application consistency and predictability. Use http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/php_oci8.h?r1=1.48&r2=1.49&diff_format=u Index: php-src/ext/oci8/php_oci8.h diff -u php-src/ext/oci8/php_oci8.h:1.48 php-src/ext/oci8/php_oci8.h:1.49 --- php-src/ext/oci8/php_oci8.h:1.48 Thu Jul 24 15:23:29 2008 +++ php-src/ext/oci8/php_oci8.h Sun Jul 27 17:48:16 2008 @@ -25,7 +25,7 @@ +----------------------------------------------------------------------+ */ -/* $Id: php_oci8.h,v 1.48 2008/07/24 15:23:29 sixd Exp $ */ +/* $Id: php_oci8.h,v 1.49 2008/07/27 17:48:16 sixd Exp $ */ #if HAVE_OCI8 # ifndef PHP_OCI8_H @@ -39,7 +39,7 @@ /* * The version of the OCI8 extension. */ -#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
-- PHP CVS Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php