2024 年 PHP Conference Japan

PDO::connect

(沒有版本資訊,可能只在 Git 中)

PDO::connect連線到資料庫並返回支援它的驅動程式的 PDO 子類別

說明

public static PDO::connect(
    字串 $dsn,
    ?字串 $username = null,
    #[\SensitiveParameter] ?字串 $password = null,
    ?陣列 $options = null
): static

如果存在要連線的資料庫,則建立該資料庫的 PDO 子類別的實例,否則返回一個通用的 PDO 實例。

參數

dsn

資料來源名稱 (Data Source Name,簡稱 DSN) 包含連線到資料庫所需的資訊。

通常,DSN 由 PDO 驅動程式名稱、冒號以及 PDO 驅動程式特定的連線語法組成。更多資訊請參閱 PDO 驅動程式特定文件

dsn 參數支援三種不同的方法來指定建立資料庫連線所需的參數

驅動程式呼叫

dsn 包含完整的 DSN。

URI 呼叫

dsnuri: 後面接著一個定義包含 DSN 字串的檔案位置的 URI 組成。URI 可以指定本地檔案或遠端 URL。

uri:file:///path/to/dsnfile

別名

dsn 由名稱 name 組成,該名稱對應到 php.ini 中定義 DSN 字串的 pdo.dsn.name

注意事項:

別名必須在 php.ini 中定義,而不是 .htaccesshttpd.conf

username (使用者名稱)

DSN 字串的使用者名稱。對於某些 PDO 驅動程式,此參數是可選的。

password (密碼)

DSN 字串的密碼。對於某些 PDO 驅動程式,此參數是可選的。

options (選項)

一個鍵值對陣列,包含驅動程式特定的連線選項。

回傳值

如果存在對應的 PDO 驅動程式,則返回該驅動程式的 PDO 子類別的實例,否則返回一個通用的 PDO 實例。

錯誤/例外

如果嘗試連線到請求的資料庫失敗,則會拋出 PDOException,無論目前設定的 PDO::ATTR_ERRMODE 為何。

另請參閱

新增註釋

使用者提供的註釋

此頁面沒有使用者提供的註釋。
To Top