PHP连接PostgreSQL数据库的正确方式及连接超时问题排查

嘿，我来帮你拆解这两个问题：

一、超时错误SQLSTATE[HY000] [2002] Operation timed out到底是什么意思？ #

这个错误直白点说就是你的PHP脚本没法在规定时间内和目标数据库服务器建立网络连接，常见的触发原因有这些：

• 你填的IP地址不对，或者PostgreSQL默认的5432端口没开放（毕竟你写的是MySQL的连接代码，可能没考虑到端口差异）
• 数据库服务器的防火墙/安全组把你的请求挡了，没允许访问5432端口
• 数据库服务压根没启动，或者它只监听了本地localhost，没对外网IP开放
• 你这边和数据库服务器之间的网络有问题，比如延迟太高或者路由断了

二、你当前的代码完全不对——这是连接MySQL的写法！ #

你现在用的是mysql:前缀的DSN，这是给MySQL用的PDO连接方式，PostgreSQL得用专门的pgsql:前缀，还有几个细节要注意：

1. DSN前缀必须改成pgsql:
2. PostgreSQL默认端口是5432，建议在DSN里明确写出来，避免和MySQL的3306端口混淆
3. 虽然数据库名参数dbname和MySQL一致，但其他参数比如端口的写法是统一的port=xxx

给你贴个正确的PostgreSQL PDO连接代码： #

$dsn = 'pgsql:dbname=NAME;host=IPADDRESS;port=5432';
$user = 'USERNAME';
$password = 'PASSWORD';
try {
    $dbh = new PDO($dsn, $user, $password);
    $dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "成功连上PostgreSQL啦！";
} catch (PDOException $e) {
    echo 'Connection failed: ' . $e->getMessage();
}

额外给你几个排查小技巧： #

• 先在终端用telnet IPADDRESS 5432或者nc -zv IPADDRESS 5432测一下能不能通，确认端口是开放的
• 去pgAdmin里检查数据库的远程访问配置：要修改postgresql.conf里的listen_addresses为*，还要在pg_hba.conf里添加允许你当前IP访问的规则
• 确认你用的用户名密码是PostgreSQL的账号，别搞混了MySQL的账号

内容的提问来源于stack exchange，提问作者Oba Api