Руководство по PHP
Пред. |  | След.

# mysqli_connect

(PHP 5)

mysqli_connect

(no version information, might be only in CVS)

mysqli() -- Открывает новое соединение с сервером MySQL

## Описание

Процедурный стиль

mysqli mysqli_connect ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )

Объектно-ориентированный стиль (конструктор):

class mysqli {
__construct ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )
}

Функция 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` определяет сокет или именованый канал, которые необходимо использовать для соединения.

> Замечание: Установка параметра `socket` точно не определяет тип соединения для использования при подключении к серверу MySQL. Каким образом установлено соединение с базой данных MySQL определяется параметром `host`.

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

Возвращает объект, представляющий соединение с сервером MySQL или `FALSE`, если попытка подключения потерпит неудачу.

## Примеры

Пример 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(); ?>`

Пример 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

Пред. | Начало | След.
mysqli_connect_error | Уровень выше | mysqli_data_seek