如何在 PHP 中成功连接 PostgreSQL 数据库

本文详解在本地 mamp 环境下使用 php 连接 postgresql 的关键步骤，重点解决因未启用 `pgsql` 扩展导致的连接静默失败问题，并提供配置验证、代码优化与常见排错方法。

在 MAMP（Free 版）环境中运行 PHP 并连接 PostgreSQL 时，最常见的“无报错、无响应、仅显示部分输出”现象（如你看到 This is it: 却看不到 connected 或错误提示），根本原因几乎总是 PHP 未加载 pgsql 扩展——即 PostgreSQL 的原生驱动未启用。MAMP 自带的 PHP 默认不启用 pgsql，即使 PostgreSQL 服务已正常运行（可通过 pgAdmin 4 验证），PHP 仍会因缺少驱动而无法识别 pg_connect() 等函数，导致脚本在调用处静默中断（函数未定义 → 后续代码不执行）。

✅ 正确配置步骤如下：

1. 确认 PostgreSQL 服务正在运行
   打开 pgAdmin 4，能成功登录并查看数据库（如 first_creation），说明 PostgreSQL 服务（默认端口 5432）已就绪。

2. 启用 PHP 的 pgsql 扩展

   • 在 MAMP 主界面点击 Preferences → PHP → PHP extension，勾选 pgsql 和 pdo_pgsql（推荐同时启用，便于后续使用 PDO）。
   • 或手动编辑 php.ini：
     找到 MAMP 对应 PHP 版本的 php.ini 文件（路径类似 /Applications/MAMP/bin/php/php[version]/conf/php.ini），取消以下两行的注释（删除前面的分号 ;）：

     extension=pgsql
     extension=pdo_pgsql

   • ✅ 重要：修改后必须重启 MAMP 服务器（而非仅刷新网页），否则配置不生效。

3. 验证扩展是否加载成功
   创建一个 info.php 文件，内容为：

   访问 http://localhost:8888/info.php，搜索 pgsql —— 若看到 "PostgreSQL Support enabled" 及相关版本信息，则扩展已生效。

4. 修复并增强你的连接代码
   原始代码存在两个关键隐患：

   • pg_query() 在 $db_connection 失败时会因变量未定义而报错（或静默终止）；
   • 缺少错误上下文，难以定位问题根源。

   推荐改写为健壮版本：

   ";
   
   $conn_string = "host=localhost port=5432 dbname=first_creation user=postgres password=1234";
   $db_connection = pg_connect($conn_string);
   
   if (!$db_connection) {
       // 获取并显示连接错误详情（开发阶段务必开启）
       $error = pg_last_error();
       echo "Connection failed: " . htmlspecialchars($error);
       exit;
   }
   
   echo "Connected successfully!
   ";
   
   $result = pg_query($db_connection, "SELECT text_content FROM strings");
   if (!$result) {
       echo "Query failed: " . htmlspecialchars(pg_last_error($db_connection));
       pg_close($db_connection);
       exit;
   }
   
   // 输出查询结果
   while ($row = pg_fetch_assoc($result)) {
       echo "Content: " . htmlspecialchars($row['text_content']) . "
   ";
   }
   
   pg_free_result($result);
   pg_close($db_connection);
   ?>

⚠️ 注意事项与常见陷阱：

• 端口检查：MAMP 默认 Apache 使用 8888 端口，但 PostgreSQL 默认监听 5432。确保连接字符串中 port=5432（除非你主动修改过 PostgreSQL 的 postgresql.conf）。
• 用户权限与密码：postgres 用户需有访问 first_creation 库的权限，且密码 1234 必须与 pg_hba.conf 中配置的认证方式匹配（建议初学者使用 md5 认证）。
• 防火墙/安全软件：某些安全软件可能拦截本地 5432 端口通信，临时禁用测试。
• MAMP 版本兼容性：较新版本 MAMP（如 6+）对 PHP 扩展管理更友好，旧版可能需手动编译扩展（极少见，优先尝试勾选方式）。

总结：PHP 连接 PostgreSQL 失败，90% 源于 pgsql 扩展未启用。务必通过 phpinfo() 验证，再结合带错误捕获的连接代码调试。配置一次，即可稳定使用——后续可平滑迁移到 PDO 或 Laravel Eloquent 等高级抽象层。