定義和用法
mysql_pconnect() 函數開啟一個到 MySQL 伺服器的持久串連。
mysql_pconnect() 和 mysql_connect() 非常相似,但有兩個主要區別:
- 當串連的時候本函數將先嘗試尋找一個在同一個主機上用同樣的使用者名稱和密碼已經開啟的(持久)串連,如果找到,則返回此串連標識而不開啟新串連。
- 其次,當指令碼執行完畢後到 SQL 伺服器的串連不會被關閉,此串連將保持開啟以備以後使用(mysql_close() 不會關閉由 mysql_pconnect() 建立的串連)。
文法
mysql_pconnect(server,user,pwd,clientflag)
| 參數 |
描述 |
| server |
可選。規定要已連線的服務器。 可以包括連接埠號碼,例如 "hostname:port",或者到本地通訊端的路徑,例如對於 localhost 的 ":/path/to/socket"。 如果 PHP 指令 mysql.default_host 未定義(預設情況),則預設值是 'localhost:3306'。 |
| user |
可選。使用者名稱。預設值是伺服器處理序所有者的使用者名稱。 |
| pwd |
可選。密碼。預設值是空密碼。 |
| clientflag |
可選。client_flags 參數可以是以下常量的組合:
- MYSQL_CLIENT_SSL - 使用 SSL 加密
- MYSQL_CLIENT_COMPRESS - 使用壓縮協議
- MYSQL_CLIENT_IGNORE_SPACE - 允許函數名後的間隔
- MYSQL_CLIENT_INTERACTIVE - 允許關閉串連之前的互動逾時非啟用時間
|
傳回值
如果成功,則返回一個 MySQL 持久串連標識符,出錯則返回 FALSE。
提示和注釋
注釋:選擇性參數 clientflag 自 PHP 4.3.0 版起可用。
提示:要建立一個非持久串連,請使用 mysql_connect() 函數。
例子
<?php$con = mysql_pconnect("localhost","mysql_user","mysql_pwd");if (!$con) { die('Could not connect: ' . mysql_error()); }?>