diff --git a/reference/mysql/functions/mysql-connect.xml b/reference/mysql/functions/mysql-connect.xml index 423dfb8c4..110a9b3e1 100644 --- a/reference/mysql/functions/mysql-connect.xml +++ b/reference/mysql/functions/mysql-connect.xml @@ -1,111 +1,276 @@ + + - - - - - mysql_connect - Открывает соединение с сервером MySQL - - - Описание - - resourcemysql_connect - stringserver - stringusername - stringpassword - boolnew_link - intclient_flags - - - Возвращает указатель на соединение с MySQL в случае успешного выполнения, - или &false; при неудаче. - - - mysql_connect устанавливает соединение с сервером - MySQL. Следующие значения по умолчанию установлены для отсутствующих - параметров: server = - 'localhost:3306', username = имя пользователя - владельца процесса сервера и - password = пустой пароль. - - - Параметр server может также включать номер порта, - к примеру "hostname:port" или путь к сокету, - к примеру ":/path/to/socket" для локального сервера. - + + + mysql_connect + Открывает соединение с сервером MySQL + + + + &reftitle.description; + + resourcemysql_connect + stringserverini_get("mysql.default_host") + stringusernameini_get("mysql.default_user") + stringpasswordini_get("mysql.default_password") + boolnew_linkfalse + intclient_flags0 + + + Открывает новое соединение с сервером MySQL или использует + уже существующее. + + + + + &reftitle.parameters; + + + + server + - При указании параметру server значения "localhost" или - "localhost:port" клиентская библиотека MySQL будет пытаться - соединиться с локальным сокетом. Если вы всё же хотите использовать - TCP/IP, используйте адрес "127.0.0.1" - вместо "localhost". Если клиентская библиотека пытается - подключиться не к тому локальному сокету, это можно исправить через - указание директивы mysql.default_host в конфигурации PHP, после чего - можно оставлять параметр server пустым. + Сервер MySQL. Может также включать номер порта, например, + "hostname:port" или путь к локальному сокету, например, + ":/path/to/socket" для локального сервера. - Поддержка указания порта через ":port" была добавлена в PHP 3.0B4. + Если PHP-директива + mysql.default_host не определена (по умолчанию), то + значением по умолчанию является 'localhost:3306'. + В &sqlsafemode; этот параметр игнорируется и всегда используется + значение 'localhost:3306'. + + + + username + - Поддержка указания локального сокета как ":/path/to/socket" - была добавлена в PHP 3.0.10. + Имя пользователя. Значение по умолчанию определяется + директивой mysql.default_user. + В &sqlsafemode; этот параметр будет проигнорирован и будет + использован пользователь, владеющий процессом сервера. + + + + password + - Подавить вывод ошибок можно добавив - @ в начало - названия функции (@mysql_connect) + Пароль. Значение по умолчанию определяется директивой + mysql.default_password. + В &sqlsafemode; этот параметр будет проигнорирован и в качестве + пароля будет использована пустая строка. - - - - Если второй вызов функции произошёл с теми же аргументами 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. - - - - Пример использования <function>mysql_connect</function> - + + + + new_link + + + Если второй вызов функции mysql_connect + произошёл с теми же аргументами, то новое соединение не будет + установлено. Вместо этого функция вернёт ссылку + на уже установленное соединение. Параметр + new_link может заставить + функцию mysql_connect открыть ещё одно + соединение, даже если соединение с аналогичными параметрами + уже открыто. + В &sqlsafemode; этот параметр игнорируется. + + + + + client_flags + + + Параметр client_flags должен быть комбинацией из + следующих констант: + 128 (включает обработку LOAD DATA LOCAL), + MYSQL_CLIENT_SSL, + MYSQL_CLIENT_COMPRESS, + MYSQL_CLIENT_IGNORE_SPACE or + MYSQL_CLIENT_INTERACTIVE. + Подробнее читайте в разделе . + В &sqlsafemode; этот параметр игнорируется. + + + + + + + + + &reftitle.returnvalues; + + Возвращает дескриптор соединения с MySQL в случае успешного + выполнения&return.falseforfailure;. + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 4.3.0 + + Добавлен параметр client_flags. + + + + 4.2.0 + + Добавлен параметр new_link. + + + + + + + + + + &reftitle.examples; + + + Пример использования <function>mysql_connect</function> + ]]> - - - - - См. также - mysql_pconnect and - mysql_close. - - - + + + + + + Пример использования <function>mysql_connect</function> с синтаксисом <literal>hostname:port</literal> + + +]]> + + + + + + Пример использования <function>mysql_connect</function> с синтаксисом ":/path/to/socket" + + +]]> + + + + + + + &reftitle.notes; + + + При указании параметру server значения + "localhost" или "localhost:port" клиентская + библиотека MySQL будет пытаться соединиться с локальным сокетом. + Если вы всё же хотите использовать TCP/IP, используйте адрес + "127.0.0.1" вместо "localhost". Если + клиентская библиотека пытается подключиться не к тому + локальному сокету, это можно исправить через + указание директивы в + конфигурации PHP, после чего можно оставлять параметр + server пустым. + + + + + Соединение с сервером будет закрыто при завершении исполнения + скрипта, если только до этого оно не было закрыто с помощью + функции mysql_close. + + + + + Подавить вывод ошибок можно добавив + @ в начало + названия функции. + + + + + Ошибка "Can't create TCP/IP socket (10106)" + (Невозможно создать сокет TCP/IP) обычно означает, что + конфигурационная директива variables_order + не содержит символ E. В Windows, если в окружение + не будет скопирована переменная окружения + SYSTEMROOT, то PHP будет испытывать проблемы + при загрузке Winsock. + + + + + + &reftitle.seealso; + + + mysql_pconnect + mysql_close + + + +