reference/oci8/functions/oci-connect.xml
5e41012cfdf8f2eff5fa56de446c7656afac536c
...
...
@@ -9,24 +9,22 @@
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>resource</type><methodname>oci_connect</methodname>
12
+
<type class="union"><type>resource</type><type>false</type></type><methodname>oci_connect</methodname>
13
13
<methodparam><type>string</type><parameter>username</parameter></methodparam>
14
14
<methodparam><type>string</type><parameter>password</parameter></methodparam>
15
-
<methodparam choice="opt"><type>string</type><parameter>connection_string</parameter></methodparam>
16
-
<methodparam choice="opt"><type>string</type><parameter>character_set</parameter></methodparam>
17
-
<methodparam choice="opt"><type>int</type><parameter>session_mode</parameter></methodparam>
15
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>connection_string</parameter><initializer>&null;</initializer></methodparam>
16
+
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>""</initializer></methodparam>
17
+
<methodparam choice="opt"><type>int</type><parameter>session_mode</parameter><initializer><constant>OCI_DEFAULT</constant></initializer></methodparam>
18
18
</methodsynopsis>
19
19
<para>
20
20
Returns a connection identifier needed for most other OCI8 operations.
21
21
</para>
22
22
<para>
23
-
See <link linkend="oci8.connection">Connection Handling</link> for
24
-
general information on connection management and connection
25
-
pooling.
26
-
</para>
27
-
<para>
28
-
From PHP 5.1.2 (PECL OCI8 1.1) <function>oci_close</function> can
29
-
be used to close the connection.
23
+
For performance, most applications should use persistent connections
24
+
with <function>oci_pconnect</function> instead
25
+
of <function>oci_connect</function>.
26
+
See <link linkend="oci8.connection">Connection Handling</link> for general
27
+
information on connection management and connection pooling.
30
28
</para>
31
29
<para>
32
30
The second and subsequent calls to <function>oci_connect</function>
...
...
@@ -66,7 +64,7 @@
66
64
</listitem>
67
65
</varlistentry>
68
66
<varlistentry>
69
-
<term><parameter>character_set</parameter></term>
67
+
<term><parameter>encoding</parameter></term>
70
68
<listitem>
71
69
&oci.charset;
72
70
</listitem>
...
...
@@ -88,6 +86,28 @@
88
86
</para>
89
87
</refsect1>
90
88

89
+
<refsect1 role="changelog">
90
+
&reftitle.changelog;
91
+
<informaltable>
92
+
<tgroup cols="2">
93
+
<thead>
94
+
<row>
95
+
<entry>&Version;</entry>
96
+
<entry>&Description;</entry>
97
+
</row>
98
+
</thead>
99
+
<tbody>
100
+
<row>
101
+
<entry>8.0.0, PECL OCI8 3.0.0</entry>
102
+
<entry>
103
+
<parameter>connection_string</parameter> is now nullable.
104
+
</entry>
105
+
</row>
106
+
</tbody>
107
+
</tgroup>
108
+
</informaltable>
109
+
</refsect1>
110
+

91
111
<refsect1 role="examples">
92
112
&reftitle.examples;
93
113
<para>
...
...
@@ -312,12 +332,6 @@ echo "c2 is $c2<br>\n";
312
332
troubleshooting information.
313
333
</para>
314
334
</note>
315
-
<note>
316
-
<para>
317
-
In PHP versions before 5.0.0 use <function>ocilogon</function>
318
-
instead. &oci.name.compat.note;
319
-
</para>
320
-
</note>
321
335
</refsect1>
322
336

323
337
<refsect1 role="seealso">
...
...
@@ -332,7 +346,6 @@ echo "c2 is $c2<br>\n";
332
346
</refsect1>
333
347

334
348
</refentry>
335
-

336
349
<!-- Keep this comment at the end of the file
337
350
Local variables:
338
351
mode: sgml
...
...
@@ -353,4 +366,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
353
366
vim: et tw=78 syn=sgml
354
367
vi: ts=1 sw=1
355
368
-->
356
-

357
369