Устанавливает новое соединение с сервером MySQL


mysqli_connect

(PHP 5)

mysqli::__construct -- mysqli_connect Устанавливает новое соединение с сервером MySQL

Описание

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

mysqli::__construct ([ string $host = ini_get("mysqli.default_host") [, string $username = ini_get("mysqli.default_user") [, string $passwd = ini_get("mysqli.default_pw") [, string $dbname = "" [, int $port = ini_get("mysqli.default_port") [, string $socket = ini_get("mysqli.default_socket") ]]]]]] )

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

mysqli mysqli_connect ([ string $host = ini_get("mysqli.default_host") [, string $username = ini_get("mysqli.default_user") [, string $passwd = ini_get("mysqli.default_pw") [, string $dbname = "" [, int $port = ini_get("mysqli.default_port") [, string $socket = ini_get("mysqli.default_socket") ]]]]]] )

Устанавливает соединение с работающим сервером MySQL.

Список параметров

host

Может быть именем хоста или IP адресом. Передача NULL или строки "localhost" этому параметру означает, что в качестве хоста будет использоваться локальная машина, на которой запущен скрипт. Если есть такая возможность, будут использоваться пайпы вместо протокола TCP/IP.

Если перед именем хоста задать строку p:, то будет открыто постоянное соединение. Если соединение открыто из пула подключений, будет автоматически вызвана функция mysqli_change_user().

username

Имя пользователя MySQL.

passwd

Если не задан или равен NULL, MySQL сервер в первую очередь попытается аутентифицировать пользователя в принципе имеющего пароль, а затем будет искать среди пользователей, у которых нет пароля. Такой подход позволяет одному пользователю назначать различные права (в зависимости от того, задан пароль или нет).

dbname

Если параметр задан, его значение будет использоваться в качестве имени базы данных по умолчанию при выполнении запросов.

port

Задает номер порта для подключения к серверу MySQL.

socket

Задает сокет или именованный пайп, который необходимо использовать.

Замечание:

Передача параметра socket не будет явно задавать тип соединения при подключении к серверу MySQL. То, как будет устанавливаться соединение с MySQL сервером, определяется параметром host.

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

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

Список изменений

Версия Описание
5.3.0 Добавлена возможность устанавливать постоянные соединения.

Примеры

Пример #1 Пример использования mysqli::__construct()

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

<?php
$mysqli 
= new mysqli('localhost''my_user''my_password''my_db');

/*
 * Это "официальный" объектно-ориентированный способ сделать это
 * однако $connect_error не работал вплоть до версий PHP 5.2.9 и 5.3.0.
 */
if ($mysqli->connect_error) {
    die(
'Ошибка подключения (' $mysqli->connect_errno ') '
            
$mysqli->connect_error);
}

/*
 * Если нужно быть уверенным в совместимости с версиями до 5.2.9,
 * лучше использовать такой код
 */
if (mysqli_connect_error()) {
    die(
'Ошибка подключения (' mysqli_connect_errno() . ') '
            
mysqli_connect_error());
}

echo 
'Соединение установлено... ' $mysqli->host_info "\n";

$mysqli->close();
?>

Объектно-ориентированный стиль, когда расширяем класс mysqli

<?php

class foo_mysqli extends mysqli {
    public function 
__construct($host$user$pass$db) {
        
parent::__construct($host$user$pass$db);

        if (
mysqli_connect_error()) {
            die(
'Ошибка подключения (' mysqli_connect_errno() . ') '
                    
mysqli_connect_error());
        }
    }
}

$db = new foo_mysqli('localhost''my_user''my_password''my_db');

echo 
'Соединение установлено... ' $db->host_info "\n";

$db->close();
?>

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

<?php
$link 
mysqli_connect('localhost''my_user''my_password''my_db');

if (!
$link) {
    die(
'Ошибка подключения (' mysqli_connect_errno() . ') '
            
mysqli_connect_error());
}

echo 
'Соединение установлено... ' mysqli_get_host_info($link) . "\n";

mysqli_close($link);
?>

Результат выполнения данных примеров:

 Соединение установлено... MySQL host info: localhost via TCP/IP 

Примечания

Замечание:

MySQLnd всегда подразумевает кодировку, которую использует по умолчанию сервер. Эта кодировка передается во время установки соединения/авторизации, которе использует mysqlnd.

Libmysqlclient по умолчанию использует кодировку, установленную в my.cnf или специальным вызовом mysqli_options() до использования mysqli_real_connect(), но после mysqli_init().

Замечание:

Только для ОО подхода: Если соединение установить не удалось, метод все равно вернет объект. Проверить успешность создания подключения можно либо функцией mysqli_connect_error() или с помощью свойства mysqli->connect_error, как показано в примерах.

Замечание:

Если необходимо задать дополнительные параметры подключения, вроде таймаута и т.п., то вместо этого метода необходимо использовать фунцию mysqli_real_connect().

Замечание:

Вызов конструктора без параметров идентичен вызову функции mysqli_init().

Замечание:

Ошибка "Can't create TCP/IP socket (10106)" обычно означает, что директива конфигурации variables_order не содержит символ E. В Windows системах, если окружение не скопировано, переменная среды SYSTEMROOT будет недоступна, и у PHP возникнут проблемы с загрузкой Winsock.

Смотрите также

  • mysqli_real_connect() - Устанавливает соединение с сервером mysql
  • mysqli_options() - Задание настроек
  • mysqli_connect_errno() - Возвращает код ошибки последней попытки соединения
  • mysqli_connect_error() - Возвращает описание последней ошибки подключения
  • mysqli_close() - Закрывает ранее открытое соединение с базой данных