Files
php-doc-ru/reference/mysql/functions/mysql-connect.xml
Shein Alexey ab3c2130fa Fixed path to sgml-default-dtd-file.
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@305403 c90b9560-bf6c-de11-be94-00142212c4b1
2010-11-16 08:52:05 +00:00

130 lines
6.1 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: n/a Maintainer: lovchy Status: ready -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
<refentry xml:id="function.mysql-connect" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_connect</refname>
<refpurpose>Открывает соединение с сервером MySQL</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>resource</type><methodname>mysql_connect</methodname>
<methodparam choice="opt"><type>string</type><parameter>server</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>new_link</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает указатель на соединение с MySQL в случае успешного выполнения,
или &false; при неудаче.
</para>
<para>
<function>mysql_connect</function> устанавливает соединение с сервером
MySQL. Следующие значения по умолчанию установлены для отсутствующих
параметров: <parameter>server</parameter> =
'localhost:3306', <parameter>username</parameter> = имя пользователя
владельца процесса сервера и
<parameter>password</parameter> = пустой пароль.
</para>
<para>
Параметр <parameter>server</parameter> может также включать номер порта,
к примеру &quot;hostname:port&quot; или путь к сокету,
к примеру &quot;:/path/to/socket&quot; для локального сервера.
<note>
<para>
При указании параметру <parameter>server</parameter> значения &quot;localhost&quot; или
&quot;localhost:port&quot; клиентская библиотека MySQL будет пытаться
соединиться с локальным сокетом. Если вы всё же хотите использовать
TCP/IP, используйте адрес &quot;127.0.0.1&quot;
вместо &quot;localhost&quot;. Если клиентская библиотека пытается
подключиться не к тому локальному сокету, это можно исправить через
указание директивы mysql.default_host в конфигурации PHP, после чего
можно оставлять параметр <parameter>server</parameter> пустым.
</para>
<para>
Поддержка указания порта через &quot;:port&quot; была добавлена в PHP 3.0B4.
</para>
<para>
Поддержка указания локального сокета как &quot;:/path/to/socket&quot;
была добавлена в PHP 3.0.10.
</para>
<para>
Подавить вывод ошибок можно добавив
<link linkend="language.operators.errorcontrol">@</link> в начало
названия функции (@<function>mysql_connect</function>)
</para>
</note>
</para>
<para>
Если второй вызов функции произошёл с теми же аргументами <function>mysql_connect</function>,
новое соединение не будет установлено. Вместо этого функция вернёт ссылку
на уже установленное соединение. Параметр <parameter>new_link</parameter> может заставить
функцию <function>mysql_connect</function> открыть ещё одно соединение, даже если
соединение с аналогичными параметрами уже открыто.
Параметр <parameter>client_flags</parameter> должен быть комбинацией из
следующих констант:
MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE,
MYSQL_CLIENT_INTERACTIVE.
</para>
<note>
<para>
Параметр <parameter>new_link</parameter> добавлен в
PHP 4.2.0
</para>
<para>
Параметр <parameter>client_flags</parameter> добавлен
PHP 4.3.0
</para>
</note>
<para>
Соединение с сервером будет закрыто при завершении исполнения скрипта,
если до этого оно не будет закрыто с помощью функции
<function>mysql_close</function>.
</para>
<para>
<example>
<title>Пример использования <function>mysql_connect</function></title>
<programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect("localhost", "mysql_user", "mysql_password")
or die("Could not connect: " . mysql_error());
print ("Connected successfully");
mysql_close($link);
?>
]]>
</programlisting>
</example>
</para>
<para>
См. также
<function>mysql_pconnect</function> and
<function>mysql_close</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->