mysql_pconnect - Устанавливает постоянное соединение с сервером MySQL
Вернуться к: MySQL
mysql_pconnect
(PHP 4, PHP 5)
mysql_pconnect — Устанавливает постоянное соединение с сервером MySQL
Данное расширение устарело, начиная с версии PHP 5.5.0, и будет удалено в будущем. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API и соответствующий FAQ для получения более подробной информации. Альтернативы для данной функции:
- mysqli_connect() с p: префиксом хоста
- PDO::__construct() с опцией драйвера
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.
Замечание:
Можно подавить сообщение об ошибке при неудачном соединении поставив перед вызовом функции оператор @.
Смотрите также
- mysql_connect() - Открывает соединение с сервером MySQL
- "Постоянные соединения с базами данных"
Вернуться к: MySQL