(PHP 4, PHP 5)
mysql_pconnect — 打開一個到 MySQL 服務(wù)器的持久連接
說明
resource mysql_pconnect ([ string$server
[, string $username
[, string $password
[, int $client_flags
]]]] )
如果成功則返回一個正的 MySQL 持久連接標識符,出錯則返回 FALSE
。
mysql_pconnect()
建立一個到 MySQL
服務(wù)器的連接。如果沒有提供可選參數(shù),則使用如下默認值:server
=
'localhost:3306',username
=
服務(wù)器進程所有者的用戶名,password
=
空密碼。client_flags
參數(shù)可以是以下常量的組合:MYSQL_CLIENT_COMPRESS,MYSQL_CLIENT_IGNORE_SPACE
或者 MYSQL_CLIENT_INTERACTIVE。
server
參數(shù)也可以包括端口號,例如
"hostname:port",或者是本機套接字的的路徑,例如
":/path/to/socket"。
Note:
對 ":port" 的支持是 3.0B4 版添加的。
對 ":/path/to/socket" 的支持是 3.0.10 版添加的。
mysql_pconnect() 和 mysql_connect() 非常相似,但有兩個主要區(qū)別。
首先,當連接的時候本函數(shù)將先嘗試尋找一個在同一個主機上用同樣的用戶名和密碼已經(jīng)打開的(持久)連接,如果找到,則返回此連接標識而不打開新連接。
其次,當腳本執(zhí)行完畢后到 SQL 服務(wù)器的連接不會被關(guān)閉,此連接將保持打開以備以后使用(mysql_close() 不會關(guān)閉由 mysql_pconnect() 建立的連接)。
可選參數(shù)
client_flags
自 PHP 4.3.0 版起可用。
此種連接稱為“持久的”。
Note:
注意,此種連接僅能用于模塊版本的 PHP。更多信息參見數(shù)據(jù)庫持久連接一節(jié)。
Warning使用持久連接需要調(diào)整一些 Apache 和 MySQL 的配置以使不會超出 MySQL 所允許的連接數(shù)目。