(PHP 4, PHP 5)
mysql_pconnect — Устанавливает постоянное соединение с сервером MySQL
Данное расширение устарело, начиная с версии PHP 5.5.0, и удалено в PHP 7.0.0. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API и соответствующий FAQ для получения более подробной информации. Альтернативы для данной функции:
PDO::ATTR_PERSISTENT
$server
= ini_get("mysql.default_host")
[, string $username
= ini_get("mysql.default_user")
[, string $password
= ini_get("mysql.default_password")
[, int $client_flags
= 0
]]]] )Устанавливает постоянное соединение с сервером 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
в случае ошибки.
Версия | Описание |
---|---|
5.5.0 |
Эта функция теперь вызывает ошибку E_DEPRECATED .
|
Замечание:
Учтите, что соединения такого типа работают только, если PHP установлен как модуль. За дополнительной информацией обращайтесь к разделу "Постоянные соединения с базами данных".
Использование постоянных соединений может потребовать некоторой настройки Apache и MySQL. Убедитесь, что вы не превысите максимальное число дозволенных соединений в MySQL.
Замечание:
Можно подавить сообщение об ошибке при неудачном соединении поставив перед вызовом функции оператор @.