SqlServerConnection

класс SqlServerConnection расширяет Connection (View source)

Трейты

Свойства

protected PDO\|Closure	$pdo	Активное подключение PDO.	из Connection
protected PDO\|Closure	$readPdo	Активное подключение PDO, используемое для чтений.	из Connection
protected string	$database	Имя подключенной базы данных.	из Connection
protected string	$tablePrefix	Префикс таблицы для подключения.	из Connection
protected array	$config	Параметры конфигурации подключения к базе данных.	из Connection
protected callable	$reconnector	Инстанс реконнектора для подключения.	из Connection
protected Grammar	$queryGrammar	Реализация синтаксического анализатора запросов.	из Connection
protected Grammar	$schemaGrammar	Реализация синтаксического анализатора схемы.	из Connection
protected Processor	$postProcessor	Реализация обработчика запросов после выполнения.	из Connection
protected Dispatcher	$events	Инстанс диспетчера событий.	из Connection
protected int	$fetchMode	Режим извлечения по умолчанию для подключения.	из Connection
protected int	$transactions	Количество активных транзакций.	из Connection
protected int	$recordsModified	Указывает, были ли внесены изменения в базу данных.	из Connection
protected array	$queryLog	Все запросы, выполненные к подключению.	из Connection
protected bool	$loggingQueries	Указывает, ведется ли регистрация запросов.	из Connection
protected bool	$pretending	Указывает, находится ли подключение в режиме "сухого запуска".	из Connection
protected Connection	$doctrineConnection	Инстанс подключения Doctrine.	из Connection
static protected array	$resolvers	Резолверы подключений.	из Connection

Методы

bool	causedByDeadlock(Exception $e) Определить, было ли данное исключение вызвано тупиком.	из DetectsDeadlocks
bool	causedByLostConnection(Throwable $e) Определить, было ли данное исключение вызвано потерей соединения.	из DetectsLostConnections
mixed	transaction(Closure $callback, int $attempts = 1) Выполнить замыкание в рамках транзакции.
void	handleTransactionException(Exception $e, int $currentAttempt, int $maxAttempts) Обработать исключение, возникшее при выполнении транзакционного оператора.	из ManagesTransactions
void	beginTransaction() Начать новую базу данных транзакции.	из ManagesTransactions
void	createTransaction() Создать транзакцию в базе данных.	из ManagesTransactions
void	createSavepoint() Создать точку сохранения в базе данных.	из ManagesTransactions
void	handleBeginTransactionException(Throwable $e) Обработать исключение, возникшее при начале транзакции.	из ManagesTransactions
void	commit() Зафиксировать активную базу данных транзакции.	из ManagesTransactions
void	rollBack(int\|null $toLevel = null) Отменить активную базу данных транзакции.	из ManagesTransactions
void	performRollBack(int $toLevel) Выполнить откат в базе данных.	из ManagesTransactions
handleRollBackException(Exception $e) Обработать исключение, возникшее при откате.	из ManagesTransactions
int	transactionLevel() Получить количество активных транзакций.	из ManagesTransactions
void	__construct(PDO\|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = []) Создать новый экземпляр подключения к базе данных.	из Connection
void	useDefaultQueryGrammar() Установить синтаксический анализатор запросов по умолчанию.	из Connection
Grammar	getDefaultQueryGrammar() Получить экземпляр синтаксического анализатора запросов по умолчанию.
void	useDefaultSchemaGrammar() Установить синтаксический анализатор схем по умолчанию.	из Connection
Grammar	getDefaultSchemaGrammar() Получить экземпляр синтаксического анализатора схем по умолчанию.
void	useDefaultPostProcessor() Установить обработчик запросов по умолчанию.	из Connection
Processor	getDefaultPostProcessor() Получить экземпляр обработчика запросов по умолчанию.
Builder	getSchemaBuilder() Получить экземпляр генератора схемы для подключения.
Builder	table(string $table) Начать флюэнтный запрос к таблице базы данных.	из Connection
Builder	query() Получить новый экземпляр билдера запросов.	из Connection
mixed	selectOne(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить оператор select и вернуть один результат.	из Connection
array	selectFromWriteConnection(string $query, array $bindings = []) Выполнить оператор select в базе данных.	из Connection
array	select(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить оператор select в базе данных.	из Connection
Generator	cursor(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить оператор select в базе данных и вернуть генератор.	из Connection
PDOStatement	prepared(PDOStatement $statement) Настроить оператор подготовленного PDO.	из Connection
PDO	getPdoForSelect(bool $useReadPdo = true) Получить подключение PDO для запроса select.	из Connection

bool	insert(string $query, array $bindings = []) Выполнить операцию вставки в базу данных.	из Connection
int	update(string $query, array $bindings = []) Выполнить операцию обновления в базе данных.	из Connection
int	delete(string $query, array $bindings = []) Выполнить операцию удаления из базы данных.	из Connection
bool	statement(string $query, array $bindings = []) Выполнить SQL-запрос и вернуть логическое значение результата.	из Connection
int	affectingStatement(string $query, array $bindings = []) Выполнить SQL-запрос и получить количество изменённых строк.	из Connection
bool	unprepared(string $query) Выполнить неподготовленный SQL-запрос к соединению PDO.	из Connection
array	pretend(Closure $callback) Выполнить заданный обратный вызов в режиме «сухого запуска».	из Connection
array	withFreshQueryLog(Closure $callback) Выполнить заданный обратный вызов в режиме «сухого запуска».	из Connection
void	bindValues(PDOStatement $statement, array $bindings) Связать значения с их параметрами в данном операторе.	из Connection
array	prepareBindings(array $bindings) Подготовить параметры запроса для выполнения.	из Connection
mixed	run(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос и записать контекст его выполнения.	из Connection
mixed	runQueryCallback(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос.	из Connection
void	logQuery(string $query, array $bindings, float\|null $time = null) Залогировать запрос в журнале запросов соединения.	из Connection
float	getElapsedTime(int $start) Получить время, прошедшее с заданного момента.	из Connection
mixed	handleQueryException(Exception $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса.	из Connection
mixed	tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса, произошедшее во время его выполнения.	из Connection
void	reconnect() Подключиться к базе данных заново.	из Connection
void	reconnectIfMissingConnection() Подключиться к базе данных заново, если соединение PDO отсутствует.	из Connection
void	disconnect() Отключиться от базового соединения PDO.	из Connection
void	listen(Closure $callback) Зарегистрировать слушателя запросов базы данных с соединением.	из Connection
array\|null	fireConnectionEvent(string $event) Сгенерировать событие для этого соединения.	из Connection
void	event(mixed $event) Сгенерировать указанное событие, если это возможно.	из Connection
Expression	raw(mixed $value) Получить новое выражение необработанного запроса.	из Connection
void	recordsHaveBeenModified(bool $value = true) Указать, были ли изменены какие-либо записи.	из Connection
bool	isDoctrineAvailable() Доступен ли Doctrine?	из Connection
Column	getDoctrineColumn(string $table, string $column) Получить экземпляр Doctrine Schema Column.	из Connection
AbstractSchemaManager	getDoctrineSchemaManager() Получить менеджер схемы Doctrine DBAL для соединения.	из Connection
Connection	getDoctrineConnection() Получить экземпляр соединения Doctrine DBAL.	из Connection
PDO	getPdo() Получить текущее соединение PDO.	из Connection
PDO	getReadPdo() Получить текущее соединение PDO, используемое для чтения.	из Connection

$this	setPdo(PDO\|Closure\|null $pdo) Установить соединение PDO.	from Connection
$this	setReadPdo(PDO\|Closure\|null $pdo) Установить соединение PDO, используемое для чтения.	from Connection
$this	setReconnector(callable $reconnector) Установить экземпляр повторного подключения к соединению.	from Connection
string\|null	getName() Получить имя базы данных.	from Connection
mixed	getConfig(string\|null $option = null) Получить опцию из параметров конфигурации.	from Connection
string	getDriverName() Получить имя драйвера PDO.	from Connection
Grammar	getQueryGrammar() Получить синтаксический анализатор запросов, используемый соединением.	from Connection
$this	setQueryGrammar(Grammar $grammar) Установить синтаксический анализатор запросов, используемый соединением.	from Connection
Grammar	getSchemaGrammar() Получить синтаксический анализатор схем, используемый соединением.	from Connection
$this	setSchemaGrammar(Grammar $grammar) Установить синтаксический анализатор схем, используемый соединением.	from Connection
Processor	getPostProcessor() Получить обработчик запросов, используемый соединением.	from Connection
$this	setPostProcessor(Processor $processor) Установить обработчик запросов, используемый соединением.	from Connection
Dispatcher	getEventDispatcher() Получить диспетчер событий, используемый соединением.	from Connection
$this	setEventDispatcher(Dispatcher $events) Установить экземпляр диспетчера событий в соединении.	from Connection
void	unsetEventDispatcher() Удалить диспетчер событий для этого соединения.	from Connection
bool	pretending() Определить, находится ли соединение в режиме "сухого запуска".	from Connection
array	getQueryLog() Получить журнал запросов соединения.	from Connection
void	flushQueryLog() Очистить журнал запросов.	from Connection
void	enableQueryLog() Включить журнал запросов для соединения.	from Connection
void	disableQueryLog() Отключить журнал запросов для соединения.	from Connection
bool	logging() Определить, ведется ли регистрация запросов.	from Connection
string	getDatabaseName() Получить имя подключенной базы данных.	from Connection
$this	setDatabaseName(string $database) Установить имя подключенной базы данных.	from Connection
string	getTablePrefix() Получить префикс таблицы для соединения.	from Connection
$this	setTablePrefix(string $prefix) Установить префикс таблицы, используемый соединением.	from Connection
Grammar	withTablePrefix(Grammar $grammar) Установить префикс таблицы и вернуть синтаксический анализатор.	from Connection
static void	resolverFor(string $driver, Closure $callback) Зарегистрировать обработчик соединения.	from Connection
static mixed	getResolver(string $driver) Получить обработчик соединения для указанного драйвера.	from Connection
Driver	getDoctrineDriver() Получить драйвер Doctrine DBAL.

Подробности

protected bool causedByDeadlock(Exception $e)

Определить, была ли данная исключительная ситуация вызвана тупиком.

Параметры

Exception

Возвращаемое значение

bool

protected bool causedByLostConnection(Throwable $e)

Определить, было ли данное исключение вызвано потерей соединения.

Параметры

Throwable

Возвращаемое значение

bool

mixed transaction(Closure $callback, int $attempts = 1)

Выполнить Closure в рамках транзакции.

Параметры

Closure	$callback
int	$attempts

Возвращаемое значение

mixed

Исключения

Throwable

protected void handleTransactionException(Exception $e, int $currentAttempt, int $maxAttempts)

Обработать исключение, возникшее при выполнении транзакционного оператора.

Параметры

Exception	$e
int	$currentAttempt
int	$maxAttempts

Возвращаемое значение

void

Исключения

Exception

void beginTransaction()

Начать новую базу данных транзакцию.

Возвращаемое значение

void

Исключения

Exception

protected void createTransaction()

Создать транзакцию в базе данных.

Возвращаемое значение

void

protected void createSavepoint()

Создать точку сохранения в базе данных.

Возвращаемое значение

void

protected void handleBeginTransactionException(Throwable $e)

Обработать исключение при начале транзакции.

Параметры

Throwable

Возвращаемое значение

void

Исключения

Exception

void commit()

Подтвердить активную транзакцию базы данных.

Возвращаемое значение

void

void rollBack(int|null $toLevel = null)

Откатить активную транзакцию базы данных.

Параметры

int|null

$toLevel

Возвращаемое значение

void

Исключения

Exception

protected void performRollBack(int $toLevel)

Выполнить откат в базе данных.

Параметры

int

$toLevel

Возвращаемое значение

void

protected handleRollBackException(Exception $e)

Обработать исключение при откате.

Параметры

Exception

Исключения

Exception

int transactionLevel()

Получить количество активных транзакций.

Возвращаемое значение

int

void __construct(PDO|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = [])

Создать новый экземпляр подключения к базе данных.

Параметры

PDO\|Closure	$pdo
string	$database
string	$tablePrefix
array	$config

Возвращаемое значение

void

void useDefaultQueryGrammar()

Установить синтаксический анализатор запросов по умолчанию.

Возвращаемое значение

void

protected Grammar getDefaultQueryGrammar()

Получить экземпляр синтаксического анализатора запросов по умолчанию.

Возвращаемое значение

Grammar

void useDefaultSchemaGrammar()

Установить синтаксический анализатор схем по умолчанию.

Возвращаемое значение

void

protected Grammar getDefaultSchemaGrammar()

Получить экземпляр синтаксического анализатора схем по умолчанию.

Возвращаемое значение

Grammar

void useDefaultPostProcessor()

Установить обработчик запросов по умолчанию.

Возвращаемое значение

void

protected Processor getDefaultPostProcessor()

Получить экземпляр обработчика запросов по умолчанию.

Возвращаемое значение

Processor

Builder getSchemaBuilder()

Получить экземпляр конструктора схем для соединения.

Возвращаемое значение

Builder

Builder table(string $table)

Начать флюэнт-запрос к таблице базы данных.

Параметры

string

$table

Возвращаемое значение

Builder

Builder query()

Получить новый экземпляр билдера запросов.

Возвращаемое значение

Builder

mixed selectOne(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос SELECT и вернуть единственный результат.

Параметры

string	$query
array	$bindings
bool	$useReadPdo

Возвращаемое значение

mixed

array selectFromWriteConnection(string $query, array $bindings = [])

Выполнить запрос SELECT в базе данных.

Параметры

string	$query
array	$bindings

Возвращаемое значение

array

array select(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос SELECT в базе данных.

Параметры

string	$query
array	$bindings
bool	$useReadPdo

Возвращаемое значение

array

Generator cursor(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос SELECT в базе данных и вернуть генератор.

Параметры

string	$query
array	$bindings
bool	$useReadPdo

Возвращаемое значение

Generator

protected PDOStatement prepared(PDOStatement $statement)

Настроить подготовленное выражение PDO.

Параметры

PDOStatement

$statement

Возвращаемое значение

PDOStatement

protected PDO getPdoForSelect(bool $useReadPdo = true)

Получить соединение PDO для запроса SELECT.

Параметры

bool

$useReadPdo

Возвращаемое значение

PDO

bool insert(string $query, array $bindings = [])

Выполнить запрос INSERT в базе данных.

Параметры

string	$query
array	$bindings

Возвращаемое значение

bool

int update(string $query, array $bindings = [])

Выполнить запрос UPDATE в базе данных.

Параметры

string	$query
array	$bindings

Возвращаемое значение

int

int delete(string $query, array $bindings = [])

Выполнить запрос DELETE в базе данных.

Параметры

string	$query
array	$bindings

Возвращаемое значение

int

bool statement(string $query, array $bindings = [])

Выполнить SQL-запрос и вернуть булевый результат.

Параметры

string	$query
array	$bindings

Возвращаемое значение

bool

int affectingStatement(string $query, array $bindings = [])

Выполнить SQL-запрос и получить количество измененных строк.

Параметры

string	$query
array	$bindings

Возвращаемое значение

int

bool unprepared(string $query)

Выполнить сырой, неподготовленный запрос к соединению PDO.

Параметры

string

$query

Возвращаемое значение

bool

array pretend(Closure $callback)

Выполнить переданный обратный вызов в режиме "сухого запуска".

Параметры

Closure

$callback

Возвращаемое значение

array

protected array withFreshQueryLog(Closure $callback)

Выполнить переданный обратный вызов в режиме "сухого запуска".

Параметры

Closure

$callback

Возвращаемое значение

array

void bindValues(PDOStatement $statement, array $bindings)

Связать значения с их параметрами в данном операторе.

Параметры

PDOStatement	$statement
array	$bindings

Возвращаемое значение

void

array prepareBindings(array $bindings)

Подготовить параметры запроса для выполнения.

Параметры

array

$bindings

Возвращаемое значение

array

END_OF_DOCUMENT_MARKER

protected mixed run(string $query, array $bindings, Closure $callback)

Выполнить SQL-запрос и записать контекст его выполнения.

Параметры

string	$query
array	$bindings
Closure	$callback

Возвращаемое значение

mixed

Исключения

QueryException

protected mixed runQueryCallback(string $query, array $bindings, Closure $callback)

Выполнить SQL-запрос.

Параметры

string	$query
array	$bindings
Closure	$callback

Возвращаемое значение

mixed

Исключения

QueryException

void logQuery(string $query, array $bindings, float|null $time = null)

Записать запрос в журнал запросов подключения.

Параметры

string	$query
array	$bindings
float\|null	$time

Возвращаемое значение

void

protected float getElapsedTime(int $start)

Получить время, прошедшее с заданной точки отсчёта.

Параметры

int

$start

Возвращаемое значение

float

protected mixed handleQueryException(Exception $e, string $query, array $bindings, Closure $callback)

Обработать исключение запроса.

Параметры

Exception	$e
string	$query
array	$bindings
Closure	$callback

Возвращаемое значение

mixed

Исключения

Exception

protected mixed tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback)

Обработать исключение запроса, произошедшее во время выполнения.

Параметры

QueryException	$e
string	$query
array	$bindings
Closure	$callback

Возвращаемое значение

mixed

Исключения

QueryException

void reconnect()

Подключиться к базе данных повторно.

Возвращаемое значение

void

Исключения

LogicException

protected void reconnectIfMissingConnection()

Подключиться к базе данных повторно, если подключение PDO отсутствует.

Возвращаемое значение

void

void disconnect()

Отключиться от базового подключения PDO.

Возвращаемое значение

void

void listen(Closure $callback)

Зарегистрировать слушателя запросов базы данных с подключением.

Параметры

Closure

$callback

Возвращаемое значение

void

protected array|null fireConnectionEvent(string $event)

Сгенерировать событие для этого подключения.

Параметры

string

$event

Возвращаемое значение

array|null

protected void event(mixed $event)

Сгенерировать заданное событие, если это возможно.

Параметры

mixed

$event

Возвращаемое значение

void

Expression raw(mixed $value)

Получить новое выражение необработанного запроса.

Параметры

mixed

$value

Возвращаемое значение

Expression

void recordsHaveBeenModified(bool $value = true)

Указать, были ли изменены какие-либо записи.

Параметры

bool

$value

Возвращаемое значение

void

bool isDoctrineAvailable()

Doctrine доступен?

Возвращаемое значение

bool

Column getDoctrineColumn(string $table, string $column)

Получить экземпляр Doctrine Schema Column.

Параметры

string	$table
string	$column

Возвращаемое значение

Column

AbstractSchemaManager getDoctrineSchemaManager()

Получить менеджер схемы Doctrine DBAL для подключения.

Возвращаемое значение

AbstractSchemaManager

Connection getDoctrineConnection()

Получить экземпляр подключения Doctrine DBAL.

Возвращаемое значение

Connection

PDO getPdo()

Получить текущее PDO подключение.

Возвращаемое значение

PDO

PDO getReadPdo()

Получить текущее подключение PDO, используемое для чтения.

Значение возврата

PDO

$this setPdo(PDO|Closure|null $pdo)

Установить подключение PDO.

Параметры

PDO|Closure|null

$pdo

Значение возврата

$this

$this setReadPdo(PDO|Closure|null $pdo)

Установить подключение PDO, используемое для чтения.

Параметры

PDO|Closure|null

$pdo

Значение возврата

$this

$this setReconnector(callable $reconnector)

Установить экземпляр повторного подключения к базе данных.

Параметры

callable

$reconnector

Значение возврата

$this

string|null getName()

Получить имя подключения к базе данных.

Значение возврата

string|null

mixed getConfig(string|null $option = null)

Получить опцию из параметров конфигурации.

Параметры

string|null

$option

Значение возврата

mixed

string getDriverName()

Получить имя драйвера PDO.

Значение возврата

string

Grammar getQueryGrammar()

Получить используемую грамматику запросов для подключения.

Значение возврата

Grammar

$this setQueryGrammar(Grammar $grammar)

Установить используемую грамматику запросов для подключения.

Параметры

Grammar

$grammar

Значение возврата

$this

Grammar getSchemaGrammar()

Получить используемую грамматику схемы для подключения.

Значение возврата

Grammar

$this setSchemaGrammar(Grammar $grammar)

Установить используемую грамматику схемы для подключения.

Параметры

Grammar

$grammar

Значение возврата

$this

Processor getPostProcessor()

Получить используемый постпроцессор запросов для подключения.

Значение возврата

Processor

$this setPostProcessor(Processor $processor)

Установить используемый постпроцессор запросов для подключения.

Параметры

Processor

$processor

Значение возврата

$this

Dispatcher getEventDispatcher()

Получить используемый диспетчер событий для подключения.

Значение возврата

Dispatcher

$this setEventDispatcher(Dispatcher $events)

Установить экземпляр диспетчера событий для подключения.

Параметры

Dispatcher

$events

Значение возврата

$this

void unsetEventDispatcher()

Удалить диспетчер событий для данного подключения.

Значение возврата

void

bool pretending()

Определить, находится ли подключение в режиме "сухого запуска".

Значение возврата

bool

array getQueryLog()

Получить журнал запросов подключения.

Значение возврата

array

void flushQueryLog()

Очистить журнал запросов.

Значение возврата

void

void enableQueryLog()

Включить журнал запросов для подключения.

Значение возврата

void

void disableQueryLog()

Отключить журнал запросов для подключения.

Значение возврата

void

bool logging()

Определить, ведется ли регистрация запросов.

Значение возврата

bool

string getDatabaseName()

Получить имя подключенной базы данных.

Значение возврата

string

$this setDatabaseName(string $database)

Установить имя подключенной базы данных.

Параметры

string

$database

Возвращаемое значение

$this

string getTablePrefix()

Получить префикс таблицы для подключения.

Возвращаемое значение

string

$this setTablePrefix(string $prefix)

Установить используемый префикс таблицы для подключения.

Параметры

string

$prefix

Возвращаемое значение

$this

Grammar withTablePrefix(Grammar $grammar)

Установить префикс таблицы и вернуть грамматику.

Параметры

Grammar

$grammar

Возвращаемое значение

Grammar

static void resolverFor(string $driver, Closure $callback)

Зарегистрировать обработчик подключений.

Параметры

string	$driver
Closure	$callback

Возвращаемое значение

void

static mixed getResolver(string $driver)

Получить обработчик подключений для заданного драйвера.

Параметры

string

$driver

Возвращаемое значение

mixed

protected Driver getDoctrineDriver()

Получить драйвер Doctrine DBAL.

Возвращаемое значение

Driver

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/5.7/Illuminate/Database/SqlServerConnection.html