Documentation

Sqlsrv extends AbstractAdapter
in package

SQL Server database adapter class

Tags
category

Pop

author

Nick Sagona, III dev@nolainteractive.com

copyright

Copyright (c) 2009-2024 NOLA Interactive, LLC. (http://www.nolainteractive.com)

license

http://www.popphp.org/license New BSD License

version
6.5.0

Table of Contents

Properties

$connection  : mixed
Database connection object/resource
$database  : string|null
Database
$error  : mixed
Error string/object/resource
$info  : array<string|int, mixed>
Database info
$listener  : mixed
Query listener object/resource
$options  : array<string|int, mixed>
Database connection options
$profiler  : Profiler|null
Query profiler
$result  : mixed
Result object/resource
$statement  : mixed
Statement object/resource
$statementResult  : bool
Statement result
$statementString  : string|null
Prepared statement string
$transactionManager  : Manager|null
Transaction manager

Methods

__construct()  : mixed
Constructor
beginTransaction()  : Sqlsrv
Begin a transaction
bindParams()  : Sqlsrv
Bind parameters to a prepared SQL query
clearError()  : AbstractAdapter
Clear the error
clearProfiler()  : AbstractAdapter
Clear query profiler
commit()  : Sqlsrv
Commit a transaction
connect()  : Sqlsrv
Connect to the database
createSchema()  : Schema
Create Schema builder
createSql()  : Sql
Create SQL builder
delete()  : int
Directly execute a DELETE SQL query or prepared statement and return the results
disconnect()  : void
Disconnect from the database
escape()  : string
Escape the value
execute()  : Sqlsrv
Execute a prepared SQL query
executeSql()  : AbstractAdapter
Execute a SQL query or prepared statement with params
fetch()  : mixed
Fetch and return a row from the result
fetchAll()  : array<string|int, mixed>
Fetch and return all rows from the result
getConnection()  : mixed
Get the connection object/resource
getError()  : mixed
Get the error
getLastId()  : int
Return the last ID of the last query
getListener()  : mixed
Get query listener
getNumberOfAffectedRows()  : int
Return the number of affected rows from the last query
getNumberOfRows()  : int
Return the number of rows from the last query
getOptions()  : array<string|int, mixed>
Get database connection options
getProfiler()  : Profiler|null
Get query profiler
getResult()  : mixed
Get the result object/resource
getSqlSrvErrors()  : mixed
Get SQL Server errors
getStatement()  : mixed
Get the statement object/resource
getTables()  : array<string|int, mixed>
Return the tables in the database
getTransactionDepth()  : int
Get transaction depth
getVersion()  : string
Return the database version
hasError()  : bool
Determine whether or not there is an error
hasOptions()  : bool
Has database connection options
hasResult()  : bool
Determine whether or not a result resource exists
hasStatement()  : bool
Determine whether or not a statement resource exists
hasTable()  : bool
Return if the database has a table
insert()  : int
Directly execute an INSERT SQL query or prepared statement and return the results
isConnected()  : bool
Determine whether or not connected
isSuccess()  : bool
Check if transaction is success
isTransaction()  : bool
Check if adapter is in the middle of an open transaction
listen()  : mixed
Add query listener to the adapter
prepare()  : Sqlsrv
Prepare a SQL query
query()  : Sqlsrv
Execute a SQL query directly
rollback()  : Sqlsrv
Rollback a transaction
select()  : array<string|int, mixed>
Directly execute a SELECT SQL query or prepared statement and return the results
setError()  : AbstractAdapter
Set the error
setOptions()  : Sqlsrv
Set database connection options
setProfiler()  : AbstractAdapter
Set query profiler
throwError()  : void
Throw a database error exception
transaction()  : void
Execute complete transaction with the DB adapter
update()  : int
Directly execute an UPDATE SQL query or prepared statement and return the results
getTransactionManager()  : Manager
Return the transaction manager object, initialize on first use

Properties

$connection

Database connection object/resource

protected mixed $connection = null

$database

Database

protected string|null $database = null

$info

Database info

protected array<string|int, mixed> $info = []

$listener

Query listener object/resource

protected mixed $listener = null

$options

Database connection options

protected array<string|int, mixed> $options = []

$statement

Statement object/resource

protected mixed $statement = null

$statementResult

Statement result

protected bool $statementResult = false

$statementString

Prepared statement string

protected string|null $statementString = null

Methods

__construct()

Constructor

public __construct([array<string|int, mixed> $options = [] ]) : mixed

Instantiate the SQL Server database connection object

Parameters
$options : array<string|int, mixed> = []

beginTransaction()

Begin a transaction

public beginTransaction() : Sqlsrv
Return values
Sqlsrv

bindParams()

Bind parameters to a prepared SQL query

public bindParams(array<string|int, mixed> $params[, mixed $options = null ]) : Sqlsrv
Parameters
$params : array<string|int, mixed>
$options : mixed = null
Return values
Sqlsrv

connect()

Connect to the database

public connect([array<string|int, mixed> $options = [] ]) : Sqlsrv
Parameters
$options : array<string|int, mixed> = []
Return values
Sqlsrv

delete()

Directly execute a DELETE SQL query or prepared statement and return the results

public delete(string|Sql $sql[, array<string|int, mixed> $params = [] ]) : int
Parameters
$sql : string|Sql
$params : array<string|int, mixed> = []
Tags
throws
Exception
Return values
int

disconnect()

Disconnect from the database

public disconnect() : void

escape()

Escape the value

public escape([string|null $value = null ]) : string
Parameters
$value : string|null = null
Return values
string

executeSql()

Execute a SQL query or prepared statement with params

public executeSql(string|Sql $sql[, array<string|int, mixed> $params = [] ]) : AbstractAdapter
Parameters
$sql : string|Sql
$params : array<string|int, mixed> = []
Return values
AbstractAdapter

fetch()

Fetch and return a row from the result

public fetch() : mixed

fetchAll()

Fetch and return all rows from the result

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

getConnection()

Get the connection object/resource

public getConnection() : mixed

getLastId()

Return the last ID of the last query

public getLastId() : int
Return values
int

getNumberOfAffectedRows()

Return the number of affected rows from the last query

public getNumberOfAffectedRows() : int
Tags
throws
Exception
Return values
int

getNumberOfRows()

Return the number of rows from the last query

public getNumberOfRows() : int
Tags
throws
Exception
Return values
int

getOptions()

Get database connection options

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

getResult()

Get the result object/resource

public getResult() : mixed

getSqlSrvErrors()

Get SQL Server errors

public getSqlSrvErrors([bool $asString = true ]) : mixed
Parameters
$asString : bool = true

getStatement()

Get the statement object/resource

public getStatement() : mixed

getTables()

Return the tables in the database

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

getTransactionDepth()

Get transaction depth

public getTransactionDepth() : int
Return values
int

getVersion()

Return the database version

public getVersion() : string
Return values
string

hasError()

Determine whether or not there is an error

public hasError() : bool
Return values
bool

hasOptions()

Has database connection options

public hasOptions() : bool
Return values
bool

hasResult()

Determine whether or not a result resource exists

public hasResult() : bool
Return values
bool

hasStatement()

Determine whether or not a statement resource exists

public hasStatement() : bool
Return values
bool

hasTable()

Return if the database has a table

public hasTable(string $table) : bool
Parameters
$table : string
Return values
bool

insert()

Directly execute an INSERT SQL query or prepared statement and return the results

public insert(string|Sql $sql[, array<string|int, mixed> $params = [] ]) : int
Parameters
$sql : string|Sql
$params : array<string|int, mixed> = []
Tags
throws
Exception
Return values
int

isConnected()

Determine whether or not connected

public isConnected() : bool
Return values
bool

isSuccess()

Check if transaction is success

public isSuccess() : bool
Return values
bool

isTransaction()

Check if adapter is in the middle of an open transaction

public isTransaction() : bool
Return values
bool

listen()

Add query listener to the adapter

public listen(mixed $listener[, mixed $params = null ][, Profiler $profiler = new ProfilerProfiler() ]) : mixed
Parameters
$listener : mixed
$params : mixed = null
$profiler : Profiler = new ProfilerProfiler()

prepare()

Prepare a SQL query

public prepare(mixed $sql) : Sqlsrv
Parameters
$sql : mixed
Return values
Sqlsrv

query()

Execute a SQL query directly

public query(mixed $sql) : Sqlsrv
Parameters
$sql : mixed
Return values
Sqlsrv

select()

Directly execute a SELECT SQL query or prepared statement and return the results

public select(string|Sql $sql[, array<string|int, mixed> $params = [] ]) : array<string|int, mixed>
Parameters
$sql : string|Sql
$params : array<string|int, mixed> = []
Tags
throws
Exception
Return values
array<string|int, mixed>

setOptions()

Set database connection options

public setOptions(array<string|int, mixed> $options) : Sqlsrv
Parameters
$options : array<string|int, mixed>
Return values
Sqlsrv

throwError()

Throw a database error exception

public throwError([string|null $error = null ]) : void
Parameters
$error : string|null = null
Tags
throws
Exception

transaction()

Execute complete transaction with the DB adapter

public transaction(mixed $callable[, mixed $params = null ]) : void
Parameters
$callable : mixed
$params : mixed = null
Tags
throws
Exception

update()

Directly execute an UPDATE SQL query or prepared statement and return the results

public update(string|Sql $sql[, array<string|int, mixed> $params = [] ]) : int
Parameters
$sql : string|Sql
$params : array<string|int, mixed> = []
Tags
throws
Exception
Return values
int

getTransactionManager()

Return the transaction manager object, initialize on first use

protected getTransactionManager() : Manager
Return values
Manager 

        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results