mysqli_connect

mysqli()

(PHP 5)

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

Описание

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

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

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

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