PDO::connect
(PHP 8 >= 8.4.0)
PDO::connect — Connect to a database and return a PDO subclass for drivers that support it
说明
string
$dsn
,?string
$username
= null
,#[\SensitiveParameter] ?string
$password
= null
,?array
$options
= null
): static
Creates an instance of a PDO subclass for the database being connection if it exists, otherwise return a generic PDO instance.
参数
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
-
一个具体驱动的连接选项的键=>值数组。
返回值
Returns an instance of a PDO subclass for the corresponding PDO driver if it exists, or a generic PDO instance.
错误/异常
如果试图连接到请求的数据库失败,无论当前设置了哪个 PDO::ATTR_ERRMODE
,则会抛出 PDOException。
参见
- Pdo\Dblib
- Pdo\Firebird
- Pdo\Mysql
- Pdo\Odbc
- Pdo\Pgsql
- Pdo\Sqlite
- PDO::__construct() - 创建一个表示数据库连接的 PDO 实例