<?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 => 'uk',
  ),
  'this' => 
  array (
    0 => 'function.mysql-ping.php',
    1 => 'mysql_ping',
    2 => 'Ping a server connection or reconnect if there is no connection',
  ),
  'up' => 
  array (
    0 => 'ref.mysql.php',
    1 => 'MySQL Функції',
  ),
  'prev' => 
  array (
    0 => 'function.mysql-pconnect.php',
    1 => 'mysql_pconnect',
  ),
  'next' => 
  array (
    0 => 'function.mysql-query.php',
    1 => 'mysql_query',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/mysql/functions/mysql-ping.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mysql-ping" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mysql_ping</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.3.0, PHP 5)</p><p class="refpurpose"><span class="refname">mysql_ping</span> &mdash; <span class="dc-title">Ping a server connection or reconnect if there is no connection</span></p>

 </div>

 <div id="function.mysql-ping-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="mysqli.ping.php" class="function">mysqli_ping()</a></span></li>
   </ul>
  </div>
 </div>

 <div class="refsect1 description" id="refsect1-function.mysql-ping-description">
  <h3 class="title">Опис</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mysql_ping</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$link_identifier</code><span class="initializer"> = NULL</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   Checks whether or not the connection to
   the server is working. If it has gone down, an automatic reconnection is
   attempted. This function can be used by scripts that remain idle for a
   long while, to check whether or not the server has closed the connection
   and reconnect if necessary.
  </p>
  <blockquote class="note"><p><strong class="note">Зауваження</strong>: 
   <p class="para">
    Automatic reconnection is disabled by default in versions of MySQL &gt;= 5.0.3.
   </p>
  </p></blockquote>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mysql-ping-parameters">
  <h3 class="title">Параметри</h3>
  <p class="para">
   <dl>
    <dt>
<code class="parameter">link_identifier</code></dt><dd><p class="para">З&#039;єднання
MySQL. Якщо не задано, буде обрано останнє з&#039;єднання, встановлене функцією
<span class="function"><a href="function.mysql-connect.php" class="function">mysql_connect()</a></span>. Якщо з&#039;єднатися не вдалось, функція
спробує встановити нове, ніби викликавши функцію
<span class="function"><a href="function.mysql-connect.php" class="function">mysql_connect()</a></span> без параметрів. Якщо з&#039;єднання не
вдалося знайти або встановити, буде виведено повідомлення рівня
<strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong></p></dd>
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mysql-ping-returnvalues">
  <h3 class="title">Значення, що повертаються</h3>
  <p class="para">
   Returns <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> if the connection to the server MySQL server is working, 
   otherwise <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.mysql-ping-examples">
  <h3 class="title">Приклади</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Приклад #1 A <span class="function"><strong>mysql_ping()</strong></span> example</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />set_time_limit</span><span style="color: #007700">(</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysqluser'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mypass'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$db   </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_select_db</span><span style="color: #007700">(</span><span style="color: #DD0000">'mydb'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Assuming this query will take a long time */<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$sql</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$result</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">'Query #1 failed, exiting.'</span><span style="color: #007700">;<br />    exit;<br />}<br /><br /></span><span style="color: #FF8000">/* Make sure the connection is still alive, if not, try to reconnect */<br /></span><span style="color: #007700">if (!</span><span style="color: #0000BB">mysql_ping</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">)) {<br />    echo </span><span style="color: #DD0000">'Lost connection, exiting after query #1'</span><span style="color: #007700">;<br />    exit;<br />}<br /></span><span style="color: #0000BB">mysql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* So the connection is still alive, let's run another query */<br /></span><span style="color: #0000BB">$result2 </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$sql2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.mysql-ping-seealso">
  <h3 class="title">Прогляньте також</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.mysql-thread-id.php" class="function" rel="rdfs-seeAlso">mysql_thread_id()</a> - Return the current thread ID</span></li>
    <li><span class="function"><a href="function.mysql-list-processes.php" class="function" rel="rdfs-seeAlso">mysql_list_processes()</a> - List MySQL processes</span></li>
   </ul>
  </p>
 </div>

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