PHP Developer''''s Dictionary- P94 pptx

PHP Developer’s Dictionary
IT-SC book
465
string ora_columntype (int cursor, int column)


Description
The ora_columntype() function, which is available with PHP 3.0 and higher, returns
the column type for the column in cursor . The possible return values are VARCHAR2,
VARCHAR
,
CHAR
,
NUMBER
,
LONG
,
LONG RAW
,
ROWID
,
DATE
, and
CURSOR
.
ora_commit()
Syntax

int ora_commit (int conn)

Description
The
ora_commit()
function, which is available with PHP 3.0 and higher, commits the
transaction associated with the
conn
connection. A transaction begins at the start of
a connection, or since the last commit or rollback, or when autocommit is turned off.
ora_commitoff()
Syntax

int ora_commitoff (int conn)


Description
The
ora_commitoff()
function, which is available with PHP 3.0 and higher, disables
autocommit for connection indicated by the conn
parameter.
ora_commiton()
Syntax

int ora_commiton (int conn)


Description
PHP Developer’s Dictionary
IT-SC book
466

The
ora_commiton()
function, which is available with PHP 3.0 and higher, enables
autocommit for connection indicated by the
conn
parameter.
ora_error()
Syntax

string ora_error (int cursor_or_connection)


Description
The
ora_error()
function, which is available with PHP 3.0 and higher, returns an
error message that was generated on the connection or cursor . The format of the
message is
XXX
-
NNNN
, where
XXX
represents the origin of the error and
NNNN

represents the error itself. For information on the error message, see Oracle's
oerr
ora
command.

ora_errorcode()
Syntax

int ora_errorcode (int cursor_or_connection)


Description
The
ora_errorcode()
function, which is available with PHP 3.0 and higher, returns
the numeric error code generated for the last statement executed with the given
cursor or connection .
ora_exec()
Syntax

int ora_exec (int cursor)


Description
The
ora_exec()
function, which is available with PHP 3.0 and higher, executes a
parsed statement against the specified cursor .
ora_fetch()
PHP Developer’s Dictionary
IT-SC book
467
Syntax

int ora_fetch (int cursor)

Description
The
ora_fetch()
function, which is available with PHP 3.0 and higher, fetches a row
of data from the given cursor . The return value is TRUE on success and FALSE
otherwise.
ora_getcolumn()
Syntax

mixed ora_getcolumn (int cursor, mixed column)


Description
The
ora_getcolumn()
function, which is available with PHP 3.0 and higher, returns
the data at the column position in the specified cursor . The return value will be
FALSE if an error occurred or if other non-error conditions occurred, such as no data
(NULL) or an empty string is found.
ora_logoff()
Syntax

int ora_logoff (int connection)


Description
The
ora_logoff()

function, which is available with PHP 3.0 and higher, closes the
connection referenced by the connection parameter. The return value is TRUE on
success and FALSE otherwise. The function will also effectively log out the user if
that is the user's only connection.
ora_logon()
Syntax

PHP Developer’s Dictionary
IT-SC book
468
int ora_logon (string user, string password)


Description
The ora_logon() function, which is available with PHP 3.0 and higher, creates a
connection to an Oracle database with the given username and password . To include
the TNS name, append @<TNSNAME> to the user name. The return value is a
connection index or FALSE on failure. If using non-ASCII characters, be sure to set
NLS_LANG in your environment.
ora_open()
Syntax

int ora_open (int connection)


Description
The
ora_open()
function, which is available with PHP 3.0 and higher, opens a cursor
for the specified connection . The return value is a cursor index or FALSE on failure.

ora_parse()
Syntax

int ora_parse (int cursor_ind, string sql_statement, int defer)


Description
The
ora_parse()
function, which is available with PHP 3.0 and higher, parses the
SQL statement or PL/SQL block referenced by the sql_statement parameter, and
associates it with the cursor specified by the cursor_ind parameter. The return
value is TRUE on success and FALSE otherwise.
ora_rollback()
Syntax

int ora_rollback (int connection)


PHP Developer’s Dictionary
IT-SC book
469
Description
The ora_rollback() function, which is available with PHP 3.0 and higher, rolls back
the transaction associated with the connection . The return value is TRUE on
success and FALSE otherwise.
Oracle 8
The following functions enable you to access an Oracle 7 or 8 database by using the
Oracle 8 interface library. These functions offer additional functionality not found in
the standard Oracle extensions, including the binding of local and global variables to

Oracle placeholders, along with full support for LOB, FILE, and ROWIDs.
ocidefinebyname()
Syntax

int ocidefinebyname (int stmt, string column-name,
mixed &variable, [, int type])


Description
The
ocidefinebyname()
function, which was added in PHP 3.0.7 and PHP 4.0,
fetches columns into the user-defined variables. Note that the column-name
parameter should be in uppercase, and that if you define a variable that doesn't exist
in your statement, no error will be given.
ocibindbyname()
Syntax

int ocibindbyname (int stmt, string ph_name,
mixed &variable, int length, [,int type])


Description
The
ocibindbyname()
function, which was added in PHP 3.0.7 and PHP 4.0, binds
the PHP variable indicated by the &variable parameter to the placeholder ph_name
for the given SQL stmt . The length parameter is used to indicate the maximum
length for the bind, whereas a –1 value causes the length to be set to &variable's
max length. The optional

type
parameter sets the descriptor to use and can take the
values
OCI_B_FILE
(binary file),
OCI_B_CFILE
(character file),
OCI_B_CLOB

(character LOB),
OCI_B_BLOB
(binary LOB), and
OCI_B_ROWID
(ROWID). Whether the
variable is input or output is determined at runtime.