概述
說明
resource mysql_connect ( [string server [, string username [, string password [, bool new_link [, int client_flags]]]]] )
如果成功則返回一個 MySQL 連線標識,失敗則返回 FALSE。
mysql_connect() 建立一個到 MySQL 伺服器的連線。當沒有提供可選參數時使用以下默認值:server = 'localhost:3306',username = 伺服器進程所有者的用戶名,password = 空密碼。
server 參數可以包括連線埠號。例如 "hostname:port" 或者是到本地套接字的路徑,例如本機上的 ":/path/to/socket"。
注: 無論指定 "localhost" 或者 "localhost:port" 作為 server,MySQL 客戶端庫將覆蓋之並嘗試連線到本地套接字(Windows 中的名字管道)。如果希望使用 TCP/IP 連線,用 "127.0.0.1" 替代 "localhost"。如果 MySQL 客戶端庫試圖連線到錯誤的本地套接字,則應該在 PHP 配置中將 mysql.default_host 設為正確的路徑並使 server 欄位為空。
":port" 的支持是 PHP 3.0B4 起加入的。
":/path/to/socket" 的支持是 PHP 3.0.10 起加入的。
可以在函式名前加上 @ 來抑制失敗時產生的錯誤信息。
如果用同樣的參數第二次調用 mysql_connect(),將不會建立新連線,而將返回已經打開的連線標識。參數 new_link 改變此行為並使 mysql_connect() 總是打開新的連線,甚至當 mysql_connect() 曾在前面被用同樣的參數調用過。參數 client_flags 可以是以下常量的組合:MYSQL_CLIENT_COMPRESS,MYSQL_CLIENT_IGNORE_SPACE 或者 MYSQL_CLIENT_INTERACTIVE。
注: new_link 參數自 PHP 4.2.0 起可用。
client_flags 參數自 PHP 4.3.0 起可用。
一旦腳本結束,到伺服器的連線就會被關閉。除非之前已經調用了 mysql_close() 來關閉它。
例子 1
. MySQL 連線例子
例子2
在下面的例子中,我們在一個變數中 ($con) 存放了在腳本中供稍後使用的連線。如果連線失敗,將執行 "die" 部分:
關閉連線
腳本一結束,就會關閉連線。如需提前關閉連線,請使用 mysql_close() 函式。
參見 mysql_pconnect() 和 mysql_close()。