PHP mysqli: функция real_connect ()
Функция mysqli_real_connect () / mysqli :: real_connect
Функция mysqli_real_connect () / mysqli :: real_connect открывает новое соединение с сервером MySQL.
Функция mysqli_real_connect () отличается от mysqli_connect () следующими способами:
- mysqli_real_connect () требует допустимый объект, который должен быть создан mysqli_init ().
- Его можно использовать с mysqli_options (), чтобы установить различные параметры для соединения.
- У него есть параметр флага.
Синтаксис:
Объектно-ориентированный стиль
bool mysqli :: real_connect ([строка $ host [, строка $ username [, строка $ passwd [, строка $ dbname [, int $ port [, строка $ socket [, int $ flags]]]]]]]])
Процедурный стиль
bool mysqli_real_connect (mysqli $ link [, строка $ host [, строка $ username [, строка $ passwd [, строка $ dbname [, int $ port [, строка $ socket [, int $ flags]]]]]]]])
Параметр:
| название | Описание | Обязательный / Дополнительно | |
|---|---|---|---|
| ссылка на сайт | Идентификатор ссылки, возвращаемый mysqli_connect () или mysqli_init () | Требуется только для процедурного стиля и необязательно для объектно-ориентированного стиля | |
| хозяин | Может быть именем хоста или IP-адресом. Передав значение NULL или строку «localhost» этому параметру, предполагается локальный хост. Когда это возможно, вместо протокола TCP / IP будут использоваться каналы. | необходимые | |
| имя пользователя | Имя пользователя MySQL. | необходимые | |
| ПАРОЛЬ | Если указано значение NULL, сервер MySQL попытается аутентифицировать пользователя по тем записям пользователя, которые не имеют только пароля. Это позволяет использовать одно имя пользователя с разными разрешениями (в зависимости от того, предоставлен пароль или нет). | необходимые | |
| имя_бд | Если указано, укажите базу данных по умолчанию, которая будет использоваться при выполнении запросов. | необходимые | |
| порт | Указывает номер порта для попытки подключения к серверу MySQL. | Необязательный | |
| разъем | Определяет сокет или именованный канал, который должен использоваться. | Необязательный | |
| флаги | С помощью флагов параметров вы можете установить различные параметры подключения: | Необязательный | |
| название | Описание | ||
| MYSQLI_CLIENT_COMPRESS | Использовать протокол сжатия | ||
| MYSQLI_CLIENT_FOUND_ROWS | возвращает количество совпадающих строк, а не количество затронутых строк | ||
| MYSQLI_CLIENT_IGNORE_SPACE | Разрешить пробелы после имен функций. Делает все имена функций зарезервированными словами. | ||
| MYSQLI_CLIENT_INTERACTIVE | Разрешить интерактивное время ожидания (вместо секунд ожидания) времени бездействия перед закрытием соединения | ||
| MYSQLI_CLIENT_SSL | Использовать SSL (шифрование) | ||
| MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT | Подобно MYSQLI_CLIENT_SSL, но отключает проверку предоставленного SSL-сертификата. Это только для установок, использующих MySQL Native Driver и MySQL 5.6 или новее. | ||
Использование: Процедурный стиль
mysqli_real_connect (соединение, хост, имя пользователя, пароль, имя_бд, порт, разъем, флаг);
Параметр:
| название | Описание | Требуется / Необязательно |
|---|---|---|
| соединение | Определяет соединение MySQL для использования | необходимые |
| хозяин | Указывает имя хоста или IP-адрес | необходимые |
| имя пользователя | Определяет имя пользователя MySQL | необходимые |
| пароль | Определяет пароль MySQL | необходимые |
| имя_бд | Определяет базу данных по умолчанию, которая будет использоваться | необходимые |
| порт | Определяет номер порта для попытки подключения к серверу MySQL | Необязательный |
| разъем | Определяет сокет или именованный канал, который будет использоваться | Необязательный |
| флаг | Определяет различные варианты подключения. Возможные значения:
| Необязательный |
Возвращаемое значение:
Возвращает TRUE в случае успеха или FALSE в случае неудачи.
Версия: PHP 5, PHP 7
Пример объектно-ориентированного стиля:
<?php
$mysqli = mysqli_init();
if (!$mysqli) {
die('mysqli_init failed');
}
if (!$mysqli->options(MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0')) {
die('Setting MYSQLI_INIT_COMMAND failed');
}
if (!$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5)) {
die('Setting MYSQLI_OPT_CONNECT_TIMEOUT failed');
}
if (!$mysqli->real_connect('localhost', 'user1', 'datasoft123', 'hr')) {
die('Connect Error (' . mysqli_connect_errno() . ') '
. mysqli_connect_error());
}
echo 'Success... ' . $mysqli->host_info . "\n";
$mysqli->close();
?>
Выход:
Успех ... Информация о хосте MySQL: localhost через TCP / IP
Пример процедурного стиля:
<?php
$link = mysqli_init();
if (!$link) {
die('mysqli_init failed');
}
if (!mysqli_options($link, MYSQLI_INIT_COMMAND, 'SET AUTOCOMMIT = 0')) {
die('Setting MYSQLI_INIT_COMMAND failed');
}
if (!mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5)) {
die('Setting MYSQLI_OPT_CONNECT_TIMEOUT failed');
}
if (!mysqli_real_connect($link, 'localhost', 'user1', 'datasoft123', 'hr')) {
die('Connect Error (' . mysqli_connect_errno() . ') '
. mysqli_connect_error());
}
echo 'Success... ' . mysqli_get_host_info($link) . "\n";
mysqli_close($link);
?>
Выход:
Успех ... Информация о хосте MySQL: localhost через TCP / IP
Смотрите также
Предыдущая: запрос
Далее: real_escape_string
Новый контент: Composer: менеджер зависимостей для PHP , R программирования
disqus2code