php/archived-doc-en
1
0
Fork 0
mirror of https://github.com/php/doc-en.git synced 2026-03-24 07:42:10 +01:00
Code Issues Packages Projects Releases Wiki Activity

Remove PHP 5 related descriptions in OCI8 section (#2492)

Browse Source
This commit is contained in:
魔王卷子
2023-06-19 21:21:17 +08:00
committed by GitHub
parent 2fa74a5512
commit 5e41012cfd
29 changed files with 20 additions and 274 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
reference/oci8/configure.xml
View File

@@ -290,12 +290,6 @@ extension=oci8.so
<para>
For example, <option role="configure">--with-oci8=shared,instantclient,/usr/lib/oracle/19.9/client/lib</option>
</para>
<para>
Note that Oracle Instant Client support first appeared in PHP
4.3.11 and 5.0.4 and originally used the option
<option role="configure">--with-oci8-instant-client</option> to
configure PHP.
</para>
</listitem>
<listitem>
<para>

6
reference/oci8/connection.xml
View File

@@ -72,7 +72,7 @@
the application.
</para>
<para>
From OCI8 1.3, persistent connections can be
Persistent connections can 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
@@ -95,7 +95,7 @@
<section>
<title>DRCP Connection Pooling</title>
<para>
PHP from 5.3 (PECL OCI8 1.3) supports Oracle Database Resident
PHP supports Oracle Database Resident
Connection Pooling (DRCP). DRCP allows more efficient use of
database machine memory and provides high scalability. No, or
minimal, application changes are needed to use DRCP.
@@ -126,7 +126,7 @@
white paper</link> contains background information on DRCP.
</para>
<para>
To use DRCP, install the OCI8 1.3 (or later) extension and Oracle 11g (or later)
To use DRCP, install the OCI8 extension and Oracle 11g (or later)
libraries and then follow these steps:
</para>
<para>

7
reference/oci8/constants.xml
View File

@@ -41,8 +41,7 @@
<entry><constant>OCI_CRED_EXT</constant></entry>
<entry>
Used with <function>oci_connect</function> for using
Oracles' External or OS authentication. Introduced in PHP
5.3 and PECL OCI8 1.3.4.
Oracles' External or OS authentication.
</entry>
</row>
<row xml:id="constant.oci-default">
@@ -98,7 +97,6 @@
automatically committed when using this mode. For
readability in new code, use this value instead of the
older, equivalent <constant>OCI_DEFAULT</constant> constant.
Introduced in PHP 5.3.2 (PECL OCI8 1.4).
</entry>
</row>
<row xml:id="constant.oci-num">
@@ -252,8 +250,7 @@
<entry><constant>OCI_B_NTY</constant></entry>
<entry>
Used with <function>oci_bind_by_name</function> when binding
named data types. Note: in PHP &lt; 5.0 it was called
<constant>OCI_B_SQLT_NTY</constant>.
named data types.
</entry>
</row>
<row xml:id="constant.oci-b-num">

2
reference/oci8/examples.xml
View File

@@ -174,7 +174,7 @@ $stid = oci_parse($conn, $sql);
$clob = oci_new_descriptor($conn, OCI_D_LOB);
oci_bind_by_name($stid, ":mykey", $mykey, 5);
oci_bind_by_name($stid, ":myclob", $clob, -1, OCI_B_CLOB);
oci_execute($stid, OCI_NO_AUTO_COMMIT); // use OCI_DEFAULT for PHP <= 5.3.1
oci_execute($stid, OCI_NO_AUTO_COMMIT);
$clob->save("A very long string");
oci_commit($conn);

2
reference/oci8/functions/oci-bind-by-name.xml
View File

@@ -224,7 +224,7 @@
<listitem>
<para>
<constant>SQLT_BOL</constant> or <constant>OCI_B_BOL</constant>
- for PL/SQL BOOLEANs (Requires OCI8 2.0.7 and Oracle Database 12c)
- for PL/SQL BOOLEANs (Requires Oracle Database 12c)
</para>
</listitem>
</itemizedlist>

9
reference/oci8/functions/oci-close.xml
View File

@@ -199,15 +199,6 @@ print $r; // displays the function return value "Finished"
underlying database connection is closed.
</para>
</note>
<note>
<para>
Prior to version PHP 5.1.2 (PECL OCI8
1.1) <function>oci_close</function> was a no-op. In more recent
versions it correctly closes the Oracle
connection. Use <link linkend="ini.oci8.old-oci-close-semantics">oci8.old_oci_close_semantics</link>
option to restore old behavior of this function.
</para>
</note>
<note>
<para>
The <function>oci_close</function> function does not close the

1
reference/oci8/functions/oci-commit.xml
View File

@@ -73,7 +73,6 @@ $conn = oci_connect('hr', 'welcome', 'localhost/XE');
$stid = oci_parse($conn, "INSERT INTO mysalary (id, name) VALUES (1, 'Chris')");
// The OCI_NO_AUTO_COMMIT flag tells Oracle not to commit the INSERT immediately
// Use OCI_DEFAULT as the flag for PHP <= 5.3.1. The two flags are equivalent
$r = oci_execute($stid, OCI_NO_AUTO_COMMIT);
if (!$r) {
$e = oci_error($stid);

4
reference/oci8/functions/oci-connect.xml
View File

@@ -26,10 +26,6 @@
See <link linkend="oci8.connection">Connection Handling</link> for general
information on connection management and connection pooling.
</para>
<para>
From PHP 5.1.2 (PECL OCI8 1.1) <function>oci_close</function> can
be used to close the connection.
</para>
<para>
The second and subsequent calls to <function>oci_connect</function>
with the same parameters will return the connection handle returned

7
reference/oci8/functions/oci-execute.xml
View File

@@ -75,10 +75,7 @@
</row>
<row>
<entry><constant>OCI_NO_AUTO_COMMIT</constant></entry>
<entry>Do not automatically commit changes. Prior to PHP
5.3.2 (PECL OCI8 1.4)
use <constant>OCI_DEFAULT</constant> which is equivalent
to <constant>OCI_NO_AUTO_COMMIT</constant>.</entry>
<entry>Do not automatically commit changes.</entry>
</row>
</tbody>
</tgroup>
@@ -188,7 +185,7 @@ $conn = oci_connect('hr', 'welcome', 'localhost/XE');
$stid = oci_parse($conn, 'INSERT INTO mytab (col1) VALUES (:bv)');
oci_bind_by_name($stid, ':bv', $i, 10);
for ($i = 1; $i <= 5; ++$i) {
oci_execute($stid, OCI_NO_AUTO_COMMIT); // use OCI_DEFAULT for PHP <= 5.3.1
oci_execute($stid, OCI_NO_AUTO_COMMIT);
}
oci_commit($conn); // commits all new values: 1, 2, 3, 4, 5

13
reference/oci8/functions/oci-field-is-null.xml
View File

@@ -93,19 +93,6 @@ oci_close($conn);
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocicolumnisnull</function> instead.
This name still can be used, it was left as alias of
<function>oci_field_is_null</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

12
reference/oci8/functions/oci-field-name.xml
View File

@@ -109,18 +109,6 @@ oci_close($conn);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocicolumnname</function> instead.
This name still can be used, it was left as alias of
<function>oci_field_name</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

12
reference/oci8/functions/oci-field-precision.xml
View File

@@ -98,18 +98,6 @@ oci_close($conn);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocicolumnprecision</function> instead.
This name still can be used, it was left as alias of
<function>oci_field_precision</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

12
reference/oci8/functions/oci-field-scale.xml
View File

@@ -98,18 +98,6 @@ oci_close($conn);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocicolumnscale</function> instead.
This name still can be used, it was left as alias of
<function>oci_field_scale</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

12
reference/oci8/functions/oci-field-size.xml
View File

@@ -111,18 +111,6 @@ oci_close($conn);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocicolumnsize</function> instead.
This name still can be used, it was left as alias of
<function>oci_field_size</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

13
reference/oci8/functions/oci-field-type-raw.xml
View File

@@ -91,19 +91,6 @@ oci_close($conn);
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocicolumntyperaw</function> instead.
This name still can be used, it was left as alias of
<function>oci_field_type_raw</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

12
reference/oci8/functions/oci-field-type.xml
View File

@@ -111,18 +111,6 @@ oci_close($conn);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocicolumntype</function> instead.
This name still can be used, it was left as alias of
<function>oci_field_type</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

8
reference/oci8/functions/oci-new-collection.xml
View File

@@ -90,14 +90,6 @@
The <classname>OCICollection</classname> class was called <classname>OCI-Collection</classname> prior to PHP 8 and OCI8 3.0.0.
</para>
</note>
<note>
<para>
In PHP versions before 5.0.0 you must use
<function>ocinewcollection</function> instead. This name still can be
used, it was left as alias of <function>oci_new_collection</function> for
downwards compatability. This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
</refentry>

13
reference/oci8/functions/oci-new-cursor.xml
View File

@@ -82,19 +82,6 @@ oci_close($conn);
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocinewcursor</function> instead.
This name still can be used, it was left as alias of
<function>oci_new_cursor</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

14
reference/oci8/functions/oci-new-descriptor.xml
View File

@@ -165,18 +165,6 @@ oci_free_statement($stmt);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocinewdescriptor</function> instead.
This name still can be used, it was left as alias of
<function>oci_new_descriptor</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -185,8 +173,6 @@ oci_free_statement($stmt);
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

14
reference/oci8/functions/oci-num-fields.xml
View File

@@ -79,21 +79,7 @@ oci_close($conn);
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocinumcols</function> instead.
This name still can be used, it was left as alias of
<function>oci_num_fields</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

8
reference/oci8/functions/oci-num-rows.xml
View File

@@ -88,14 +88,6 @@ oci_close($conn);
fetched to the buffer with <function>oci_fetch*</function> functions.
</para>
</note>
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ocirowcount</function> instead.
This name still can be used, it was left as alias of
<function>oci_num_rows</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
</refentry>

2
reference/oci8/functions/oci-pconnect.xml
View File

@@ -121,7 +121,7 @@ echo "</table>\n";
&reftitle.notes;
<note>
<simpara>
Starting with PHP 5.1.2 and PECL OCI8 1.1, the lifetime and
The lifetime and
maximum number of persistent Oracle connections per PHP process can be tuned by setting
the following configuration values: <link linkend="ini.oci8.persistent-timeout">oci8.persistent_timeout</link>,
<link linkend="ini.oci8.ping-interval">oci8.ping_interval</link> and

12
reference/oci8/functions/oci-result.xml
View File

@@ -92,18 +92,6 @@ oci_close($conn);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ociresult</function> instead.
This name still can be used, it was left as alias of
<function>oci_result</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

1
reference/oci8/functions/oci-rollback.xml
View File

@@ -74,7 +74,6 @@ $conn = oci_connect('hr', 'welcome', 'localhost/XE');
$stid = oci_parse($conn, "INSERT INTO mysalary (id, name) VALUES (1, 'Chris')");
// The OCI_NO_AUTO_COMMIT flag tells Oracle not to commit the INSERT immediately
// Use OCI_DEFAULT as the flag for PHP <= 5.3.1. The two flags are equivalent
$r = oci_execute($stid, OCI_NO_AUTO_COMMIT);
if (!$r) {
$e = oci_error($stid);

10
reference/oci8/functions/oci-server-version.xml
View File

@@ -64,16 +64,6 @@ oci_close($conn);
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ociserverversion</function> instead.
This old name still can be used. However it is deprecated and not recommended.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

34
reference/oci8/functions/oci-set-prefetch.xml
View File

@@ -96,39 +96,6 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL OCI8 1.4</entry>
<entry>
Before this release, <parameter>rows</parameter> must be &gt;= 1.
</entry>
</row>
<row>
<entry>PECL OCI8 1.3.4</entry>
<entry>
Before this release, prefetching was limited to the lesser
of <parameter>rows</parameter> rows and 1024
* <parameter>rows</parameter> bytes. The byte size
restriction has now been removed.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -232,7 +199,6 @@ oci_execute($stid);
// Display two rows, but don't prefetch any extra rows otherwise
// those extra rows would not be passed back to myproc_use_rc().
// A prefetch value of 0 is allowed in PHP 5.3.2 and PECL OCI8 1.4
oci_set_prefetch($refcur, 0);
oci_execute($refcur);
$row = oci_fetch_array($refcur);

2
reference/oci8/functions/oci-statement-type.xml
View File

@@ -59,7 +59,7 @@
</row>
<row>
<entry><literal>CALL</literal></entry>
<entry>Introduced in PHP 5.2.1 (PECL OCI8 1.2.3)</entry>
<entry/>
</row>
<row>
<entry><literal>CREATE</literal></entry>

33
reference/oci8/ini.xml
View File

@@ -20,43 +20,43 @@
<entry><link linkend="ini.oci8.connection-class">oci8.connection_class</link></entry>
<entry>""</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since PECL OCI8 1.3.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link></entry>
<entry>"100"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.1.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.oci8.events">oci8.events</link></entry>
<entry>Off</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.3.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.oci8.max-persistent">oci8.max_persistent</link></entry>
<entry>"-1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.1.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.oci8.old-oci-close-semantics">oci8.old_oci_close_semantics</link></entry>
<entry>Off</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.1. Deprecated as of PHP 8.1.0.</entry>
<entry>Deprecated as of PHP 8.1.0.</entry>
</row>
<row>
<entry><link linkend="ini.oci8.persistent-timeout">oci8.persistent_timeout</link></entry>
<entry>"-1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.1.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.oci8.ping-interval">oci8.ping_interval</link></entry>
<entry>"60"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.1.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.oci8.prefetch-lob-size">oci8.prefetch_lob_size</link></entry>
@@ -68,13 +68,13 @@
<entry><link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link></entry>
<entry>Off</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.1.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.oci8.statement-cache-size">oci8.statement_cache_size</link></entry>
<entry>"20"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since PECL OCI8 1.1.</entry>
<entry></entry>
</row>
</tbody>
</tgroup>
@@ -140,15 +140,6 @@
with <function>oci_set_prefetch</function> prior to statement
execution.
</para>
<para>
In PHP 5.3 (PECL OCI8 1.3.4) the default value was increased
from <literal>10</literal> to <literal>100</literal>.
</para>
<para>
In PHP 5.3.2 (PECL OCI8 1.4) the minimum value settable was
reduced from <literal>1</literal> to <literal>0</literal>,
allowing prefetching to be turned off.
</para>
<para>
When using Oracle Database 12<emphasis>c</emphasis> (or later), the prefetch
value set by PHP can be overridden by Oracle's
@@ -256,12 +247,6 @@
attempted to overcome.
</simpara>
</note>
<note>
<simpara>
In PHP 5.3 (PECL OCI8 1.3), persistent connections can be
closed with <function>oci_close</function>.
</simpara>
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.oci8.ping-interval">

13
reference/oci8/oldaliases/oci-internal-debug.xml
View File

@@ -47,19 +47,6 @@
This function was removed in PHP 8 and PECL OCI8 3.0.
</para>
</note>
<note>
<para>
This function is a no-op in PHP 5.6 and PECL OCI8 2.0. Use DTrace instead.
</para>
</note>
<note>
<para>
In PHP versions before 5.0.0 you must use <function>ociinternaldebug</function> instead.
This name still can be used, it was left as alias of
<function>oci_internal_debug</function> for downwards compatability.
This, however, is deprecated and not recommended.
</para>
</note>
</refsect1>
</refentry>