Устанавливает постоянное соединение с сервером MySQL

# mysql_pconnect

(PHP 4, PHP 5)

mysql_pconnect — Устанавливает постоянное соединение с сервером MySQL

Внимание

Данный модуль устарел начиная с версии PHP 5.5.0, и удалён в PHP 7.0.0. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API. Альтернативы для этой функции:

- mysqli_connect() с `p:` префиксом хоста
- PDO::__construct() с опцией драйвера `PDO::ATTR_PERSISTENT`

### Описание

function mysql_pconnect(
string `$server` = ini_get("mysql.default_host"),
string `$username` = ini_get("mysql.default_user"),
string `$password` = ini_get("mysql.default_password"),
int `$client_flags` = 0
): resource

Устанавливает постоянное соединение с сервером MySQL.

mysql_pconnect() работает аналогично mysql_connect() с двумя важными отличиями.

Во-первых, при соединении функция пытается найти уже открытый (постоянный) указатель на тот же сервер с тем же пользователем и паролем. Если он найден, возвращён функцией будет именно он, вместо открытия нового соединения.

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

Соединения такого типа называют 'постоянными'.

### Список параметров

`server`
  Сервер MySQL. Может также включать номер порта, например, "hostname:port" или путь к локальному сокету, например, ":/path/to/socket" для локального хоста. Если директива mysql.default_host не определена (по умолчанию), то по умолчанию используется значение 'localhost:3306'
`username`
  Имя пользователя. По умолчанию используется имя пользователя, владеющего серверным процессом.
`password`
  Пароль. По умолчанию используется пустая строка.
`client_flags`
  Параметр `client_flags` может быть комбинацией следующих констант: 128 (включает обработку `LOAD DATA LOCAL`), `MYSQL_CLIENT_SSL`, `MYSQL_CLIENT_COMPRESS`, `MYSQL_CLIENT_IGNORE_SPACE` и `MYSQL_CLIENT_INTERACTIVE`.

### Возвращаемые значения

Возвращает дескриптор постоянного соединения MySQL в случае успешного выполнения, и `false` в случае возникновения ошибки.

### Примечания

> Замечание: Учтите, что соединения такого типа работают только, если PHP установлен как модуль. За дополнительной информацией обращайтесь к разделу "Постоянные соединения с базами данных".

Внимание

Использование постоянных соединений может потребовать некоторой настройки Apache и MySQL. Убедитесь, что вы не превысите максимальное число дозволенных соединений в MySQL.

### Смотрите также

- mysql_connect() - Открывает соединение с сервером MySQL
- "Постоянные соединения с базами данных"

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open