mysqli
PHP Manual

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

mysqli
PHP Manual