打開一個到 MySQL 伺服器的持久連線

mysql_pconnect

(PHP 4, PHP 5)

mysql_pconnect打開一個到 MySQL 伺服器的持久連線

警告

本擴充套件自 PHP 5.5.0 起已廢棄,並在自 PHP 7.0.0 開始被移除。應使用 MySQLiPDO_MySQL 擴充套件來替換之。參見 MySQL:選擇 API 指南來獲取更多資訊。用以替代本函式的有:

說明

mysql_pconnect(
    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 (enable LOAD DATA LOCAL handling), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACEMYSQL_CLIENT_INTERACTIVE

返回值

如果成功則返回一個正的 MySQL 持久連線識別符號,出錯則返回 false

更新日誌

版本 說明
5.5.0 函式會拋出一個 E_DEPRECATED 錯誤。

註釋

注意:

需要注意的是,此函式僅當在 PHP 模組化執行時才會生效。更多資訊請參閱 持久數據庫連線 章節。

警告

使用持久連線可能需要對 Apache 和 MySQL 配置進行一些調整,以確保不超過 MySQL 伺服器允許的最大連線數。

參見

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *