Files
php-doc-ru/reference/mysql/functions/mysql-pconnect.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

115 lines
5.2 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-pconnect" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_pconnect</refname>
<refpurpose>
Устанавливает постоянное соединение с сервером MySQL.
</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>resource</type><methodname>mysql_pconnect</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>int</type><parameter>client_flags</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает указатель на постоянное соединение с MySQL или &false;, в
случае ошибки.
</para>
<para>
<function>mysql_pconnect</function> устанавливает постоянное соединение с сервером
MySQL. Следующие значения по умолчанию установлены для отсутсвующих
параметров: <parameter>server</parameter> = 'localhost:3306',
<parameter>username</parameter> = имя пользователя владельца процесса
сервера и <parameter>password</parameter> = пустой пароль.
Параметр <parameter>client_flags</parameter> может быть комбинацией
следующих констант: MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE,
MYSQL_CLIENT_INTERACTIVE.
</para>
<para>
Параметр <parameter>server</parameter> может также включать номер
порта, к примеру &quot;hostname:port&quot; или путь к сокету,
к примеру &quot;:/path/to/socket&quot; для локального сервера.
<note>
<para>
Поддержка указания порта через &quot;:port&quot; была
добавлена в PHP 3.0B4.
</para>
<para>
Поддержка указания локального сокета как &quot;:/path/to/socket&quot;
была добавлена в PHP 3.0.10.
</para>
</note>
</para>
<!-- TODO move the story to features.persistent, and refer to that -->
<para>
<function>mysql_pconnect</function> работает аналогично
<function>mysql_connect</function> с двумя отличиями.
</para>
<para>
Во-первых, при соединении, функция пытается найти уже открытый
(постоянный) указатель на тот же сервер с тем же пользователем и паролем.
Если он найден, возвращён функцией будет именно он, вместо открытия
нового соединения.
</para>
<para>
Во-вторых, соединение с SQL-сервером не будет закрыто, когда работа
скрипта закончится. Вместо этого, оно останется рабочим для будущего
использования (<function>mysql_close</function> также не закрывает
постоянные соединения)
</para>
<para>
Опциональный параметр <parameter>client_flags</parameter> появился в PHP 4.3.0.
</para>
<para>
Соединения такого типа называют 'постоянными'.
</para>
<note>
<para>
Учтите, что соединения такого типа работают только, если
PHP установлен как модуль. За дополнительной информацией обращайтесь к
разделу
<link linkend="features.persistent-connections">Постоянные Соединения с
Базами Данных</link>.
</para>
</note>
<warning>
<para>
Использование устойчивых соединений может потребовать некоторой
настройки Apache и MySQL. Убедитесь, что вы не превысите максимальное
число дозволенных соединений.
</para>
</warning>
</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
-->