cvs: /phpdoc/functions oci8.sgml

sr Fri Sep 3 05:47:13 1999 EDT Modified files: /phpdoc/functions oci8.sgml Log: Added comment about connecting via tnsnames.ora. Changed OCI{N,P}Logon parameters from conn to user, pass, db. Index: phpdoc/functions/oci8.sgml diff -u phpdoc/functions/oci8.sgml:1.8 phpdoc/functions/oci8.sgml:1.9 --- phpdoc/functions/oci8.sgml:1.8 Tue Aug 31 04:32:19 1999 +++ phpdoc/functions/oci8.sgml Fri Sep 3 05:47:13 1999 @@ -208,16 +208,22 @@ <funcdef>int <function>OCILogon</function></funcdef> <paramdef>string <parameter>username</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> - <paramdef>string <parameter><optional>ORACLE_SID</optional></parameter></paramdef> + <paramdef>string <parameter><optional>db</optional></parameter></paramdef> </funcsynopsis> <para> - <function>OCILogon</function> returns an connection identified - needed for most other OCI calls. If the optional third parameter is not specified, - PHP uses the environment variable ORACLE_SID to determine which database to connect - to. Connections are shared at the page level when using <function>OCILogon</function>. - This means that commits and rollbacks apply to all open transactions in the page, - even if you have created multiple connections. + <function>OCILogon</function> returns an connection identifier + needed for most other OCI calls. The optional third parameter + can either contain the name of the local Oracle instance or the + name of the entry in tnsnames.ora to which you want to connect. + If the optional third parameter is not specified, PHP uses the + environment variables ORACLE_SID (Oracle instance) or TWO_TASK + (tnsnames.ora) to determine which database to connect to. </para> + <para>Connections are shared at the page level when using + <function>OCILogon</function>. This means that commits and + rollbacks apply to all open transactions in the page, even if you + have created multiple connections. + </para> <para> This example demonstrates how the connections are shared. <example> @@ -319,12 +325,18 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>OCIPLogon</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> + <paramdef>string <parameter>username</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + <paramdef>string <parameter><optional>db</optional></parameter></paramdef> </funcsynopsis> <para> - <function>OCIPLogon</function> Creates a persistent connection to an Oracle 8 database - and logs on. If the optional third parameter is not specified, PHP uses the environment - variable ORACLE_SID to determine which database to connect to. + <function>OCIPLogon</function> creates a persistent connection to + an Oracle 8 database and logs on. The optional third parameter + can either contain the name of the local Oracle instance or the + name of the entry in tnsnames.ora to which you want to connect. + If the optional third parameter is not specified, PHP uses the + environment variables ORACLE_SID (Oracle instance) or TWO_TASK + (tnsnames.ora) to determine which database to connect to. </para> <simpara> See also <function>OCILogon</function> and @@ -341,17 +353,27 @@ <title>Description</title> <funcsynopsis> <funcdef>int <function>OCINLogon</function></funcdef> - <paramdef>int <parameter>conn</parameter></paramdef> + <paramdef>string <parameter>username</parameter></paramdef> + <paramdef>string <parameter>password</parameter></paramdef> + <paramdef>string <parameter><optional>db</optional></parameter></paramdef> </funcsynopsis> + <para> + <function>OCINLogon</function> creates a new connection to an + Oracle 8 database and logs on. The optional third parameter can + either contain the name of the local Oracle instance or the name + of the entry in tnsnames.ora to which you want to connect. If + the optional third parameter is not specified, PHP uses the + environment variables ORACLE_SID (Oracle instance) or TWO_TASK + (tnsnames.ora) to determine which database to connect to. + </para> <para> - <function>OCINLogon</function> Creates a new connection to an Oracle 8 database - and logs on. If the optional third parameter is not specified, PHP uses the environment - variable ORACLE_SID to determine which database to connect to. <function>OCINLogon</function> - forces a new connection. This is should be used if you need to isolate a set of transactions. - By default, connections are shared at the page level if using <function>OCILogon</function> - or at the web server process level if using <function>OCIPLogon</function>. If you have - multiple connections open using <function>OCINLogon</function>, all commits and - rollbacks apply to the specified connection only.. + <function>OCINLogon</function> forces a new connection. This + should be used if you need to isolate a set of transactions. By + default, connections are shared at the page level if using + <function>OCILogon</function> or at the web server process level + if using <function>OCIPLogon</function>. If you have multiple + connections open using <function>OCINLogon</function>, all + commits and rollbacks apply to the specified connection only. </para> <para> This example demonstrates how the connections are separated.