Db/Adapter/Oracle.php

Show: PublicProtectedPrivateinherited
Table of Contents
Zend Framework
LICENSE This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.
Category
Zend  
Copyright
Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  
Package
Zend_Db  
Subpackage
Adapter  
Version
$Id$  

\Zend_Db_Adapter_Oracle

Package: Zend_Db\Adapter
Class for connecting to SQL databases and performing common operations.
Parent(s)
\Zend_Db_Adapter_Abstract
Category
Zend  
Copyright
Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  

Properties

>VPropertyprotectedarray $_config = array('dbname' => null, 'username' => null, 'password' => null, 'persistent' => false)
User-provided configuration.
Basic keys are: username => (string) Connect to the database as this username. password => (string) Password associated with the username. dbname => Either the name of the local Oracle instance, or the name of the entry in tnsnames.ora to which you want to connect. persistent => (boolean) Set TRUE to use a persistent connection
Default valuearray('dbname' => null, 'username' => null, 'password' => null, 'persistent' => false)Details
Type
array
>VPropertyprotectedstring $_defaultStmtClass = 'Zend_Db_Statement_Oracle'
Default class name for a DB statement.
Default value'Zend_Db_Statement_Oracle'Details
Type
string
>VPropertyprotectedinteger $_execute_mode = null
Default valuenullDetails
Type
integer
>VPropertyprotectedboolean $_lobAsString = null
Check if LOB field are returned as string instead of OCI-Lob object
Default valuenullDetails
Type
boolean
>VPropertyprotectedarray $_numericDataTypes = array(\Zend_Db::INT_TYPE => \Zend_Db::INT_TYPE, \Zend_Db::BIGINT_TYPE => \Zend_Db::BIGINT_TYPE, \Zend_Db::FLOAT_TYPE => \Zend_Db::FLOAT_TYPE, 'BINARY_DOUBLE' => \Zend_Db::FLOAT_TYPE, 'BINARY_FLOAT' => \Zend_Db::FLOAT_TYPE, 'NUMBER' => \Zend_Db::FLOAT_TYPE)
Keys are UPPERCASE SQL datatypes or the constants Zend_Db::INT_TYPE, Zend_Db::BIGINT_TYPE, or Zend_Db::FLOAT_TYPE.
Values are: 0 = 32-bit integer 1 = 64-bit integer 2 = float or decimal
Default valuearray(\Zend_Db::INT_TYPE => \Zend_Db::INT_TYPE, \Zend_Db::BIGINT_TYPE => \Zend_Db::BIGINT_TYPE, \Zend_Db::FLOAT_TYPE => \Zend_Db::FLOAT_TYPE, 'BINARY_DOUBLE' => \Zend_Db::FLOAT_TYPE, 'BINARY_FLOAT' => \Zend_Db::FLOAT_TYPE, 'NUMBER' => \Zend_Db::FLOAT_TYPE)Details
Type
array

Methods

methodprotected_beginTransaction() : void

Leave autocommit mode and begin a transaction.

methodprotected_commit() : void

Commit a transaction and return to autocommit mode.

Throws
ExceptionDescription
\Zend_Db_Adapter_Oracle_Exception
methodprotected_connect() : void

Creates a connection resource.

Throws
ExceptionDescription
\Zend_Db_Adapter_Oracle_Exception
methodpublic_getExecuteMode() : int

Returns
TypeDescription
int
methodprotected_quote(string $value) : string

Quote a raw string.

Parameters
NameTypeDescription
$valuestring

Raw string

Returns
TypeDescription
stringQuoted string
methodprotected_rollBack() : void

Roll back a transaction and return to autocommit mode.

Throws
ExceptionDescription
\Zend_Db_Adapter_Oracle_Exception
methodprivate_setExecuteMode(integer $mode) : void

Parameters
NameTypeDescription
$modeinteger
Throws
ExceptionDescription
\Zend_Db_Adapter_Oracle_Exception
methodpubliccloseConnection() : void

Force the connection to close.

methodpublicdescribeTable(string $tableName, string $schemaName = null) : array

Returns the column descriptions for a table.

The return value is an associative array keyed by the column name, as returned by the RDBMS. The value of each array element is an associative array with the following keys: SCHEMA_NAME => string; name of schema TABLE_NAME => string; COLUMN_NAME => string; column name COLUMN_POSITION => number; ordinal position of column in table DATA_TYPE => string; SQL datatype name of column DEFAULT => string; default expression of column, null if none NULLABLE => boolean; true if column can have nulls LENGTH => number; length of CHAR/VARCHAR SCALE => number; scale of NUMERIC/DECIMAL PRECISION => number; precision of NUMERIC/DECIMAL UNSIGNED => boolean; unsigned property of an integer type PRIMARY => boolean; true if column is part of the primary key PRIMARY_POSITION => integer; position of column in primary key IDENTITY => integer; true if column is auto-generated with unique values
Parameters
NameTypeDescription
$tableNamestring
$schemaNamestring

OPTIONAL

Returns
TypeDescription
array
Details
Todo
Discover integer unsigned property.  
methodpublicgetLobAsString() : boolean

Return whether or not LOB are returned as string

Returns
TypeDescription
boolean
methodpublicgetServerVersion() : string

Retrieve server version in PHP style

Returns
TypeDescription
string
methodpublicisConnected() : boolean

Test if a connection is active

Returns
TypeDescription
boolean
methodpubliclastInsertId(string $tableName = null, string $primaryKey = null) : string

Gets the last ID generated automatically by an IDENTITY/AUTOINCREMENT column.

As a convention, on RDBMS brands that support sequences (e.g. Oracle, PostgreSQL, DB2), this method forms the name of a sequence from the arguments and returns the last id generated by that sequence. On RDBMS brands that support IDENTITY/AUTOINCREMENT columns, this method returns the last value generated for such a column, and the table name argument is disregarded. Oracle does not support IDENTITY columns, so if the sequence is not specified, this method returns null.
Parameters
NameTypeDescription
$tableNamestring

OPTIONAL Name of table.

$primaryKeystring

OPTIONAL Name of primary key column.

Returns
TypeDescription
string
methodpubliclastSequenceId(string $sequenceName) : string

Return the most recent value from the specified sequence in the database.

This is supported only on RDBMS brands that support sequences (e.g. Oracle, PostgreSQL, DB2). Other RDBMS brands return null.
Parameters
NameTypeDescription
$sequenceNamestring
Returns
TypeDescription
string
methodpubliclimit(string $sql, integer $count, integer $offset = 0) : string

Adds an adapter-specific LIMIT clause to the SELECT statement.

Parameters
NameTypeDescription
$sqlstring
$countinteger
$offsetinteger

OPTIONAL

Returns
TypeDescription
string
Throws
ExceptionDescription
\Zend_Db_Adapter_Oracle_Exception
methodpubliclistTables() : array

Returns a list of the tables in the database.

Returns
TypeDescription
array
methodpublicnextSequenceId(string $sequenceName) : string

Generate a new value from the specified sequence in the database, and return it.

This is supported only on RDBMS brands that support sequences (e.g. Oracle, PostgreSQL, DB2). Other RDBMS brands return null.
Parameters
NameTypeDescription
$sequenceNamestring
Returns
TypeDescription
string
methodpublicprepare(string $sql) : \Zend_Db_Statement_Oracle

Returns an SQL statement for preparation.

Parameters
NameTypeDescription
$sqlstring

The SQL statement with placeholders.

Returns
TypeDescription
\Zend_Db_Statement_Oracle
methodpublicquoteTableAs(string | array | \Zend_Db_Expr $ident, string $alias = null, boolean $auto = false) : string

Quote a table identifier and alias.

Parameters
NameTypeDescription
$identstring | array | \Zend_Db_Expr

The identifier or expression.

$aliasstring

An alias for the table.

$autoboolean

If true, heed the AUTO_QUOTE_IDENTIFIERS config option.

Returns
TypeDescription
stringThe quoted identifier and alias.
methodpublicsetFetchMode(integer $mode) : void

Set the fetch mode.

Parameters
NameTypeDescription
$modeinteger

A fetch mode.

Throws
ExceptionDescription
\Zend_Db_Adapter_Oracle_Exception
Details
Todo
Support FETCH_CLASS and FETCH_INTO.  
methodpublicsetLobAsString( $lobAsString) : \Zend_Db_Adapter_Oracle

Activate/deactivate return of LOB as string

Parameters
NameTypeDescription
$lobAsString
Returns
TypeDescription
\Zend_Db_Adapter_Oracle
methodpublicsupportsParameters(string $type) : bool

Check if the adapter supports real SQL parameters.

Parameters
NameTypeDescription
$typestring

'positional' or 'named'

Returns
TypeDescription
bool
Documentation was generated by phpDocumentor 2.2.0 .