PHP mysql_pconnect() функция

Определение и использование

Функция mysql_pconnect() открывает постоянное соединение с сервером MySQL.

mysql_pconnect() и mysql_connect() очень похожи, но есть две основные различия:

  1. При подключении функция пытается найти уже открытые (постоянные) соединения с одним и тем же именем пользователя и паролем на том же хосте, если такое соединение найдено, то возвращается идентификатор этого соединения, и не открывается новое соединение.
  2. Вторым моментом является то, что после выполнения скрипта соединение с SQL-сервером не закрывается, это соединение остается открытым для использования в будущем (mysql_close() не закрывает соединение, созданное mysql_pconnect()).

Синтаксис

mysql_pconnect(server,user,pwd,clientflag)
Параметры Описание
server

Опционально. Определяет сервер, к которому нужно подключиться.

Может включать номер порта, например "hostname:port", или путь к локальному сокету, например для localhost ":/path/to/socket".

Если переменная mysql.default_host не определена (по умолчанию), значение по умолчанию 'localhost:3306'.

user Опционально. Имя пользователя. По умолчанию имя пользователя владельца процесса сервера.
pwd Опционально. Пароль. По умолчанию пустой пароль.
clientflag

Опционально.clientflags Параметр может быть комбинацией следующих констант:

  • MYSQL_CLIENT_SSL - использует шифрование SSL
  • MYSQL_CLIENT_COMPRESS - использует сжатый протокол
  • MYSQL_CLIENT_IGNORE_SPACE - позволяет пробелам после имени функции
  • MYSQL_CLIENT_INTERACTIVE - позволяет закрыть соединение до интерактивного времени простоя

Возвратное значение

Если успешна, возвращает идентификатор постоянного подключения MySQL, в противном случае возвращает FALSE.

Советы и комментарии

Комментарий:Опциональный параметр clientflag Доступно с версии PHP 4.3.0.

Совет:Чтобы создать непостоянное подключение, используйте mysql_connect() Функция.

Пример

<?php
$con = mysql_pconnect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('Не удалось подключиться: ' . mysql_error());
  }
?>