php_pdo_pgsql 扩展没启用，new PDO() 直接报错
PHP 连 PostgreSQL 不是光写对 DSN 就能通的，底层依赖 pdo_pgsql 扩展。没启用时常见错误是：PDOException: could not find driver 或 Class 'PDO' not found（后者说明连 PDO 都没加载）。
检查方法：运行 php -m | grep pgsql，或写个 phpinfo() 页面搜 pdo_pgsql。没看到就说明没开。
- Linux（apt）：
sudo apt install php-pgsql，然后重启 web 服务（如sudo systemctl restart apache2或php-fpm） - macOS（Homebrew + PHP）：
brew install php@8.2-pgsql（版本按需替换），再确认extension=pdo_pgsql.so在php.ini里已取消注释 - Windows：打开
php.ini，去掉;extension=php_pdo_pgsql.dll前的分号，确保php_pdo.dll也已启用
DSN 写错导致连接失败，host、port、dbname 必须显式指定
PostgreSQL 的 PDO DSN 格式不像 MySQL 那样宽松，漏掉 host 或用错端口是高频问题。默认端口是 5432，但很多 Docker 环境或云服务（如 AWS RDS、Supabase）会改端口，不写就直连本地 localhost:5432，大概率连不上。
正确 DSN 示例：pgsql:host=db.example.com;port=5433;dbname=myapp;user=api;password=xxx
立即学习“PHP免费学习笔记（深入）”；
-
host不能写成127.0.0.1就以为是本地——Docker 容器里连宿主数据库要用宿主网关 IP（如host.docker.internal），不是localhost -
dbname区分大小写，且不能带空格或特殊字符；如果数据库名含短横线（如my-db），必须用双引号包裹（但 DSN 里不支持引号，得在 SQL 里处理，所以建议建库时避开） - 密码含特殊字符（如
@、/）要 URL 编码，例如pass@123→pass%40123
连接后查不出数据，PDO::ATTR_ERRMODE 没设成异常模式
默认 PDO 错误模式是 PDO::ERRMODE_SILENT，执行失败只返回 false，不报错也不提示原因。你调了 $stmt->execute() 却没结果，可能只是权限不足、表名拼错、字段不存在，但 PHP 一声不吭。
务必在创建 PDO 实例后立即设置：$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION)
- 否则
$stmt->fetch()返回false时，你得手动查$pdo->errorInfo()，效率低还容易漏 - 云数据库（如 Neon、Render）常限制非超级用户建 schema 或访问
pg_catalog，报错可能是permission denied for schema public，而不是“表不存在” - PostgreSQL 默认事务隔离级别比 MySQL 高，某些并发场景下
SELECT可能被阻塞，加SET statement_timeout = '5s'到 DSN 后可防卡死
跨数据库连接时，pg_connect() 和 PDO 别混用
一个项目里同时用 pg_connect()（过程式）和 PDO（面向对象）会导致连接资源混乱。PostgreSQL 服务端把每个连接当独立会话，事务、search_path、临时表都不共享。你用 pg_connect() 开了个连接改了 search_path，再用 PDO 查，还是默认 schema。
- 选一种风格到底：新项目无脑用
PDO；老代码迁移时，别留pg_query()调用，它们不会复用PDO的连接 -
PDO的长连接靠PDO::ATTR_PERSISTENT => true，但 PostgreSQL 对持久连接支持有限，高并发下易出现连接泄漏，生产环境慎用 - Docker 多容器部署时，PHP 容器和 PostgreSQL 容器必须在同一个自定义网络（
docker network create mynet），且host填容器名（如db），不是localhost
PostgreSQL 的权限模型、schema 机制和连接生命周期比 MySQL 细腻得多，连上只是第一步。真正卡住人的，往往是 schema 没切对、用户没授权、或者 Docker 网络没打通——这些地方不报明确错误，只默默返回空结果。
