Abstract Class Zend_Db_Adapter_Abstract

Description

Class for connecting to SQL databases and performing common operations.

  • abstract:
  • license: New BSD License
  • copyright: Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)

Located in /Zend/Db/Adapter/Abstract.php (line 40)


	
			
Direct descendents
Class Description
 class Zend_Db_Adapter_Db2
 class Zend_Db_Adapter_Mysqli Class for connecting to SQL databases and performing common operations.
 class Zend_Db_Adapter_Oracle
Abstract class Zend_Db_Adapter_Pdo_Abstract Class for connecting to SQL databases and performing common operations using PDO.
Variable Summary
 array $_config
 object|resource|null $_connection
 integer $_fetchMode
Method Summary
 void __construct ([ $config = array()])
 void closeConnection ()
 bool commit ()
 int delete (mixed $table, [mixed $where = ''])
 array describeTable (string $tableName, [string $schemaName = null])
 array fetchAll (string|Zend_Db_Select $sql, [mixed $bind = array()])
 string fetchAssoc (string|Zend_Db_Select $sql, [mixed $bind = array()])
 array fetchCol (string|Zend_Db_Select $sql, [mixed $bind = array()])
 string fetchOne (string|Zend_Db_Select $sql, [mixed $bind = array()])
 string fetchPairs (string|Zend_Db_Select $sql, [mixed $bind = array()])
 array fetchRow (string|Zend_Db_Select $sql, [mixed $bind = array()])
 object|resource|null getConnection ()
 int getFetchMode ()
 int insert (mixed $table,  $bind)
 integer lastInsertId ([string $tableName = null], [string $primaryKey = 'id'])
 integer lastSequenceId (string $sequenceName)
 string limit (mixed $sql, integer $count, [integer $offset = 0])
 array listTables ()
 integer nextSequenceId (string $sequenceName)
 Zend_Db_Statment|PDOStatement prepare (string|Zend_Db_Select $sql)
 Zend_Db_Statement query (string|Zend_Db_Select $sql, [mixed $bind = array()])
 mixed quote (mixed $value)
 string quoteColumnAs (string|array|Zend_Db_Expr $ident, string $alias)
 string quoteIdentifier (string|array|Zend_Db_Expr $ident)
 mixed quoteInto (string $text, mixed $value)
 string quoteTableAs (string|array|Zend_Db_Expr $ident, string $alias)
 bool rollBack ()
 void setFetchMode (integer $mode)
 int update (mixed $table,  $bind, [mixed $where = ''])
 void _commit ()
 void _connect ()
 string _quote (string $value)
 string _quoteIdentifier (string $value)
 string _quoteIdentifierAs (string|array|Zend_Db_Expr $ident, [string $alias = null], [string $as = ' AS '])
 void _rollBack ()
Variables
array $_config = array() (line 48)

User-provided configuration

  • access: protected

Redefined in descendants as:
object|resource|null $_connection = null (line 69)

Database connection

  • access: protected
integer $_fetchMode = Zend_Db::FETCH_ASSOC (line 55)

Fetch mode

  • access: protected
Zend_Db_Profiler $_profiler (line 62)

Query profiler

  • access: protected
Methods
Constructor __construct (line 86)

Constructor.

$config is an array of key/value pairs containing configuration options. These options are common to most adapters:

dbname => (string) The name of the database to user (required) username => (string) Connect to the database as this username (optional). password => (string) Password associated with the username (optional). host => (string) What host to connect to (default 127.0.0.1).

  • access: public
  • throws: Zend_Db_Adapter_Exception
void __construct ([ $config = array()])
  • array $config: An array of configuration keys.

Redefined in descendants as:
beginTransaction (line 168)

Leave autocommit mode and begin a transaction.

  • return: True
  • access: public
bool beginTransaction ()
closeConnection (line 739)

Force the connection to close.

  • access: public
  • abstract:
void closeConnection ()

Redefined in descendants as:
commit (line 182)

Commit a transaction and return to autocommit mode.

  • return: True
  • access: public
bool commit ()
delete (line 284)

Deletes table rows based on a WHERE clause.

  • return: The number of affected rows.
  • access: public
int delete (mixed $table, [mixed $where = ''])
  • mixed $table: The table to update.
  • mixed $where: OPTIONAL $where DELETE WHERE clause.
describeTable (line 725)

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 database or 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

  • access: public
  • abstract:
array describeTable (string $tableName, [string $schemaName = null])
  • string $tableName
  • string $schemaName: OPTIONAL

Redefined in descendants as:
fetchAll (line 329)

Fetches all SQL result rows as a sequential array.

Uses the current fetchMode for the adapter.

  • access: public
array fetchAll (string|Zend_Db_Select $sql, [mixed $bind = array()])
  • string|Zend_Db_Select $sql: An SQL SELECT statement.
  • mixed $bind: Data to bind into SELECT placeholders.
fetchAssoc (line 346)

Fetches all SQL result rows as an associative array.

The first column is the key, the entire row array is the value.

  • access: public
string fetchAssoc (string|Zend_Db_Select $sql, [mixed $bind = array()])
  • string|Zend_Db_Select $sql: An SQL SELECT statement.
  • mixed $bind: Data to bind into SELECT placeholders.
fetchCol (line 366)

Fetches the first column of all SQL result rows as an array.

The first column in each row is used as the array key.

  • access: public
array fetchCol (string|Zend_Db_Select $sql, [mixed $bind = array()])
  • string|Zend_Db_Select $sql: An SQL SELECT statement.
  • mixed $bind: Data to bind into SELECT placeholders.
fetchOne (line 400)

Fetches the first column of the first row of the SQL result.

  • access: public
string fetchOne (string|Zend_Db_Select $sql, [mixed $bind = array()])
  • string|Zend_Db_Select $sql: An SQL SELECT statement.
  • mixed $bind: Data to bind into SELECT placeholders.
fetchPairs (line 383)

Fetches all SQL result rows as an array of key-value pairs.

The first column is the key, the second column is the value.

  • access: public
string fetchPairs (string|Zend_Db_Select $sql, [mixed $bind = array()])
  • string|Zend_Db_Select $sql: An SQL SELECT statement.
  • mixed $bind: Data to bind into SELECT placeholders.
fetchRow (line 415)

Fetches the first row of the SQL result.

Uses the current fetchMode for the adapter.

  • access: public
array fetchRow (string|Zend_Db_Select $sql, [mixed $bind = array()])
  • string|Zend_Db_Select $sql: An SQL SELECT statement.
  • mixed $bind: Data to bind into SELECT placeholders.
getConnection (line 112)

Returns the underlying database connection object or resource.

If not presently connected, this initiates the connection.

  • access: public
object|resource|null getConnection ()
getFetchMode (line 316)

Get the fetch mode.

  • access: public
int getFetchMode ()
getProfiler (line 123)

Returns the profiler for this adapter.

  • access: public
Zend_Db_Profiler getProfiler ()
getQuoteIdentifierSymbol (line 589)

Returns the symbol the adapter uses for delimited identifiers.

  • access: public
string getQuoteIdentifierSymbol ()

Redefined in descendants as:
insert (line 212)

Inserts a table row with specified data.

  • return: The number of affected rows.
  • access: public
int insert (mixed $table,  $bind)
  • mixed $table: The table to insert data into.
  • array $bind: Column-value pairs.
lastInsertId (line 763)

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.

  • access: public
  • abstract:
integer lastInsertId ([string $tableName = null], [string $primaryKey = 'id'])
  • string $tableName: OPTIONAL Name of table.
  • string $primaryKey: OPTIONAL Name of primary key column.

Redefined in descendants as:
lastSequenceId (line 602)

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.

  • access: public
integer lastSequenceId (string $sequenceName)
  • string $sequenceName

Redefined in descendants as:
limit (line 795)

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

  • access: public
  • abstract:
string limit (mixed $sql, integer $count, integer $offset)
  • mixed $sql
  • integer $count
  • integer $offset

Redefined in descendants as:
listTables (line 696)

Returns a list of the tables in the database.

  • access: public
  • abstract:
array listTables ()

Redefined in descendants as:
nextSequenceId (line 615)

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.

  • access: public
integer nextSequenceId (string $sequenceName)
  • string $sequenceName

Redefined in descendants as:
prepare (line 747)

Prepare a statement and return a PDOStatement-like object.

  • access: public
  • abstract:
Zend_Db_Statment|PDOStatement prepare (string|Zend_Db_Select $sql)

Redefined in descendants as:
query (line 135)

Prepares and executes an SQL statement with bound data.

  • return: (may also be PDOStatement in the case of PDO)
  • access: public
Zend_Db_Statement query (string|Zend_Db_Select $sql, [mixed $bind = array()])
  • string|Zend_Db_Select $sql: The SQL statement with placeholders.
  • mixed $bind: An array of data to bind to the placeholders.

Redefined in descendants as:
quote (line 442)

Safely quotes a value for an SQL statement.

If an array is passed as the value, the array values are quoted and then returned as a comma-separated string.

  • return: An SQL-safe quoted value (or string of separated values).
  • access: public
mixed quote (mixed $value)
  • mixed $value: The value to quote.
quoteColumnAs (line 516)

Quote a column identifier and alias.

  • return: The quoted identifier and alias.
  • access: public
string quoteColumnAs (string|array|Zend_Db_Expr $ident, string $alias)
  • string|array|Zend_Db_Expr $ident: The identifier or expression.
  • string $alias: An alias for the column.
quoteIdentifier (line 504)

Quotes an identifier.

Accepts a string representing a qualified indentifier. For Example:

  1.  $adapter->quoteIdentifier('myschema.mytable')
Returns: "myschema"."mytable"

Or, an array of one or more identifiers that may form a qualified identifier:

  1.  $adapter->quoteIdentifier(array('myschema','my.table'))
Returns: "myschema"."my.table"

The actual quote character surrounding the identifiers may vary depending on the adapter.

  • return: The quoted identifier.
  • access: public
string quoteIdentifier (string|array|Zend_Db_Expr $ident)
quoteInto (line 478)

Quotes a value and places into a piece of text at a placeholder.

The placeholder is a question-mark; all placeholders will be replaced with the quoted value. For example:

  1.  $text "WHERE date < ?";
  2.  $date "2005-01-02";
  3.  $safe $sql->quoteInto($text$date);

  • return: An SQL-safe quoted value placed into the orignal text.
  • access: public
mixed quoteInto (string $text, mixed $value)
  • string $text: The text with a placeholder.
  • mixed $value: The value to quote.
quoteTableAs (line 528)

Quote a table identifier and alias.

  • return: The quoted identifier and alias.
  • access: public
string quoteTableAs (string|array|Zend_Db_Expr $ident, string $alias)
  • string|array|Zend_Db_Expr $ident: The identifier or expression.
  • string $alias: An alias for the table.

Redefined in descendants as:
rollBack (line 196)

Roll back a transaction and return to autocommit mode.

  • return: True
  • access: public
bool rollBack ()
select (line 306)

Creates and returns a new Zend_Db_Select object for this adapter.

  • access: public
Zend_Db_Select select ()
setFetchMode (line 785)

Set the fetch mode.

  • access: public
  • abstract:
void setFetchMode (integer $mode)
  • integer $mode

Redefined in descendants as:
update (line 247)

Updates table rows with specified data based on a WHERE clause.

  • return: The number of affected rows.
  • access: public
int update (mixed $table,  $bind, [mixed $where = ''])
  • mixed $table: The table to update.
  • array $bind: Column-value pairs.
  • mixed $where: UPDATE WHERE clause.
_beginTransaction (line 768)

Begin a transaction.

  • access: protected
  • abstract:
void _beginTransaction ()

Redefined in descendants as:
_commit (line 773)

Commit a transaction.

  • access: protected
  • abstract:
void _commit ()

Redefined in descendants as:
_connect (line 732)

Creates a connection to the database.

  • access: protected
  • abstract:
void _connect ()

Redefined in descendants as:
_quote (line 428)

Quote a raw string.

  • return: Quoted string
  • access: protected
string _quote (string $value)
  • string $value: Raw string

Redefined in descendants as:
_quoteIdentifier (line 578)

Quote an identifier.

  • return: The quoted identifier and alias.
  • access: protected
string _quoteIdentifier (string $value)
  • string $value: The identifier or expression.
_quoteIdentifierAs (line 541)

Quote an identifier and an optional alias.

  • return: The quoted identifier and alias.
  • access: protected
string _quoteIdentifierAs (string|array|Zend_Db_Expr $ident, [string $alias = null], [string $as = ' AS '])
  • string|array|Zend_Db_Expr $ident: The identifier or expression.
  • string $alias: An optional alias.
  • string $as: The string to add between the identifier/expression and the alias.
_rollBack (line 778)

Roll-back a transaction.

  • access: protected
  • abstract:
void _rollBack ()

Redefined in descendants as:

Documentation generated on Fri, 06 Apr 2007 18:14:45 -0700 by phpDocumentor 1.3.1