使用pdo连接mysql时，dsn字符串的格式为`mysql:host=ip;port=端口;dbname=数据库名`。只需实例化`pdo`类并传入该字符串、用户名和密码即可建立连接。若连接失败，通常是因为主机地址错误、端口未开放或凭据不正确。
如何构建包含特定主机和端口的PDO DSN
构建DSN的核心在于正确拼接`host`、`port`和`dbname`参数。默认情况下，如果端口是3306且主机是localhost，可以省略部分参数，但为了明确性和跨平台兼容性（如Docker环境），建议显式指定所有关键信息。PHP的PDO扩展通过解析这个字符串来确定后端驱动和连接目标。
$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=my_database';
$username = 'root';
$password = 'secret';
try {
$pdo = new PDO($dsn, $username, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "连接成功";
} catch (PDOException $e) {
echo "连接失败: " . $e->getMessage();
}上述代码中，`$dsn`变量严格遵循了格式要求。`host`指定服务器地址，`port`指定监听端口，`dbname`指定要操作的数据库。执行后，如果网络通畅且凭据正确，将输出“连接成功”。如果发生错误，`PDOException`会捕获具体原因，如“SQLSTATE[HY000] [2002] Connection refused”。
立即学习“PHP免费学习笔记（深入）”；
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
DSN中不同主机类型对连接行为的影响
当`host`设置为`localhost`与`127.0.0.1`时，底层连接机制可能不同。在大多数Linux系统中，`localhost`会优先尝试使用Unix Socket文件进行本地通信，而忽略`port`参数（除非显式指定）。如果使用`127.0.0.1`，则强制使用TCP/IP协议，此时`port`参数生效。这种差异在排查本地开发环境问题时常被忽视。
// 情况1：使用 localhost，可能走Socket，忽略port
$dsn1 = 'mysql:host=localhost;dbname=test';
// 情况2：使用 127.0.0.1，强制TCP，使用port
$dsn2 = 'mysql:host=127.0.0.1;port=3307;dbname=test';
try {
// 测试TCP连接
$pdo = new PDO($dsn2, 'user', 'pass');
echo "TCP连接成功";
} catch (PDOException $e) {
echo "TCP连接失败: " . $e->getMessage();
}在实际部署中，如果MySQL配置了非标准端口或仅监听TCP，必须使用IP地址而非`localhost`关键字。此外，如果数据库名不存在，连接本身可能成功（取决于MySQL配置），但在执行查询时会报错。因此，验证连接时应结合简单的查询语句，如`SELECT 1`，以确保整个链路畅通。
连接成功后如何验证具体的数据库状态
建立连接后，可以通过`PDO`对象获取当前连接的元数据，例如实际使用的数据库名、服务器版本等。这有助于确认DSN中的`dbname`是否真正生效，以及服务器是否接受了连接请求。使用`getAttribute`方法可以安全地提取这些信息，避免直接执行SQL带来的潜在风险。
$pdo = new PDO('mysql:host=127.0.0.1;port=3306;dbname=test_db', 'user', 'pass');
// 获取实际连接的数据库名
$dbName = $pdo->getAttribute(PDO::ATTR_DATABASE);
echo "当前数据库: " . $dbName;
// 获取服务器版本
$version = $pdo->getAttribute(PDO::ATTR_SERVER_VERSION);
echo "服务器版本: " . $version;这段代码展示了如何在连接建立后，通过属性获取器验证连接状态。`PDO::ATTR_DATABASE`返回DSN中指定的数据库名，如果该库不存在且MySQL允许空库连接，它仍会返回该名称。`PDO::ATTR_SERVER_VERSION`则提供服务器的详细版本信息，可用于兼容性检查。这些验证步骤能确保程序在正确的数据库环境中运行。
