Db/Adapter/Sqlsrv.php

category: Zend
copyright: Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
license: http://framework.zend.com/license/new-bsd New BSD License
package: Zend_Db
subpackage: Adapter
version: $Id: Sqlsrv.php 21197 2010-02-24 16:12:53Z rob $
Classes: Zend_Db_Adapter_Sqlsrv

Description

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.

Zend_Db_Adapter_Sqlsrv
jump to top

Extends from: Zend_Db_Adapter_Abstract
category: Zend
copyright: Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
license: http://framework.zend.com/license/new-bsd New BSD License
package: Zend_Db
subpackage: Adapter
Properties: $_config; $_lastInsertId; $_lastInsertSQL; $_numericDataTypes; $_defaultStmtClass
Methods: _connect; _checkRequiredOptions; setTransactionIsolationLevel; isConnected; closeConnection; prepare; _quote; lastInsertId; insert; listTables; describeTable; _beginTransaction; _commit; _rollBack; setFetchMode; limit; supportsParameters; getServerVersion

Description

Properties

$_config
jump to class

array $_config = 'array'

User-provided configuration.

Basic keys are:

username => (string) Connect to the database as this username. password => (string) Password associated with the username. dbname => The name of the local SQL Server instance

Details

$_config: array
visibility: protected
default: array
final: false
static: false

$_defaultStmtClass
jump to class

string $_defaultStmtClass = 'Zend_Db_Statement_Sqlsrv'

Default class name for a DB statement.

Details

$_defaultStmtClass: string
visibility: protected
default: Zend_Db_Statement_Sqlsrv
final: false
static: false

$_lastInsertId
jump to class

int $_lastInsertId = ''

Last insert id from INSERT query

Details

$_lastInsertId: int
visibility: protected
default
final: false
static: false

$_lastInsertSQL
jump to class

string $_lastInsertSQL = 'SELECT SCOPE_IDENTITY() as Current_Identity'

Query used to fetch last insert id

Details

$_lastInsertSQL: string
visibility: protected
default: SELECT SCOPE_IDENTITY() as Current_Identity
final: false
static: false

$_numericDataTypes
jump to class

array $_numericDataTypes = 'array'

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

Details

$_numericDataTypes: array
Associative array of datatypes to values 0, 1, or 2.
visibility: protected
default: array
final: false
static: false

Methods

_beginTransaction
jump to class

_beginTransaction(
          
          )
        
        :
        void

Leave autocommit mode and begin a transaction.

Details

visibility: protected
final: false
static: false
throws

_checkRequiredOptions
jump to class

_checkRequiredOptions(
          array $config
          )
        
        :

Check for config options that are mandatory.

Throw exceptions if any are missing.

Arguments

$config: array

Details

visibility: protected
final: false
static: false
throws

_commit
jump to class

_commit(
          
          )
        
        :
        void

Commit a transaction and return to autocommit mode.

Details

visibility: protected
final: false
static: false
throws

_connect
jump to class

_connect(
          
          )
        
        :
        void

Creates a connection resource.

Details

visibility: protected
final: false
static: false
throws

_quote
jump to class

_quote(
          string $value
          )
        
        :
        string

Quote a raw string.

Arguments

$value: string
Raw string

Output

string: Quoted string

Details

visibility: protected
final: false
static: false

_rollBack
jump to class

_rollBack(
          
          )
        
        :
        void

Roll back a transaction and return to autocommit mode.

Details

visibility: protected
final: false
static: false
throws

closeConnection
jump to class

closeConnection(
          
          )
        
        :
        void

Force the connection to close.

Details

visibility: public
final: false
static: false

describeTable
jump to class

describeTable(
          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

Arguments

$tableName: string
$schemaName: string
OPTIONAL

Output

array

Details

visibility: public
final: false
static: false
todo: Discover integer unsigned property.

getServerVersion
jump to class

getServerVersion(
          
          )
        
        :
        string

Retrieve server version in PHP style

Output

string

Details

visibility: public
final: false
static: false

insert
jump to class

insert(
          mixed $table, array $bind
          )
        
        :
        int

Inserts a table row with specified data.

Arguments

$table: mixed
The table to insert data into.
$bind: array
Column-value pairs.

Output

int: The number of affected rows.

Details

visibility: public
final: false
static: false

isConnected
jump to class

isConnected(
          
          )
        
        :
        boolean

Test if a connection is active

Output

boolean

Details

visibility: public
final: false
static: false

lastInsertId
jump to class

lastInsertId(
          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.

Arguments

$tableName: string
OPTIONAL Name of table.
$primaryKey: string
OPTIONAL Name of primary key column.

Output

string

Details

visibility: public
final: false
static: false

limit
jump to class

limit(
          string $sql, integer $count, integer $offset
              =
              0
          )
        
        :
        string

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

Arguments

$sql: string
$count: integer
$offset: integer
OPTIONAL

Output

string

Details

visibility: public
final: false
static: false
throws

listTables
jump to class

listTables(
          
          )
        
        :
        array

Returns a list of the tables in the database.

Output

array

Details

visibility: public
final: false
static: false

prepare
jump to class

prepare(
          string $sql
          )
        
        :
        Zend_Db_Statement_Sqlsrv

Returns an SQL statement for preparation.

Arguments

$sql: string
The SQL statement with placeholders.

Output

Zend_Db_Statement_Sqlsrv

Details

visibility: public
final: false
static: false

setFetchMode
jump to class

setFetchMode(
          integer $mode
          )
        
        :
        void

Set the fetch mode.

Arguments

$mode: integer
A fetch mode.

Details

visibility: public
final: false
static: false
throws
todo: Support FETCH_CLASS and FETCH_INTO.

setTransactionIsolationLevel
jump to class

setTransactionIsolationLevel(
          integer|null $level
              =
              null
          )
        
        :
        true

Set the transaction isoltion level.

Arguments

$level: integernull
A fetch mode from SQLSRV_TXN_*.

Output

true

Details

visibility: public
final: false
static: false
throws

supportsParameters
jump to class

supportsParameters(
          string $type
          )
        
        :
        bool

Check if the adapter supports real SQL parameters.

Arguments

$type: string
'positional' or 'named'

Output

bool

Details

visibility: public
final: false
static: false

API Documentation

Db/Adapter/Sqlsrv.php

Description

Zend_Db_Adapter_Sqlsrvjump to top

Description

Properties

$_configjump to class

Details

$_defaultStmtClassjump to class

Details

$_lastInsertIdjump to class

Details

$_lastInsertSQLjump to class

Details

$_numericDataTypesjump to class

Details

Methods

_beginTransactionjump to class

Details

_checkRequiredOptionsjump to class

Arguments

Details

_commitjump to class

Details

_connectjump to class

Details

_quotejump to class

Arguments

Output

Details

_rollBackjump to class

Details

closeConnectionjump to class

Details

describeTablejump to class

Arguments

Output

Details

getServerVersionjump to class

Output

Details

insertjump to class

Arguments

Output

Details

isConnectedjump to class

Output

Details

lastInsertIdjump to class

Arguments

Output

Details

limitjump to class

Arguments

Output

Details

listTablesjump to class

Output

Details

preparejump to class

Arguments

Output

Details

setFetchModejump to class

Arguments

Details

setTransactionIsolationLeveljump to class

Arguments

Output

Details

supportsParametersjump to class

Arguments

Output

Details

Zend_Db_Adapter_Sqlsrv
jump to top

$_config
jump to class

$_defaultStmtClass
jump to class

$_lastInsertId
jump to class

$_lastInsertSQL
jump to class

$_numericDataTypes
jump to class

_beginTransaction
jump to class

_checkRequiredOptions
jump to class

_commit
jump to class

_connect
jump to class

_quote
jump to class

_rollBack
jump to class

closeConnection
jump to class

describeTable
jump to class

getServerVersion
jump to class

insert
jump to class

isConnected
jump to class

lastInsertId
jump to class

limit
jump to class

listTables
jump to class

prepare
jump to class

setFetchMode
jump to class

setTransactionIsolationLevel
jump to class

supportsParameters
jump to class