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