SqlServerConnection

класс SqlServerConnection расширяет Connection (Просмотреть исходный код)

Трейты

Свойства

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) Определить, было ли данное исключение вызвано тупиком.	from DetectsDeadlocks
bool	causedByLostConnection(Exception $e) Определить, было ли данное исключение вызвано потерей соединения.	from DetectsLostConnections
mixed	transaction(Closure $callback, int $attempts = 1) Выполнить замыкание в рамках транзакции.
void	handleTransactionException(Exception $e, int $currentAttempt, int $maxAttempts) Обработать исключение, возникшее при выполнении транзакционного оператора.	from ManagesTransactions
void	beginTransaction() Начать новую базу данных транзакции.	from ManagesTransactions
void	createTransaction() Создать транзакцию в базе данных.	from ManagesTransactions
void	createSavepoint() Создать точку сохранения в базе данных.	from ManagesTransactions
void	handleBeginTransactionException(Exception $e) Обработать исключение при начале транзакции.	from ManagesTransactions
void	commit() Зафиксировать активную транзакцию базы данных.	from ManagesTransactions
void	rollBack(int\|null $toLevel = null) Отменить активную транзакцию базы данных.	from ManagesTransactions
void	performRollBack(int $toLevel) Выполнить откат в базе данных.	from ManagesTransactions
int	transactionLevel() Получить количество активных транзакций.	from ManagesTransactions
void	__construct(PDO\|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = []) Создать новый экземпляр подключения к базе данных.	from Connection
void	useDefaultQueryGrammar() Установить синтаксический анализатор запросов по умолчанию.	from Connection

Грамматика	getDefaultQueryGrammar() Получить экземпляр по умолчанию грамматики запросов.
void	useDefaultSchemaGrammar() Установить грамматику схемы по умолчанию.	из Подключения
Грамматика	getDefaultSchemaGrammar() Получить экземпляр по умолчанию грамматики схемы.
void	useDefaultPostProcessor() Установить обработчик запросов по умолчанию.	из Подключения
Обработчик	getDefaultPostProcessor() Получить экземпляр по умолчанию обработчика.
Построитель	getSchemaBuilder() Получить экземпляр построителя схемы для подключения.
Построитель	table(string $table) Начать флюэнт-запрос к базе данных по таблице.	из Подключения
Построитель	query() Получить новый экземпляр построителя запросов.	из Подключения
mixed	selectOne(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос select и вернуть единственный результат.	из Подключения
array	selectFromWriteConnection(string $query, array $bindings = []) Выполнить запрос select к базе данных.	из Подключения
array	select(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос select к базе данных.	из Подключения
Генератор	cursor(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос select к базе данных и вернуть генератор.	из Подключения
PDOStatement	prepared(PDOStatement $statement) Настроить подготовленное выражение PDO.	из Подключения
PDO	getPdoForSelect(bool $useReadPdo = true) Получить подключение PDO для запроса select.	из Подключения
bool	insert(string $query, array $bindings = []) Выполнить запрос insert в базу данных.	из Подключения

int	update(string $query, array $bindings = []) Выполнить операцию обновления в базе данных.	from Connection
int	delete(string $query, array $bindings = []) Выполнить операцию удаления в базе данных.	from Connection
bool	statement(string $query, array $bindings = []) Выполнить SQL-запрос и вернуть логическое значение результата.	from Connection
int	affectingStatement(string $query, array $bindings = []) Выполнить SQL-запрос и получить количество затронутых строк.	from Connection
bool	unprepared(string $query) Выполнить необработанный SQL-запрос к соединению PDO.	from Connection
array	pretend(Closure $callback) Выполнить заданный обратный вызов в режиме «сухого запуска».	from Connection
array	withFreshQueryLog(Closure $callback) Выполнить заданный обратный вызов в режиме «сухого запуска».	from Connection
void	bindValues(PDOStatement $statement, array $bindings) Связать значения с их параметрами в данном операторе.	from Connection
array	prepareBindings(array $bindings) Подготовить параметры запроса для выполнения.	from Connection
mixed	run(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос и записать контекст его выполнения.	from Connection
mixed	runQueryCallback(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос.	from Connection
void	logQuery(string $query, array $bindings, float\|null $time = null) Записать запрос в журнал запросов соединения.	from Connection
float	getElapsedTime(int $start) Получить время, прошедшее с заданного момента.	from Connection
mixed	handleQueryException(Exception $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса.	from Connection

mixed	tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса, возникшее во время выполнения запроса.	from Connection
void	reconnect() Подключиться к базе данных снова.	from Connection
void	reconnectIfMissingConnection() Подключиться к базе данных снова, если соединение PDO отсутствует.	from Connection
void	disconnect() Отключиться от базового соединения PDO.	from Connection
void	listen(Closure $callback) Зарегистрировать прослушиватель запросов базы данных с подключением.	from Connection
array\|null	fireConnectionEvent(string $event) Сгенерировать событие для этого подключения.	from Connection
void	event(mixed $event) Сгенерировать заданное событие, если возможно.	from Connection
Expression	raw(mixed $value) Получить новое выражение необработанного запроса.	from Connection
void	recordsHaveBeenModified(bool $value = true) Указать, были ли изменены какие-либо записи.	from Connection
bool	isDoctrineAvailable() Доступен ли Doctrine?	from Connection
Column	getDoctrineColumn(string $table, string $column) Получить экземпляр Doctrine Schema Column.	from Connection
AbstractSchemaManager	getDoctrineSchemaManager() Получить менеджер схемы Doctrine DBAL для подключения.	from Connection
Connection	getDoctrineConnection() Получить экземпляр подключения Doctrine DBAL к базе данных.	from Connection
PDO	getPdo() Получить текущее соединение PDO.	from Connection
PDO	getReadPdo() Получить текущее соединение PDO, используемое для чтения.	from 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
void	setQueryGrammar(Grammar $grammar) Установить синтаксис запросов, используемый подключением.	from Connection
Grammar	getSchemaGrammar() Получить синтаксис схемы, используемый подключением.	from Connection
void	setSchemaGrammar(Grammar $grammar) Установить синтаксис схемы, используемый подключением.	from Connection
Processor	getPostProcessor() Получить обработчик запросов, используемый подключением.	from Connection
void	setPostProcessor(Processor $processor) Установить обработчик запросов, используемый подключением.	from Connection
Dispatcher	getEventDispatcher() Получить диспетчер событий, используемый подключением.	from Connection
void	setEventDispatcher(Dispatcher $events) Установить экземпляр диспетчера событий для подключения.	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
string	setDatabaseName(string $database) Установить имя подключенной базы данных.	from Connection
string	getTablePrefix() Получить префикс таблицы для подключения.	from Connection
void	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.

Details

protected bool causedByDeadlock(Exception $e)

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

Parameters

Exception

Return Value

bool

protected bool causedByLostConnection(Exception $e)

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

Параметры

Exception

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

bool

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

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

Параметры

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(Exception $e)

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

Параметры

Exception

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

void

Исключения

Exception

void commit()

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

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

void

void rollBack(int|null $toLevel = null)

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

Параметры

int|null

$toLevel

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

void

protected void performRollBack(int $toLevel)

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

Параметры

int

$toLevel

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

void

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

смешанный selectOne(строка $query, массив $bindings = [], булево $useReadPdo = true)

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

Параметры

строка	$query
массив	$bindings
булево	$useReadPdo

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

смешанный

массив selectFromWriteConnection(строка $query, массив $bindings = [])

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

Параметры

строка	$query
массив	$bindings

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

массив

массив select(строка $query, массив $bindings = [], булево $useReadPdo = true)

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

Параметры

строка	$query
массив	$bindings
булево	$useReadPdo

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

массив

Генератор cursor(строка $query, массив $bindings = [], булево $useReadPdo = true)

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

Параметры

строка	$query
массив	$bindings
булево	$useReadPdo

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

Генератор

protected PDOStatement prepared(PDOStatement $statement)

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

Параметры

PDOStatement

$statement

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

PDOStatement

protected PDO getPdoForSelect(булево $useReadPdo = true)

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

Параметры

булево

$useReadPdo

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

PDO

булево insert(строка $query, массив $bindings = [])

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

Параметры

строка	$query
массив	$bindings

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

булево

целое число update(строка $query, массив $bindings = [])

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

Параметры

строка	$query
массив	$bindings

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

целое число

целое число delete(строка $query, массив $bindings = [])

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

Параметры

строка	$query
массив	$bindings

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

целое число

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

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

void setQueryGrammar(Grammar $grammar)

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

Параметры

Grammar

$grammar

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

void

Grammar getSchemaGrammar()

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

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

Grammar

void setSchemaGrammar(Grammar $grammar)

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

Параметры

Grammar

$grammar

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

void

END_OF_DOCUMENT_MARKER

Processor getPostProcessor()

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

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

Processor

void setPostProcessor(Processor $processor)

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

Параметры

Processor

$processor

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

void

Dispatcher getEventDispatcher()

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

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

Dispatcher

void setEventDispatcher(Dispatcher $events)

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

Параметры

Dispatcher

$events

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

void

bool pretending()

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

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

bool

array getQueryLog()

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

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

array

void flushQueryLog()

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

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

void

void enableQueryLog()

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

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

void

void disableQueryLog()

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

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

void

bool logging()

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

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

bool

string getDatabaseName()

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

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

string

string setDatabaseName(string $database)

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

Параметры

string

$database

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

string

строка getTablePrefix()

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

Значение результата

строка

void setTablePrefix(строка $prefix)

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

Параметры

строка

$prefix

Значение результата

void

Grammar withTablePrefix(Grammar $grammar)

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

Параметры

Grammar

$grammar

Значение результата

Grammar

статический void resolverFor(строка $driver, Closure $callback)

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

Параметры

строка	$driver
Closure	$callback

Значение результата

void

статический смешанный getResolver(строка $driver)

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

Параметры

строка

$driver

Значение результата

смешанный

защищённый Driver getDoctrineDriver()

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

Значение результата

Driver

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