mysql_pconnect
(PHP 4, PHP 5)
mysql_pconnect — 打開一個到 MySQL 伺服器的持久連線
本擴充套件自 PHP 5.5.0 起已廢棄,並在自 PHP 7.0.0 開始被移除。應使用 MySQLi 或 PDO_MySQL 擴充套件來替換之。參見 MySQL:選擇 API 指南來獲取更多資訊。用以替代本函式的有:
- mysqli_connect() with
p:
host prefix - PDO::__construct() with
PDO::ATTR_PERSISTENT
as a driver option
說明
string
$server
= ini_get("mysql.default_host"),string
$username
= ini_get("mysql.default_user"),string
$password
= ini_get("mysql.default_password"),int
$client_flags
= 0): resource
打開一個到 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 (enableLOAD 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 伺服器允許的最大連線數。