大网数据广告活动
PHP 语言与运行手册

PDO::connect · 连接到数据库,如果驱动支持则返回 PDO 子类实例

· 52CE 我爱测

如果所连接的数据库存在对应的 PDO 子类, 则创建该子类的实例,否则返回通用的 PDO 实例。

PDO::connect

(PHP 8 >= 8.4.0)

PDO::connect — 连接到数据库,如果驱动支持则返回 PDO 子类实例

说明

public static function PDO::connect(
    string $dsn,
    ?string $username = null,
    #[\SensitiveParameter] ?string $password = null,
    ?array $options = null
): static

如果所连接的数据库存在对应的 PDO 子类, 则创建该子类的实例,否则返回通用的 PDO 实例。

参数

dsn

数据源名称或叫做 DSN,包含了请求连接到数据库的信息。

通常,一个 DSN 由 PDO 驱动名、紧随其后的冒号、以及具体 PDO 驱动的连接语法组成。更深入的信息能从 PDO 具体驱动文档找到。

dsn 参数支持三种不同的方式 创建一个数据库连接:

驱动程序调用

dsn 包含完整的DSN。

URI 调用

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

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

别名

dsn 由映射到 php.ini 中定义 DSN 字符串的 pdo.dsn.name 的 name 名组成。

注意:

别名必须得在 php.ini 中定义了,不能是在 .htaccess 或 httpd.conf 中 。

username

DSN字符串中的用户名。对于某些PDO驱动,此参数为可选项。

password

DSN字符串中的密码。对于某些PDO驱动,此参数为可选项。

options

一个具体驱动的连接选项的键=>值数组。

返回值

如果对应的 PDO 驱动存在子类,则返回该 PDO 子类的实例,否则返回通用的 PDO 实例。

错误/异常

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

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。