(PHP 4, PHP 5)
mysql_pconnect — 打開一個到 MySQL 服務器的持久連接
本擴展自 PHP 5.5.0 起已廢棄,并在自 PHP 7.0.0 開始被移除。應使用 MySQLi 或 PDO_MySQL 擴展來替換之。參見 MySQL:選擇 API 指南來獲取更多信息。用以替代本函數的有:
p:
host prefixPDO::ATTR_PERSISTENT
as a driver option$server
= ini_get("mysql.default_host"),$username
= ini_get("mysql.default_user"),$password
= ini_get("mysql.default_password"),$client_flags
= 0打開一個到 MySQL 服務器的持久連接。
mysql_pconnect() 和 mysql_connect() 非常相似,但有兩個主要區別。
首先,當連接的時候本函數將先嘗試尋找一個在同一個主機上用同樣的用戶名和密碼已經打開的(持久)連接,如果找到,則返回此連接標識而不打開新連接。
其次,當腳本執行完畢后到 SQL 服務器的連接不會被關閉,此連接將保持打開以備以后使用(mysql_close() 不會關閉由 mysql_pconnect() 建立的連接)。
此種連接稱為“持久的”。
server
MySQL 服務器地址,參數也可以包括端口號,例如 “hostname:port“ 或者是本機套接字的的路徑,例如 “:/path/to/socket“
如果 PHP 配置文件中 mysql.default_host 的值未設置(默認情況下),則默認值為 'localhost:3306'
username
數據庫連接使用的用戶名。默認為當前服務器進程的用戶。
password
數據庫連接使用的密碼。默認為空密碼。
client_flags
參數 client_flags
可以為以下常量:
128 (enable LOAD DATA LOCAL
handling),
MYSQL_CLIENT_SSL
,
MYSQL_CLIENT_COMPRESS
,
MYSQL_CLIENT_IGNORE_SPACE
或
MYSQL_CLIENT_INTERACTIVE
。
如果成功則返回一個正的 MySQL 持久連接標識符,出錯則返回 false
。
版本 | 說明 |
---|---|
5.5.0 |
函數會拋出一個 E_DEPRECATED 錯誤。
|
注意:
需要注意的是,此函數僅當在 PHP 模塊化運行時才會生效。更多信息請參閱 持久數據庫連接 章節。
使用持久連接可能需要對 Apache 和 MySQL 配置進行一些調整,以確保不超過 MySQL 服務器允許的最大連接數。