SqlServerConnection

class SqlServerConnection extends Connection (View source)

Свойства

protected PDO	$pdo	Активное соединение PDO.	из Connection
protected PDO	$readPdo	Активное соединение PDO, используемое для чтения.	из 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 mixed	$fetchArgument	Аргумент для режима извлечения.	из Connection
protected array	$fetchConstructorArgument	Аргументы конструктора для режима извлечения PDO::FETCH_CLASS.	из Connection
protected int	$transactions	Количество активных транзакций.	из Connection
protected array	$queryLog	Все запросы, выполненные к соединению.	из Connection
protected bool	$loggingQueries	Указывает, регистрируются ли запросы.	из Connection
protected bool	$pretending	Указывает, находится ли соединение в режиме "сухого запуска".	из Connection
protected string	$database	Имя подключенной базы данных.	из Connection
protected Connection	$doctrineConnection	Экземпляр подключения Doctrine.	из Connection
protected string	$tablePrefix	Префикс таблиц для соединения.	из Connection
protected array	$config	Параметры конфигурации подключения к базе данных.	из Connection

Методы

bool	causedByLostConnection(Exception $e) Определить, было ли данное исключение вызвано потерей соединения.	from DetectsLostConnections
void	__construct(PDO\|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = []) Создать новый экземпляр подключения к базе данных.	from Connection
void	useDefaultQueryGrammar() Установить синтаксический анализатор запросов по умолчанию.	from Connection
Grammar	getDefaultQueryGrammar() Получить экземпляр синтаксического анализатора запросов по умолчанию.
void	useDefaultSchemaGrammar() Установить синтаксический анализатор схем по умолчанию.	from Connection
Grammar	getDefaultSchemaGrammar() Получить экземпляр синтаксического анализатора схем по умолчанию.
void	useDefaultPostProcessor() Установить обработчик результатов запросов по умолчанию.	from Connection
Processor	getDefaultPostProcessor() Получить экземпляр обработчика результатов запросов по умолчанию.
Builder	getSchemaBuilder() Получить экземпляр генератора схем для подключения.	from Connection
Builder	table(string $table) Начать флюэнтный запрос к таблице базы данных.	from Connection
Builder	query() Получить новый экземпляр билдера запросов.	from Connection
Expression	raw(mixed $value) Получить новое выражение для сырого запроса.	from Connection
mixed	selectOne(string $query, array $bindings = []) Выполнить запрос select и вернуть единственный результат.	from Connection
array	selectFromWriteConnection(string $query, array $bindings = []) Выполнить запрос select в базе данных.	from Connection
array	select(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос select в базе данных.	from Connection
Generator	cursor(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос select в базе данных и вернуть генератор.	from Connection
PDO	getPdoForSelect(bool $useReadPdo = true) Получить соединение PDO для выполнения запроса select.	from Connection
bool	insert(string $query, array $bindings = []) Выполнить запрос insert в базе данных.	from Connection
int	update(string $query, array $bindings = []) Выполнить запрос update в базе данных.	from Connection
int	delete(string $query, array $bindings = []) Выполнить запрос delete в базе данных.	from Connection
bool	statement(string $query, array $bindings = []) Выполнить SQL-запрос и вернуть результат (boolean).	from Connection
int	affectingStatement(string $query, array $bindings = []) Выполнить SQL-запрос и получить количество затронутых строк.	from Connection
bool	unprepared(string $query) Выполнить неподготовленный SQL-запрос к соединению PDO.	from Connection
array	prepareBindings(array $bindings) Подготовить параметры запроса для выполнения.	from Connection
mixed	transaction(Closure $callback) Выполнить замыкание в рамках транзакции.
void	beginTransaction() Начать новую транзакцию базы данных.	from Connection
void	commit() Подтвердить активную транзакцию базы данных.	from Connection
void	rollBack() Откатить активную транзакцию базы данных.	from Connection
int	transactionLevel() Получить количество активных транзакций.	from Connection
array	pretend(Closure $callback) Выполнить заданный callback в режиме "сухого прогона".	from Connection
mixed	run(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос и записать контекст его выполнения.	from Connection

mixed	runQueryCallback(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос.	from Connection
mixed	tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса, произошедшее во время выполнения запроса.	from Connection
void	disconnect() Отключиться от базового соединения PDO.	from Connection
void	reconnect() Подключиться к базе данных заново.	from Connection
void	reconnectIfMissingConnection() Подключиться к базе данных заново, если соединение PDO отсутствует.	from Connection
void	logQuery(string $query, array $bindings, float\|null $time = null) Записать запрос в журнал запросов соединения.	from Connection
void	listen(Closure $callback) Зарегистрировать прослушиватель запросов базы данных в соединении.	from Connection
void	fireConnectionEvent(string $event) Сгенерировать событие для этого соединения.	from Connection
float	getElapsedTime(int $start) Получить время, прошедшее с указанной начальной точки.	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\|null $pdo) Установить соединение PDO.	from Connection
$this	setReadPdo(PDO\|null $pdo) Установить соединение PDO, используемое для чтения.	from Connection
$this	setReconnector(callable $reconnector) Установить экземпляр переподключения в соединении.	from Connection
string\|null	getName() Получить имя подключения к базе данных.	from Connection
mixed	getConfig(string $option) Получить опцию из опций конфигурации.	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

int	getFetchMode() Получить режим извлечения по умолчанию для подключения.	из Connection
mixed	getFetchArgument() Получить аргумент извлечения, который нужно применить при выборе.	из Connection
array	getFetchConstructorArgument() Получить настраиваемые аргументы конструктора для режима извлечения PDO::FETCH_CLASS.	из Connection
int	setFetchMode(int $fetchMode, mixed $fetchArgument = null, array $fetchConstructorArgument = []) Установить режим извлечения по умолчанию для подключения и необязательные аргументы для данного режима извлечения.	из Connection
array	getQueryLog() Получить журнал запросов подключения.	из Connection
void	flushQueryLog() Очистить журнал запросов.	из Connection
void	enableQueryLog() Включить журнал запросов для подключения.	из Connection
void	disableQueryLog() Отключить журнал запросов для подключения.	из Connection
bool	logging() Определить, ведем ли мы логирование запросов.	из Connection
string	getDatabaseName() Получить имя подключенной базы данных.	из Connection
string	setDatabaseName(string $database) Установить имя подключенной базы данных.	из Connection
string	getTablePrefix() Получить префикс таблицы для подключения.	из Connection
void	setTablePrefix(string $prefix) Установить используемый префикс таблицы в подключении.	из Connection
Grammar	withTablePrefix(Grammar $grammar) Установить префикс таблицы и вернуть грамматику.	из Connection
Driver	getDoctrineDriver() Получить драйвер Doctrine DBAL.

Подробности

protected bool causedByLostConnection(Exception $e)

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

Параметры

Exception

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

bool

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

END_OF_DOCUMENT_MARKER

Выражение raw(mixed $value)

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

Параметры

mixed

$value

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

Выражение

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

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

Параметры

string	$query
array	$bindings

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

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

Генератор cursor(string $query, array $bindings = [], bool $useReadPdo = true)

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

Параметры

string	$query
array	$bindings
bool	$useReadPdo

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

Генератор

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-оператор и вернуть boolean-результат.

Параметры

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 prepareBindings(array $bindings)

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

Параметры

array

$bindings

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

array

mixed transaction(Закрытие $callback)

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

Параметры

Закрытие

$callback

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

mixed

Исключения

Throwable

void beginTransaction()

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

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

void

Исключения

Исключение

void commit()

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

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

void

void rollBack()

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

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

void

int transactionLevel()

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

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

int

array pretend(Закрытие $callback)

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

Параметры

Закрытие

$callback

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

array

protected mixed run(string $query, array $bindings, Закрытие $callback)

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

Параметры

string	$query
array	$bindings
Закрытие	$callback

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

mixed

Исключения

Исключение запроса

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

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

Параметры

string	$query
array	$bindings
Closure	$callback

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

mixed

Исключения

QueryException

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

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

Параметры

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

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

mixed

Исключения

QueryException

void disconnect()

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

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

void

void reconnect()

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

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

void

Исключения

LogicException

protected void reconnectIfMissingConnection()

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

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

void

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

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

Параметры

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

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

void

void listen(Closure $callback)

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

Параметры

Closure

$callback

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

void

protected void fireConnectionEvent(string $event)

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

Параметры

string

$event

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

void

protected float getElapsedTime(int $start)

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

Параметры

int

$start

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

float

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|null $pdo)

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

Параметры

PDO|null

$pdo

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

$this

Исключения

RuntimeException

$this setReadPdo(PDO|null $pdo)

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

Параметры

PDO|null

$pdo

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

$this

$this setReconnector(callable $reconnector)

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

Параметры

callable

$reconnector

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

$this

string|null getName()

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

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

string|null

mixed getConfig(string $option)

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

Параметры

string

$option

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

mixed

string getDriverName()

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

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

string

END_OF_DOCUMENT_MARKER

Грамматика getQueryGrammar()

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

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

Грамматика

void setQueryGrammar(Грамматика $grammar)

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

Параметры

Грамматика

$grammar

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

void

Грамматика getSchemaGrammar()

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

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

Грамматика

void setSchemaGrammar(Грамматика $grammar)

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

Параметры

Грамматика

$grammar

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

void

Обработчик getPostProcessor()

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

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

Обработчик

void setPostProcessor(Обработчик $processor)

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

Параметры

Обработчик

$processor

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

void

Диспетчер getEventDispatcher()

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

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

Диспетчер

void setEventDispatcher(Диспетчер $events)

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

Параметры

Диспетчер

$events

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

void

bool pretending()

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

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

bool

int getFetchMode()

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

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

int

mixed getFetchArgument()

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

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

mixed

array getFetchConstructorArgument()

Получить пользовательские аргументы конструктора для режима выборки PDO::FETCH_CLASS.

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

array

int setFetchMode(int $fetchMode, mixed $fetchArgument = null, array $fetchConstructorArgument = [])

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

Параметры

int	$fetchMode
mixed	$fetchArgument
array	$fetchConstructorArgument

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

int

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

string getTablePrefix()

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

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

string

void setTablePrefix(string $prefix)

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

Параметры

string

$prefix

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

void

Грамматика withTablePrefix(Грамматика $grammar)

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

Параметры

Грамматика

$grammar

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

Грамматика

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.2/Illuminate/Database/SqlServerConnection.html