Merge pull request #15 from cjbj/oci8ini

Add sample oci8.ini file (Issue #14)

Author: cjbj

README.md

@@ -1,6 +1,6 @@
-# The OCI8 Extension
+# The PHP OCI8 Extension
 
-Use the OCI8 extension to access Oracle Database.
+Use the PHP OCI8 extension to access Oracle Database.
 
 Documentation is at https://www.php.net/oci8
 
@@ -12,14 +12,23 @@ Use `pecl install oci8-3.0.1` to install for PHP 8.0.
 
 Use `pecl install oci8-2.2.0` to install for PHP 7.
 
-The OCI8 extension can be linked with Oracle client libraries from Oracle
-Database 11.2 or later.  These libraries are found in your database
+The PHP OCI8 extension can be linked with Oracle client libraries from Oracle
+Database 11.2 or later. These libraries are found in your database
 installation, or in the free Oracle Instant Client from
-https://www.oracle.com/database/technologies/instant-client.html
+  https://www.oracle.com/database/technologies/instant-client.html
 Install the 'Basic' or 'Basic Light' Instant Client package. If building from
 source, then also install the SDK package.
 
-Oracle's standard cross-version connectivity applies.  For example, PHP OCI8
-linked with Instant Client 19c can connect to Oracle Database 11.2 onward.  See
-Oracle's note "Oracle Client / Server Interoperability Support" (ID 207303.1)
-for details.
+Oracle Database's standard cross-version connectivity applies. For example, PHP
+OCI8 linked with Instant Client 19c can connect to Oracle Database 11.2 or
+later. See Oracle Support's note "Oracle Client / Server Interoperability
+Support" (ID 207303.1) for details.
+
+A sample configuration php.ini file is at
+  https://github.com/php/pecl-database-oci8/blob/main/oci8.ini
+
+From PHP 8.4 the source code for PHP OCI8 is at:
+  https://github.com/php/pecl-database-oci8/
+
+For earlier versions, see the PHP source, e.g.:
+  https://github.com/php/php-src/tree/PHP-8.3/ext/oci8

oci8.ini

@@ -0,0 +1,76 @@
+[OCI8]
+
+; Required if your installation does not already add this line.
+;extension=oci8
+; On Windows use:
+;extension=oci8_19   ; Use with Oracle Database 19c Instant Client
+
+; Connection: Enables privileged connections using external credentials
+; (OCI_SYSOPER, OCI_SYSDBA)
+; https://php.net/oci8.privileged-connect
+;
+;oci8.privileged_connect = Off
+
+; Connection: The maximum number of persistent OCI8 connections per process.
+; Using -1 means no limit.
+; https://php.net/oci8.max-persistent
+;
+;oci8.max_persistent = -1
+
+; Connection: The maximum number of seconds a process is allowed to maintain an
+; idle persistent connection. Using -1 means idle persistent connections will
+; be maintained forever.
+; https://php.net/oci8.persistent-timeout
+;
+;oci8.persistent_timeout = -1
+
+; Connection: The number of seconds that must pass before issuing an internal
+; round-trip ping from OCI8 to the database when oci_pconnect() is called. If
+; the internally-chosen connection is not usable, it is destroyed and different
+; connection returned to the application. When set to 0, each oci_pconnect()
+; will cause a ping. Using -1 disables pings completely.
+; https://php.net/oci8.ping-interval
+;
+;oci8.ping_interval = 60
+
+; Connection: For Oracle Database Resident Connection Pooling (DRCP), set this
+; to a user-chosen connection class string. To use DRCP: (i) this parameter
+; should be set to the same value for all web servers running the same
+; application, (ii) the DRCP pool must be started in the database, and (iii)
+; the connection string must also specify to use a pooled server.
+; https://www.php.net/manual/oci8.configuration.php#ini.oci8.connection-class
+;
+;oci8.connection_class =
+
+; High Availability: Using On lets PHP receive Fast Application Notification
+; (FAN) events generated when a database node fails. The database must also be
+; configured to post FAN events.
+; https://www.php.net/manual/en/oci8.configuration.php#ini.oci8.events
+;
+;oci8.events = Off
+
+; Tuning: This option enables statement caching, and specifies how many
+; statements to cache. Using 0 disables statement caching.
+; https://php.net/oci8.statement-cache-size
+;
+;oci8.statement_cache_size = 20
+
+; Tuning: Enables row prefetching and sets the default number of rows that will
+; be fetched automatically after statement execution. Tuning this can improve
+; performance by reducing round-trips.
+; https://php.net/oci8.default-prefetch
+;
+;oci8.default_prefetch = 100
+
+; Tuning: Sets the amount of LOB data that is internally returned from Oracle
+; Database when an Oracle LOB locator is initially retrieved as part of a
+; query. Setting this can improve performance by reducing round-trips.
+; https://www.php.net/manual/oci8.configuration.php#ini.oci8.prefetch-lob-size
+;
+;oci8.prefetch_lob_size = 0
+
+; Compatibility: Using On means oci_close() will not close oci_connect() and
+; oci_new_connect() connections.
+; https://php.net/oci8.old-oci-close-semantics
+;
+;oci8.old_oci_close_semantics = Off

package.xml

@@ -436,6 +436,7 @@ Oracle's standard cross-version connectivity applies.  For example, PHP OCI8 lin
    <file name="php_oci8_int.h" role="src" />
    <file name="oci8.stub.php" role="src" />
    <file name="oci8_arginfo.h" role="src" />
+   <file name="oci8.ini" role="doc" />
    <file name="README.md" role="doc" />
   </dir> <!-- / -->
  </contents>