What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

ora_plogon
Prev	XLIV. Oracle	Next

ora_plogon

Name

ora_plogon — Connects to an Oracle database using persistent connections.

Synopsis

resource ora_plogon(user, password); string user: Username string password: Password

Returns

Connection handle; FALSE on error

Description

Logs a user onto an Oracle database. The connection handle is passed on to other Oracle functions. If a connection already exists, the existing connection is reused; otherwise, a new connection is established. Persistent connections are handled by PHP internally and are reused when a new database connection is requested. Oracle has user-configurable limits on the maximum number of connections available; if a script error or busy web server exceeds the number of available connections, an error occurs. Consult with your database administrator and be sure to use the correct connection parameters in both Oracle and in PHP.

If connecting locally, only user and password need to be supplied; the SID is taken from the ORACLE_SID environment variable. If a remote connection is required using SQL*Net, specify the SID as derived from TNSNAMES.ORA following the username, in the format username@SID.

Warning

Transactions are not automatically committed at script end, as the database connection is not closed. If automatic commits are not used, it's very important to call ora_commit() to prevent Oracle running out of slots in the transaction tables.

Note

As of versions 3.0 and 4.0

Example

Example 898. Establish a persistent connection

// open a persistent connection
if (!$db = @ora_plogon("dev@ORCL","dev")) {
        $error = ora_error();
        printf("There was an error connecting. Error was: %s", $error);
        die();
}

$curs = ora_open($db);
ora_parse($curs,"SELECT * FROM phone_numbers");
ora_exec($curs);

Prev	Home	Next
ora_parse	Up	ora_rollback

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.