mysqli_connect
mysqli()
(No version information available, might be only in CVS)
mysqli() — Открывает новое соединение с сервером MySQL
Описание
Процедурный стиль
Объектно-ориентированный стиль (конструктор):
Функция mysqli_connect() пытается открыть соединение с сервером MySQL, работающему на сервере, указанном параметром host , который может быть именем хоста или IP-адресом. Передача значения NULL или строки "localhost" в качестве этого параметра, предполагает подключение к локальному хосту. При возможности будут использованы каналы (pipes) вместо протокола TCP/IP. При успешном подключение, функция mysqli_connect() вернет объект, представляющий соединение с базой данных, или FALSE при неудаче.
Параметры username и password определяют имя пользователя и пароль с которыми будет произведено подключение к серверу MySQL. Если пароль не определен (передан параметр NULL), сервер MySQL предпримет попытку аутентифицировать пользователя, как такового, запись о котором не имеет только пароля. Это позволяет использовать одно имя пользователя с различными правами доступа (в зависимости от того, используется пароль или нет).
Если указан параметр dbname будет выбрана база данных по-умолчению, которая будет использоваться для выполнения запросов.
Параметры port и socket используются совместно с параметром host для дополнительного контроля над подключением к серверу баз данных. Параметр port определяет номер порта для попытки подключения к серверу MySQL, который его прослушивает, в то время как параметр socket определяет сокет или именованый канал, которые необходимо использовать для соединения.
Note: Установка параметра socket точно не определяет тип соединения для использования при подключении к серверу MySQL. Каким образом установлено соединение с базой данных MySQL определяется параметром host .
Возвращаемые значения
Возвращает объект, представляющий соединение с сервером MySQL или FALSE, если попытка подключения потерпит неудачу.
Примеры
Example#1 Объектно-ориентированный стиль
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Проверка подключения */
if (mysqli_connect_errno()) {
printf("Ошибка подключения: %s\n", mysqli_connect_error());
exit();
}
printf("Информация о хосте: %s\n", $mysqli->host_info);
/* Закрытие соединения */
$mysqli->close();
?>
Example#2 Процедурный стиль
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Проверка подключения */
if (!$link) {
printf("Ошибка подключения: %s\n", mysqli_connect_error());
exit();
}
printf("Информация о хосте: %s\n", mysqli_get_host_info($link));
/* Закрытие соединения */
mysqli_close($link);
?>
Результат выполнения данного примера:
Информация о хосте: Localhost via UNIX socket