[PHP-CVS] cvs: php-src(PHP_5_3) /ext/oci8 README
sixdMon Mar 9 17:51:04 2009 UTC Modified files: (Branch: PHP_5_3) /php-src/ext/oci8 README Log: MFH: Prepare for future PECL OCI8 1.3.5 http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/README?r1=1.1.2.2.2.1.2.8&r2=1.1.2.2.2.1.2.9&diff_format=u Index: php-src/ext/oci8/README diff -u 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.9 --- php-src/ext/oci8/README:1.1.2.2.2.1.2.8 Sun Jul 27 17:50:40 2008 +++ php-src/ext/oci8/README Mon Mar 9 17:51:04 2009 @@ -18,7 +18,7 @@ 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 +The OCI8 extension is not related to, or used by, PDO_OCI, the PHP Data Objects (PDO) extension for Oracle. 1. Common requirements @@ -135,12 +135,15 @@ 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 + b) Alternatively, manually download the PECL package, e.g. oci8-1.3.5.tgz - Extract and prepare the package: + Extract the package: + + tar -zxf oci8-1.3.5.tgz + cd oci8-1.3.5 + + 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 @@ -160,6 +163,9 @@ extension=oci8.so +Make sure php.ini's "extension_dir" includes the directory that +oci8.so was installed in. + 5. Testing OCI8 --- @@ -240,8 +246,6 @@ SQL> startup force -5.2.5. Rerun the tests - 6. Oracle DRCP and FAN Support -- -- PHP CVS Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-CVS] cvs: php-src(PHP_5_3) /ext/oci8 README package2.xml php_oci8.h
sixdSun 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//client/lib + ./configure --with-oci8=shared,instantclient,/usr/lib/oracle//client/lib -Follow the usual building procedure after that and you'll get
[PHP-CVS] cvs: php-src(PHP_5_3) /ext/oci8 README
sixdFri Jun 27 18:26:16 2008 UTC Modified files: (Branch: PHP_5_3) /php-src/ext/oci8 README Log: OCI8: MFH: (PECL #14219) Improve README http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/README?r1=1.1.2.2.2.1.2.6&r2=1.1.2.2.2.1.2.7&diff_format=u Index: php-src/ext/oci8/README diff -u php-src/ext/oci8/README:1.1.2.2.2.1.2.6 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.6 Thu Jun 19 19:56:11 2008 +++ php-src/ext/oci8/README Fri Jun 27 18:26:16 2008 @@ -1,6 +1,7 @@ Installing OCI8 --- +0. Overview 1. Common requirements. 2. Installing as shared extension. 3. Installing as statically compiled extension. @@ -8,6 +9,18 @@ 5. Testing OCI8 6. 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. It can be used with PHP +versions 4.3.9 to 5.3. + +The OCI8 extension is not related to or used by PDO_OCI, the PHP Data +Objects (PDO) extension for Oracle. + 1. Common requirements -- -- PHP CVS Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-CVS] cvs: php-src(PHP_5_3) /ext/oci8 README package2.xml php_oci8.h /ext/oci8/tests bind_char_1.phpt bind_char_2.phpt bind_char_3.phpt bind_char_4.phpt bug27303.phpt bug27303_2.phpt bug27303_4.p
sixdThu Jun 19 19:56:12 2008 UTC Modified files: (Branch: PHP_5_3) /php-src/ext/oci8 README package2.xml php_oci8.h /php-src/ext/oci8/tests bind_char_1.phpt bind_char_2.phpt bind_char_3.phpt bind_char_4.phpt bug27303.phpt bug27303_2.phpt bug27303_4.phpt connect.inc debug.phpt details.inc Log: Test updates and bundle 1.3.3 http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/README?r1=1.1.2.2.2.1.2.5&r2=1.1.2.2.2.1.2.6&diff_format=u Index: php-src/ext/oci8/README diff -u php-src/ext/oci8/README:1.1.2.2.2.1.2.5 php-src/ext/oci8/README:1.1.2.2.2.1.2.6 --- php-src/ext/oci8/README:1.1.2.2.2.1.2.5 Thu Jun 5 23:43:10 2008 +++ php-src/ext/oci8/README Thu Jun 19 19:56:11 2008 @@ -169,12 +169,11 @@ 6. DRCP and FAN Support --- -The PHP 5.3 OCI8 Beta extension has support for the Oracle Database -Resident Connection Pool (DRCP) and Fast Application Notification -(FAN). +The PHP OCI8 extension has support for the Oracle Database Resident +Connection Pool (DRCP) and Fast Application Notification (FAN). -This release is for Beta testing only. Questions and issues can be -raised on the Oracle OTN forum (free registration required) +Questions and issues can be raised on the Oracle OTN forum (free +registration required): http://www.oracle.com/technology/forums/php.html @@ -184,9 +183,9 @@ 9iR2 onwards. However, full functionality (e.g. DRCP support) is only available when Oracle 11g is used. -For other, general database functionality, the version of the Oracle -libraries used by PHP does not necessarily have to match the version -of the database. +For general database functionality the version of the Oracle libraries +used by PHP does not necessarily have to match the version of the +database. 6.2. Database Resident Connection Pooling (DRCP) @@ -329,16 +328,15 @@ 6.4.2 Closing Connections -With the PHP 5.3 OCI8 Beta 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 oci8.old_oci_close_semantics=1 to retain the -historical behavior. +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 +oci8.old_oci_close_semantics=1 to retain the historical behavior. 6.4.3 LOGON Triggers can be used to set session properties http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/package2.xml?r1=1.1.2.8.2.6&r2=1.1.2.8.2.7&diff_format=u Index: php-src/ext/oci8/package2.xml diff -u php-src/ext/oci8/package2.xml:1.1.2.8.2.6 php-src/ext/oci8/package2.xml:1.1.2.8.2.7 --- php-src/ext/oci8/package2.xml:1.1.2.8.2.6 Thu Jun 5 23:41:35 2008 +++ php-src/ext/oci8/package2.xml Thu Jun 19 19:56:11 2008 @@ -33,24 +33,21 @@ yes - 2008-04-17 - 16:00:00 + 2008-06-19 + 12:00:00 - 1.3.2 - 1.3.2 + 1.3.3 + 1.3.3 - beta - beta + stable + stable http://www.php.net/license";>PHP -Refine DRCP connection pooling functionality -Do scope-end release for oci_pconnect (oci8.old_oci_close_semantics=1 gives old behavior) -Fixed bug #44372 (compilation with Oracle 10gR1 libraries) -Fixed PECL bug #12431 (PEAR install using x86_64 RPM builds) -Allow builds with PHP 4.3.9 onwards +Changed OCI NLS initialization for consistency and technical correctness +Removed obsolete macros @@ -154,6 +151,14 @@ + + + + + + + + @@ -204,7 +209,6 @@ - @@ -264,6 +268,7 @@ + @@ -328,6 +333,25 @@ + + + 1.3.2 + 1.3.2 + + + beta + beta + + http://www.php.net/license";>PHP + +Refine DRCP connection pooling functionality +Do scope-end release for oci_pconnect (oci8.old_oci_close_semantics=1 gives old behavior) +Fixed bug #44372 (compilation with Oracle 10gR1 libraries) +Fixed PECL bug #12431 (PEAR install using x86_64 RPM builds) +Allow builds with PHP 4.3.9 onwards + + + 1.3.1 h
[PHP-CVS] cvs: php-src(PHP_5_3) /ext/oci8 README
sixdThu Jan 31 20:21:27 2008 UTC Modified files: (Branch: PHP_5_3) /php-src/ext/oci8 README Log: Update test environement description. Typos http://cvs.php.net/viewvc.cgi/php-src/ext/oci8/README?r1=1.1.2.2.2.1.2.1&r2=1.1.2.2.2.1.2.2&diff_format=u Index: php-src/ext/oci8/README diff -u php-src/ext/oci8/README:1.1.2.2.2.1.2.1 php-src/ext/oci8/README:1.1.2.2.2.1.2.2 --- php-src/ext/oci8/README:1.1.2.2.2.1.2.1 Thu Jan 31 01:33:29 2008 +++ php-src/ext/oci8/README Thu Jan 31 20:21:27 2008 @@ -99,6 +99,10 @@ If the database is on the same machine as PHP, set $oracle_on_localhost to TRUE. + If Oracle 11g Database Resident Connection Pooling is being tested, + set $test_drcp to TRUE and ensure the connection string uses an + appropriate pooled server (see section 6.2.2). + An alternative to editing details.inc is the set the environment variables @@ -106,6 +110,7 @@ PHP_OCI8_TEST_PASS PHP_OCI8_TEST_DB PHP_OCI8_TEST_DB_ON_LOCALHOST +PHP_OCI8_TEST_DRCP for example: @@ -113,6 +118,7 @@ $ export PHP_OCI8_TEST_PASS=oracle $ export PHP_OCI8_TEST_DB=localhost/XE $ export PHP_OCI8_TEST_DB_ON_LOCALHOST=TRUE +$ export PHP_OCI8_TEST_DRCP=FALSE 5.1.2. Set any necessary environment variables for the Oracle database. With Oracle 10g XE do: @@ -160,7 +166,7 @@ 6. DRCP and FAN Support --- -Th PHP OCI8 Beta extension has support for the Oracle Database +The PHP 5.3 OCI8 Beta extension has support for the Oracle Database Resident Connection Pool (DRCP) and Fast Application Notification (FAN). @@ -292,7 +298,7 @@ 6.3.4. Run your application, connecting to a 10gR2 or 11g database. -6.4. Changes and Known Issues in this release from PECL OCI8 1.3.0 Beta +6.4. Changes in this release from PECL OCI8 1.3.0 Beta The initial release of OCI8 with DRCP and FAN support was PECL OCI8 1.3.0 Beta. This section documents differences from that release. @@ -330,11 +336,11 @@ 6.4.3 Oci8.max_persistent setting is re-enabled. The php.ini parameter oci8.max_persistent will limit the number of -persistent connctions that each PHP process will keep open between +persistent connections that each PHP process will keep open between HTTP requests. Any further oci_pconnect() calls once this limit is reached will be treated as oci_connect() calls. -Is it still recommended that DRCP users modify the connection pool +It is still recommended that DRCP users modify the connection pool settings of the database to control resource usage. Non-DRCP users should consider setting oci8.persistent_timeout to close idle connections. -- PHP CVS Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
