Получить версию сервера Connection::getVersion
Модуль: main — подключать отдельно не нужно
Доступно с версии: 14.0.0
Метод Connection::getVersion возвращает версию сервера базы данных. Метод подключается к базе данных, если подключения еще нет. Аналог в классическом API — CDatabase::GetVersion, он возвращает только строку версии.
Сигнатура метода в классе Bitrix\Main\DB\Connection:
abstract public function getVersion();
Возвращаемое значение
Метод возвращает массив array из двух элементов.
|
Ключ |
Описание |
|
0 |
Содержит номер версии сервера |
|
1 |
В реализациях MySQL и PostgreSQL всегда |
Формат номера зависит от реализации.
| Реализация | Формат номера |
|---|---|
MysqliConnection |
Три числа через точку, например 8.0.36. Метод извлекает их из строки версии сервера |
PgsqlConnection |
Два числа через точку, например 16.4 |
Метод запоминает версию в объекте соединения. Повторный вызов не обращается к серверу.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\DB\ConnectionException |
Подключиться к базе данных не удалось |
Примеры
Пример. Код проверяет, что версия MySQL не ниже 8.0:
<?php
use Bitrix\Main\Application;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$connection = Application::getConnection();
[$version] = $connection->getVersion();
if ($connection->getType() === 'mysql' && version_compare($version, '8.0.0', '<'))
{
echo 'MySQL 8.0 or later is required';
}
else
{
echo 'Version ' . $version;
}
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая