<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.mysql.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'function.mysql-pconnect.php',
    1 => 'mysql_pconnect',
    2 => 'Устанавливает постоянное соединение с сервером MySQL',
  ),
  'up' => 
  array (
    0 => 'ref.mysql.php',
    1 => 'MySQL',
  ),
  'prev' => 
  array (
    0 => 'function.mysql-num-rows.php',
    1 => 'mysql_num_rows',
  ),
  'next' => 
  array (
    0 => 'function.mysql-ping.php',
    1 => 'mysql_ping',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/mysql/functions/mysql-pconnect.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mysql-pconnect" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mysql_pconnect</h1>
  <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">mysql_pconnect</span> &mdash; <span class="dc-title">Устанавливает постоянное соединение с сервером MySQL</span></p>

 </div>

 <div id="function.mysql-pconnect-refsynopsisdiv">
  <div class="warning"><strong class="warning">Внимание</strong>
   <p class="para">Данный модуль устарел начиная с версии PHP 5.5.0, и удалён в PHP 7.0.0.
Используйте вместо него <a href="book.mysqli.php" class="link">MySQLi</a> или <a href="ref.pdo-mysql.php" class="link">PDO_MySQL</a>.
Смотрите также инструкцию <a href="mysqlinfo.api.choosing.php" class="link">MySQL: выбор API</a>.
Альтернативы для этой функции:</p>
   <ul class="simplelist">
    <li><span class="function"><a href="function.mysqli-connect.php" class="function">mysqli_connect()</a></span> с <code class="literal">p:</code> префиксом хоста</li>
    <li><span class="methodname"><a href="pdo.construct.php" class="methodname">PDO::__construct()</a></span> с опцией драйвера <strong><code><a href="pdo.constants.php#pdo.constants.attr-persistent">PDO::ATTR_PERSISTENT</a></code></strong></li>
   </ul>
  </div>
 </div>

 <div class="refsect1 description" id="refsect1-function.mysql-pconnect-description">
  <h3 class="title">Описание</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mysql_pconnect</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$server</code><span class="initializer"> = ini_get(&quot;mysql.default_host&quot;)</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$username</code><span class="initializer"> = ini_get(&quot;mysql.default_user&quot;)</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$password</code><span class="initializer"> = ini_get(&quot;mysql.default_password&quot;)</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$client_flags</code><span class="initializer"> = 0</span></span><br>): <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span></div>

  
  <p class="simpara">
   Устанавливает постоянное соединение с сервером MySQL.
  </p>
  
  <p class="simpara">
   <span class="function"><strong>mysql_pconnect()</strong></span> работает аналогично
   <span class="function"><a href="function.mysql-connect.php" class="function">mysql_connect()</a></span> с двумя важными отличиями.
  </p>
  <p class="simpara">
   Во-первых, при соединении функция пытается найти уже открытый
   (постоянный) указатель на тот же сервер с тем же пользователем и паролем.
   Если он найден, возвращён функцией будет именно он, вместо открытия
   нового соединения.
  </p>
  <p class="simpara">
   Во-вторых, соединение с SQL-сервером не будет закрыто, когда работа
   скрипта закончится. Вместо этого, оно останется рабочим для будущего
   использования (<span class="function"><a href="function.mysql-close.php" class="function">mysql_close()</a></span> также не закрывает
   постоянные соединения, открытые <span class="function"><strong>mysql_pconnect()</strong></span>).
  </p>
  <p class="simpara">
   Соединения такого типа называют &#039;постоянными&#039;.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mysql-pconnect-parameters">
  <h3 class="title">Список параметров</h3>
  <dl>
   
    <dt><code class="parameter">server</code></dt>
    <dd>
     <span class="simpara">
      Сервер MySQL. Может также включать номер порта, например,
      &quot;hostname:port&quot; или путь к локальному сокету, например,
      &quot;:/path/to/socket&quot; для локального хоста.
     </span>
     <span class="simpara">
      Если директива <a href="mysql.configuration.php#ini.mysql.default-host" class="link">
      mysql.default_host</a> не определена (по умолчанию), то
      по умолчанию используется значение &#039;localhost:3306&#039;
     </span>
    </dd>
   
   
    <dt><code class="parameter">username</code></dt>
    <dd>
     <span class="simpara">
      Имя пользователя. По умолчанию используется имя пользователя,
      владеющего серверным процессом.
     </span>
    </dd>
   
   
    <dt><code class="parameter">password</code></dt>
    <dd>
     <span class="simpara">
      Пароль. По умолчанию используется пустая строка.
     </span>
    </dd>
   
   
    <dt><code class="parameter">client_flags</code></dt>
    <dd>
     <span class="simpara">
      Параметр <code class="parameter">client_flags</code> может быть
      комбинацией следующих констант:
      128 (включает обработку <code class="literal">LOAD DATA LOCAL</code>),
      <strong><code><a href="mysql.constants.php#constant.mysql-client-ssl">MYSQL_CLIENT_SSL</a></code></strong>,
      <strong><code><a href="mysql.constants.php#constant.mysql-client-compress">MYSQL_CLIENT_COMPRESS</a></code></strong>,
      <strong><code><a href="mysql.constants.php#constant.mysql-client-ignore-space">MYSQL_CLIENT_IGNORE_SPACE</a></code></strong> и
      <strong><code><a href="mysql.constants.php#constant.mysql-client-interactive">MYSQL_CLIENT_INTERACTIVE</a></code></strong>.
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mysql-pconnect-returnvalues">
  <h3 class="title">Возвращаемые значения</h3>
  <p class="simpara">
   Возвращает дескриптор постоянного соединения MySQL в случае успешного выполнения,
   и <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> в случае возникновения ошибки.
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.mysql-pconnect-notes">
  <h3 class="title">Примечания</h3>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <span class="simpara">
    Учтите, что соединения такого типа работают только, если
    PHP установлен как модуль. За дополнительной информацией
    обращайтесь к разделу
    &quot;<a href="features.persistent-connections.php" class="link">Постоянные соединения с
    базами данных</a>&quot;.
   </span>
  </p></blockquote>
  <div class="warning"><strong class="warning">Внимание</strong>
   <p class="simpara">
    Использование постоянных соединений может потребовать некоторой
    настройки Apache и MySQL. Убедитесь, что вы не превысите максимальное
    число дозволенных соединений в MySQL.
   </p>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.mysql-pconnect-seealso">
  <h3 class="title">Смотрите также</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.mysql-connect.php" class="function" rel="rdfs-seeAlso">mysql_connect()</a> - Открывает соединение с сервером MySQL</span></li>
   <li>"<a href="features.persistent-connections.php" class="link">Постоянные
   соединения с базами данных</a>"</li>
  </ul>
 </div>

</div><?php manual_footer($setup); ?>