php 8.5.5 连接数据库失败需精准定位原因：区分连接参数错误、服务不可达或扩展未启用；pgsql 扩展默认未加载，需手动安装并验证配置；连接字符串格式、dsn 规范、socket 路径及资源类型校验均须严格符合要求。
PHP 8.5.5 连接数据库失败时，不能只靠 try...catch 吞掉错误——必须区分是连接参数错、服务不可达，还是扩展未启用，否则日志里只留一个空警告，问题永远在原地打转。
pg_connect 返回 false 却没报错？先查扩展和连接串格式
PHP 8.5.5 默认不带 pgsql 扩展，pg_connect 直接不可用。运行 php -m | grep pgsql，若无输出，说明扩展根本没加载。
- Debian/Ubuntu：执行
sudo apt-get install php-pgsql，然后重启 PHP-FPM 或 Apache - 确认
php.ini中已启用：extension=pgsql.so和extension=pdo_pgsql.so -
pg_connect字符串里等号前后必须有空格，单引号包裹密码——错误写法："host=localhost;dbname=test"；正确写法："host=localhost dbname=test user=postgres password='123'" - 漏掉空格或引号会导致函数静默返回
false，且pg_last_error()也拿不到有效信息
PDO 连接抛出 PDOException？重点看 DSN 和驱动状态
用 PDO 连 PostgreSQL 时，常见错误是 SQLSTATE[08006] [7] could not connect to server，这说明连接参数没错，但服务压根没响应。
- 先验证 PostgreSQL 是否运行：
sudo systemctl status postgresql - 检查
postgresql.conf中listen_addresses是否包含'localhost'或'*' - 确认
pg_hba.conf有对应规则，例如：host all all 127.0.0.1/32 md5 - DSN 写法要严格：用分号分隔，不能混用斜杠或问号——错误示例：
"pgsql://user:pass@localhost/test"；正确写法："pgsql:host=localhost;port=5432;dbname=test"
mysqli_connect 失败却显示 “No such file or directory”？大概率是 socket 路径错
这个错误不是网络不通，而是 PHP 尝试走 Unix socket 连接，但指定的 socket 文件路径不存在或权限不对。
- MySQL 默认 socket 路径通常是
/var/run/mysqld/mysqld.sock或/tmp/mysql.sock，可通过mysql --socket=/path/to/socket -u root -p验证 - 在
mysqli_connect中显式指定 socket：mysqli_connect("localhost:/var/run/mysqld/mysqld.sock", ...) - 或者改用
127.0.0.1强制走 TCP：mysqli_connect("127.0.0.1", ...)，绕过 socket 查找逻辑 - PHP 8.5.5 对 socket 路径校验更严，路径末尾多一个斜杠或少一个字母都会直接失败
连接成功但后续查询崩了？资源变量被覆盖或关闭了
pg_connect 返回的是 resource 类型，不是对象，传错变量名或被函数内部重置，就会导致 pg_query($conn, ...) 报 Warning: pg_query(): supplied resource is not a valid PostgreSQL link resource。
- 不要在函数里用
global $conn后又赋值$conn = null，尤其注意大小写——$Conn和$conn是两个变量 - 避免在函数末尾调用
pg_close($conn)，除非你明确不再需要该连接 - 调试时加一句：
var_dump(gettype($conn), $conn === false ? 'failed' : 'ok');，比只看if (!$conn)更早发现问题 - PHP 8.5.5 已彻底移除对旧版资源自动转换的支持，
is_resource($conn)必须为true才能继续操作
真正卡住人的从来不是“连不上”，而是连上后查不了、查了没结果、结果里字段名突然变小写——这些细节在 PHP 8.5.5 里不会给你留宽容余地，得靠每一步都验证类型和状态，而不是等报错才回头翻日志。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
