RU/Modules/MTA-MySQL/mysql connect

	Эта функция предоставлена внешним модулем {{{2}}}. Вы должны установить этот модуль, чтобы использовать эту функцию.

Создаёт соединение с MySQL-сервером и возвращает к нему обработчик.

Синтаксис

MySQLConnection mysql_connect(string hostname, string username, string password, string database[, int port=3306, string unix_socket=nil, string client_flags=""])

Обязательные аргументы

• hostname. Имя хоста для подключения.
• username. Пользователь базы данных.
• password. Пользовательский пароль.
• database. Начальная база данных.

Необязательные аргументы

Примечание. При использовании необязательных аргументов Вам может потребоваться предоставить все аргументы перед тем аргументом, который Вы хотите использовать. Для более подробной информации ознакомьтесь с необязательными аргументами.

• port. MySQL-порт.
• unix_socket. Путь к UNIX-сокету (обычно /var/run/mysqld/mysqld.sock). Используется при подключении в UNIX-системах к локальной базе данных.
• client_flags. Флаги подключения (в формате "flag1|flag2|flag3"). Список флагов:
  • compress. Использовать протокола сжатия.
  • found_rows. Возвращать количество найденных (совпадающих) строк, а не количество изменённых строк.
  • ignore_sigpipe. Запрещать клиентской библиотеке устанавливать обработчик сигнала SIGPIPE. Это можно использовать для предотвращения конфликтов с обработчиком, что приложение уже установлено.
  • ignore_space. Разрешить пробелы после имён функций. Делает имена всех функций зарезервированными словами.
  • interactive. Разрешить interactive_timeout секунд (вместо wait_timeout секунд) бездействия до закрытия соединения. Переменной клиентской сессии wait_timeout присваивается значение переменной сессии interactive_timeout.
  • local_files. Включить обработку LOAD DATA LOCAL.
  • no_schema. Не разрешать синтаксис db_name.tbl_name.col_name. Это для ODBC. Это приводит к возникновению ошибки анализатором, если Вы используете этот синтаксис, который полезен для улавливания ошибок в некоторых ODBC-программах.

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

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

Примеры

Пример 1. В этом примере создаётся соединение с MySQL-сервером и проверяется, было ли оно успешным.

handler = mysql_connect("localhost", "username", "password", "mta_users")

if not handler then
    outputDebugString("Не удалось подключиться к MySQL-серверу")
else
    outputDebugString("Удалось подключиться к MySQL-серверу")
end

Пример 2. В этом примере создаётся соединение с MySQL-сервером и устанавливается к нему кодировка

local charset = "utf8";
local handler = mysql_connect("127.0.0.1", "username", "password", "database", 3306, "/var/lib/libmysqlclient.so.15", "")

if handler then
    mysql_query(handler, "SET NAMES '"..charset.."'")
    mysql_query(handler, "SET OPTION CHARACTER SET "..charset.."")
    mysql_query(handler, "SET CHARACTER SET '"..charset.."'")
end

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

• mysql_connect
• mysql_close
• mysql_errno
• mysql_error
• mysql_ping
• mysql_select_db
• mysql_escape_string
• mysql_affected_rows
• mysql_change_user
• mysql_get_character_set_info
• mysql_get_client_info
• mysql_get_client_version
• mysql_get_host_info
• mysql_get_proto_info
• mysql_get_server_info
• mysql_get_server_version
• mysql_hex_string
• mysql_info
• mysql_insert_id
• mysql_query
• mysql_unbuffered_query
• mysql_set_character_set
• mysql_stat
• mysql_warning_count