[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.7r2=1.1.2.2.2.1.2.8diff_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
[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.5r2=1.1.2.2.2.1.2.6diff_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.6r2=1.1.2.8.2.7diff_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 @@ activeyes/active /lead - date2008-04-17/date - time16:00:00/time + date2008-06-19/date + time12:00:00/time version - release1.3.2/release - api1.3.2/api + release1.3.3/release + api1.3.3/api /version stability - releasebeta/release - apibeta/api + releasestable/release + apistable/api /stability license uri=http://www.php.net/license;PHP/license notes -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 /notes contents dir name=/ @@ -154,6 +151,14 @@ file name=connect.inc role=test / file name=connect_old.phpt role=test / file name=connect.phpt role=test / +file name=connect_scope1.phpt role=test / +file name=connect_scope2.phpt role=test / +file name=connect_scope_try1.phpt role=test / +file name=connect_scope_try2.phpt role=test / +file name=connect_scope_try3.phpt role=test / +file name=connect_scope_try4.phpt role=test / +
