Documentation

SQLSrvStatement
in package
implements IteratorAggregate, Statement

SQL Server Statement.

Tags
since
2.3
author

Benjamin Eberlei kontakt@beberlei.de

Interfaces, Classes and Traits

IteratorAggregate
Statement
Statement interface.

Table of Contents

LAST_INSERT_ID_SQL  = ';SELECT SCOPE_IDENTITY() AS LastInsertId;'
Append to any INSERT query to retrieve the last insert id.
$conn  : resource
The SQLSRV Resource.
$defaultFetchClass  : string
The name of the default class to instantiate when fetch mode is \PDO::FETCH_CLASS.
$defaultFetchClassCtorArgs  : string
The constructor arguments for the default class to instantiate when fetch mode is \PDO::FETCH_CLASS.
$defaultFetchMode  : mixed
The fetch style.
$fetchMap  : array<string|int, mixed>
Translations.
$lastInsertId  : LastInsertId|null
The last insert ID.
$result  : bool
Indicates whether the statement is in the state when fetching results is possible
$sql  : string
The SQL statement to execute.
$stmt  : resource
The SQLSRV statement resource.
$types  : array<string|int, mixed>
Bound parameter types.
$variables  : array<string|int, mixed>
References to the variables bound as statement parameters.
__construct()  : mixed
bindParam()  : bool
Binds a PHP variable to a corresponding named (not supported by mysqli driver, see comment below) or question mark placeholder in the SQL statement that was use to prepare the statement. Unlike PDOStatement->bindValue(), the variable is bound as a reference and will only be evaluated at the time that PDOStatement->execute() is called.
bindValue()  : bool
Binds a value to a corresponding named (not supported by mysqli driver, see comment below) or positional placeholder in the SQL statement that was used to prepare the statement.
closeCursor()  : mixed
{@inheritdoc}
columnCount()  : mixed
{@inheritdoc}
errorCode()  : string
Fetches the SQLSTATE associated with the last operation on the statement handle.
errorInfo()  : array<string|int, mixed>
Fetches extended error information associated with the last operation on the statement handle.
execute()  : bool
Executes a prepared statement
fetch()  : mixed
{@inheritdoc}
fetchAll()  : mixed
{@inheritdoc}
fetchColumn()  : mixed
{@inheritdoc}
getIterator()  : mixed
{@inheritdoc}
rowCount()  : int
Returns the number of rows affected by the last DELETE, INSERT, or UPDATE statement executed by the corresponding object.
setFetchMode()  : mixed
{@inheritdoc}
prepare()  : resource
Prepares SQL Server statement resource

Constants

LAST_INSERT_ID_SQL

Append to any INSERT query to retrieve the last insert id.

public string LAST_INSERT_ID_SQL = ';SELECT SCOPE_IDENTITY() AS LastInsertId;'

Properties

$defaultFetchClass

The name of the default class to instantiate when fetch mode is \PDO::FETCH_CLASS.

private string $defaultFetchClass = '\stdClass'

$defaultFetchClassCtorArgs

The constructor arguments for the default class to instantiate when fetch mode is \PDO::FETCH_CLASS.

private string $defaultFetchClassCtorArgs = array()

$defaultFetchMode

The fetch style.

private mixed $defaultFetchMode = PDO::FETCH_BOTH

$fetchMap

Translations.

private static array<string|int, mixed> $fetchMap = array(PDO::FETCH_BOTH => SQLSRV_FETCH_BOTH, PDO::FETCH_ASSOC => SQLSRV_FETCH_ASSOC, PDO::FETCH_NUM => SQLSRV_FETCH_NUMERIC)

$result

Indicates whether the statement is in the state when fetching results is possible

private bool $result = false

$types

Bound parameter types.

private array<string|int, mixed> $types = array()

$variables

References to the variables bound as statement parameters.

private array<string|int, mixed> $variables = array()

Methods

__construct()

public __construct(resource $conn, string $sql[, LastInsertId|null $lastInsertId = null ]) : mixed
Parameters
$conn : resource
$sql : string
$lastInsertId : LastInsertId|null = null
Return values
mixed

bindParam()

Binds a PHP variable to a corresponding named (not supported by mysqli driver, see comment below) or question mark placeholder in the SQL statement that was use to prepare the statement. Unlike PDOStatement->bindValue(), the variable is bound as a reference and will only be evaluated at the time that PDOStatement->execute() is called.

public bindParam(mixed $column, mixed &$variable[, mixed $type = null ][, mixed $length = null ]) : bool
Parameters
$column : mixed

Parameter identifier. For a prepared statement using named placeholders, this will be a parameter name of the form :name. For a prepared statement using question mark placeholders, this will be the 1-indexed position of the parameter.

$variable : mixed

Name of the PHP variable to bind to the SQL statement parameter.

$type : mixed = null

Explicit data type for the parameter using the PDO::PARAM_* constants. To return an INOUT parameter from a stored procedure, use the bitwise OR operator to set the PDO::PARAM_INPUT_OUTPUT bits for the data_type parameter.

$length : mixed = null

You must specify maxlength when using an OUT bind so that PHP allocates enough memory to hold the returned value.

Return values
bool

TRUE on success or FALSE on failure.

bindValue()

Binds a value to a corresponding named (not supported by mysqli driver, see comment below) or positional placeholder in the SQL statement that was used to prepare the statement.

public bindValue(mixed $param, mixed $value[, mixed $type = null ]) : bool
Parameters
$param : mixed

Parameter identifier. For a prepared statement using named placeholders, this will be a parameter name of the form :name. For a prepared statement using question mark placeholders, this will be the 1-indexed position of the parameter.

$value : mixed

The value to bind to the parameter.

$type : mixed = null

Explicit data type for the parameter using the PDO::PARAM_* constants.

Return values
bool

TRUE on success or FALSE on failure.

closeCursor()

{@inheritdoc}

public closeCursor() : mixed
Return values
mixed

columnCount()

{@inheritdoc}

public columnCount() : mixed
Return values
mixed

errorCode()

Fetches the SQLSTATE associated with the last operation on the statement handle.

public errorCode() : string
Return values
string

The error code string.

errorInfo()

Fetches extended error information associated with the last operation on the statement handle.

public errorInfo() : array<string|int, mixed>
Return values
array<string|int, mixed>

The error info array.

execute()

Executes a prepared statement

public execute([mixed $params = null ]) : bool
Parameters
$params : mixed = null

An array of values with as many elements as there are bound parameters in the SQL statement being executed.

Return values
bool

TRUE on success or FALSE on failure.

fetch()

{@inheritdoc}

public fetch([mixed $fetchMode = null ]) : mixed
Parameters
$fetchMode : mixed = null
Return values
mixed

fetchAll()

{@inheritdoc}

public fetchAll([mixed $fetchMode = null ]) : mixed
Parameters
$fetchMode : mixed = null
Return values
mixed

fetchColumn()

{@inheritdoc}

public fetchColumn(mixed $columnIndex) : mixed
Parameters
$columnIndex : mixed
Return values
mixed

getIterator()

{@inheritdoc}

public getIterator() : mixed
Return values
mixed

rowCount()

Returns the number of rows affected by the last DELETE, INSERT, or UPDATE statement executed by the corresponding object.

public rowCount() : int
Return values
int

The number of rows.

setFetchMode()

{@inheritdoc}

public setFetchMode(mixed $fetchMode[, mixed $arg2 = null ][, mixed $arg3 = null ]) : mixed
Parameters
$fetchMode : mixed
$arg2 : mixed = null
$arg3 : mixed = null
Return values
mixed

Search results