Описание
mysql_real_connect() пытается установить подключение с сервером MySQL, запущенным на машине host. mysql_real_connect() должен завершиться успешно прежде, чем Вы сможете выполнить любую из других функций API, за исключением mysql_get_client_info().
Параметры определены следующим образом:
Первый параметр должен быть адресом существующей структуры типа MYSQL. Перед вызовом mysql_real_connect() Вы должны вызвать mysql_init(), чтобы инициализировать структуру MYSQL. Вы можете изменять много параметров подключения через вызов mysql_options(). Подробности в разделе "2.3.159 mysql_options()". Значением host может быть имя или адрес IP. Если это NULL или строка localhost, выполняется подключение к локальной системе. Если OS поддерживает сокеты (Unix) или именованные каналы (Windows), именно они используются вместо стека протоколов TCP/IP, чтобы соединиться с сервером. Аргумент user содержит ID пользователя MySQL. Если user равен NULL, предполагается текущий пользователь. Под Unix это текущее (актуальное) имя входа в систему. Под Windows ODBC имя пользователя должно быть определено явно. Параметр passwd содержит пароль для user. Если passwd равен NULL, только записи в таблице user, которые имеют пустое поле пароля, будут проверены на соответствие. Это позволяет администратору базы данных устанавливать систему привилегий MySQL таким способом, которым пользователи получают различные привилегии в зависимости от того, определили или нет они пароль. ОБРАТИТЕ ВНИМАНИЕ: Не пытайтесь шифровать пароль перед вызовом mysql_real_connect(): шифрование пароля обработано автоматически.
db задает имя базы данных. Если db не NULL, подключение установит заданную по умолчанию базу данных. Если port не равен 0, значение будет использоваться как номер порта для подключения по TCP/IP. Обратите внимание, что параметр host определяет тип подключения. Если unix_socket не равен NULL, строка определяет сокет или именованный канал, который должен использоваться. Обратите внимание, что параметр host определяет тип подключения. Значение client_flag как правило равно 0, но может быть установлено к комбинации из следующих флажков в специальных обстоятельствах:
| Имя флажка |
Что он делает |
| CLIENT_COMPRESS |
Использовать протокол сжатия. |
| CLIENT_FOUND_ROWS |
Возвратить число найденных, а не обработанных строк. |
| CLIENT_IGNORE_SPACE |
Позволить использовать пробелы после имен функций. Делает все зарезервированные слова именами функций. |
| CLIENT_INTERACTIVE |
Позволить interactive_timeout секунд (вместо wait_timeout секунд) бездеятельности перед закрытием подключения. |
| CLIENT_NO_SCHEMA |
Не позволять синтаксис db_name.tbl_name.col_name. Это сделано для ODBC. Это заставляет синтаксический анализатор генерировать ошибку, если Вы используете тот синтаксис, который является полезным для заманивания в ловушку ошибок в некоторых программах ODBC. |
| CLIENT_ODBC |
Работает клиент ODBC. |
| CLIENT_SSL |
Использовать шифрованный протокол SSL. |
Содержание раздела
