PHP Conference Japan 2024

PDO::connect

(无版本信息可用,可能仅存在于 Git 中)

PDO::connect连接数据库并为支持它的驱动程序返回 PDO 子类

描述

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

如果存在,则为正在连接的数据库创建一个 PDO 子类的实例,否则返回一个通用的 PDO 实例。

参数

dsn

数据源名称 (DSN) 包含连接到数据库所需的信息。

通常,DSN 由 PDO 驱动程序名称、冒号以及 PDO 驱动程序特定的连接语法组成。更多信息可在 PDO 驱动程序特定文档 中找到。

dsn 参数支持三种不同的方法来指定创建数据库连接所需的参数

驱动程序调用

dsn 包含完整的 DSN。

URI 调用

dsnuri: 后跟定义包含 DSN 字符串的文件位置的 URI 组成。URI 可以指定本地文件或远程 URL。

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

别名

dsn 由一个名称 name 组成,该名称映射到 php.ini 中的 pdo.dsn.name,用于定义 DSN 字符串。

注意:

别名必须在 php.ini 中定义,而不是 .htaccesshttpd.conf

用户名

DSN 字符串的用户名。此参数对于某些 PDO 驱动程序是可选的。

密码

DSN 字符串的密码。此参数对于某些 PDO 驱动程序是可选的。

选项

驱动程序特定的连接选项的键=>值数组。

返回值

如果存在相应的 PDO 驱动程序,则返回 PDO 子类的实例,否则返回一个通用的 PDO 实例。

错误/异常

如果尝试连接到请求的数据库失败,则会抛出 PDOException,无论当前设置了哪个 PDO::ATTR_ERRMODE

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top