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

# mysql_connect

(PHP 3, PHP 4, PHP 5)

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

## Описание

resource mysql_connect ( [string server [, string username [, string password [, bool new_link [, int client_flags]]]]] )

Возвращает указатель на соединение с MySQL в случае успешного выполнения, или `FALSE` при неудаче.

mysql_connect() устанавливает соединение с сервером MySQL. Следующие значения по умолчанию установлены для отсутствующих параметров: server = 'localhost:3306', username = имя пользователя владельца процесса сервера и password = пустой пароль.

Параметр server может также включать номер порта, к примеру "hostname:port" или путь к сокету, к примеру ":/path/to/socket" для локального сервера.

> Замечание: При указании параметру server значения "localhost" или "localhost:port" клиентская библиотека MySQL будет пытаться соединиться с локальным сокетом. Если вы всё же хотите использовать TCP/IP, используйте адрес "127.0.0.1" вместо "localhost". Если клиентская библиотека пытается подключиться не к тому локальному сокету, это можно исправить через указание директивы mysql.default_host в конфигурации PHP, после чего можно оставлять параметр server пустым.

> Поддержка указания порта через ":port" была добавлена в PHP 3.0B4.

> Поддержка указания локального сокета как ":/path/to/socket" была добавлена в PHP 3.0.10.

> Подавить вывод ошибок можно добавив @ в начало названия функции (@mysql_connect())

Если второй вызов функции произошёл с теми же аргументами mysql_connect(), новое соединение не будет установлено. Вместо этого функция вернёт ссылку на уже установленное соединение. Параметр new_link может заставить функцию mysql_connect() открыть ещё одно соединение, даже если соединение с аналогичными параметрами уже открыто. Параметр client_flags должен быть комбинацией из следующих констант: MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE, MYSQL_CLIENT_INTERACTIVE.

> Замечание: Параметр new_link добавлен в PHP 4.2.0

> Параметр client_flags добавлен PHP 4.3.0

Соединение с сервером будет закрыто при завершении исполнения скрипта, если до этого оно не будет закрыто с помощью функции mysql_close().

Пример 1. Пример использования mysql_connect()

`<?php $link = mysql_connect("localhost", "mysql_user", "mysql_password") or die("Could not connect: " . mysql_error()); print ("Connected successfully"); mysql_close($link); ?>`

См. также mysql_pconnect() and mysql_close().

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