PHP连接Heroku Postgres报错：sslmode值'require'在未编译SSL支持时无效

我之前碰到过一模一样的情况，核心问题大概率是PHP的pgsql扩展实际关联的libpq库版本不对——虽然phpinfo()显示SSL enabled，但PHP可能偷偷用了系统自带的旧版libpq（不带完整SSL支持），而非你通过Homebrew安装的10.3版本。下面是一步步的排查和解决方法：

1. 确认PHP的pgsql扩展使用的libpq版本 #

先执行这条命令，查看PHP实际调用的libpq版本：

php -r "echo PGSQL_LIBPQ_VERSION;"

如果输出的版本和你本地Postgres的10.3不一致，说明PHP确实在使用系统自带的libpq。这是Homebrew安装PHP时的常见坑：默认可能优先链接系统库而非Homebrew的版本。

解决办法：重新安装PHP并指定libpq路径 #

用Homebrew重新安装PHP，强制它使用Homebrew的libpq：

# 以PHP 7.2为例，其他版本替换成对应包名，比如php@5.6、php@7.1
brew reinstall php@7.2 --with-libpq=/usr/local/opt/libpq/

安装完成后，重启你的PHP-FPM或Web服务器（比如Apache/Nginx），再重新检查libpq版本是否匹配。

2. 调整PHP连接字符串的SSL参数 #

即使libpq版本正确，Heroku Postgres有时需要更明确的SSL配置。尝试在连接时指定系统根证书路径（OS X的根证书通常在/usr/local/etc/openssl/cert.pem）：

PDO连接示例 #

$dsn = 'pgsql:host=YOUR_HEROKU_DB_HOST;port=5432;dbname=YOUR_DB_NAME;user=YOUR_DB_USER;password=YOUR_DB_PASS;sslmode=require;sslrootcert=/usr/local/etc/openssl/cert.pem';
try {
    $pdo = new PDO($dsn);
    echo "连接成功！";
} catch (PDOException $e) {
    die("连接失败: " . $e->getMessage());
}

原生pgsql扩展连接示例 #

$conn = pg_connect("host=YOUR_HEROKU_DB_HOST port=5432 dbname=YOUR_DB_NAME user=YOUR_DB_USER password=YOUR_DB_PASS sslmode=require sslrootcert=/usr/local/etc/openssl/cert.pem");
if (!$conn) {
    die("连接失败: " . pg_last_error());
}
echo "连接成功！";

3. 验证PHP扩展的依赖库 #

用otool检查pgsql扩展的依赖，确认它加载的是Homebrew的SSL库：

otool -L $(php -r "echo extension_dir;")/pgsql.so

查看输出里的libssl.dylib和libcrypto.dylib路径，应该指向/usr/local/opt/openssl/下的文件，而非/usr/lib/（系统默认路径）。如果是系统路径，说明重新安装PHP时的参数没生效，可以尝试先彻底卸载再重装：

brew uninstall --force php@7.2
brew cleanup
brew install php@7.2 --with-libpq=/usr/local/opt/libpq/

4. 临时排查测试（生产环境禁用） #

如果以上方法都不行，可以尝试将sslmode改为verify-ca（需确保CA证书正确），或者极端情况下用sslmode=allow（但Heroku可能会拒绝非强制SSL的连接），来验证是否是SSL参数的问题。不过生产环境一定要用sslmode=require或更严格的verify-full。

至于为什么Postico和Node.js能正常连接？因为它们直接调用了Homebrew安装的libpq 10.3（带完整SSL支持），而PHP的pgsql扩展默认链接了系统旧版libpq，导致SSL支持失效。

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