本文详解PHP调用bash脚本执行psql命令时出现“FATAL: database does not exist”错误的根本原因——该错误实为认证失败的误导性提示，本质是pg_hba.conf未授权postgres用户通过TCP连接访问默认数据库postgres，导致psql无法初始化会话，进而无法执行CREATE DATABASE等跨库操作。
本文详解php调用bash脚本执行psql命令时出现“fatal: database does not exist”错误的根本原因——该错误实为认证失败的误导性提示，本质是pg_hba.conf未授权`postgres`用户通过tcp连接访问默认数据库`postgres`，导致psql无法初始化会话，进而无法执行create database等跨库操作。
该问题极具迷惑性：错误信息声称目标数据库不存在，但实际故障点并非数据库缺失，而是连接阶段的身份认证失败。当psql尝试连接时，它必须先连接到一个“启动数据库”（bootstrap database）——通常是postgres或template1——才能执行CREATE DATABASE这类需要系统级权限的操作。而你的bash脚本中未显式指定-d postgres，psql会默认尝试连接环境变量PGDATABASE所指的数据库（即newDBFromBashPHP），但该库尚未存在，于是报出看似直白、实则掩盖真相的错误。
? 根本原因：默认数据库缺失 + 认证规则不匹配
PostgreSQL要求所有连接必须指向一个已存在的数据库。CREATE DATABASE本身是一个SQL命令，而非连接参数；它必须在成功连接到某个合法数据库后才能执行。你的脚本中：
PGDATABASE=newDBFromBashPHP # ❌ 错误：此库尚不存在，psql无法以此为目标连接 psql -h 127.0.0.1 -U postgres -c "CREATE DATABASE ..."
这等价于：
psql -h 127.0.0.1 -U postgres -d newDBFromBashPHP -c "CREATE DATABASE ..."
→ 因目标库不存在，连接直接失败，后续命令根本不会执行。
立即学习“PHP免费学习笔记（深入）”；
更关键的是：即使你修复了-d参数，若pg_hba.conf中没有允许postgres用户从127.0.0.1以密码方式连接postgres库的规则，仍会触发password authentication failed或静默拒绝。
✅ 正确解决方案：显式指定启动库 + 完善认证配置
1. 修改bash脚本：强制连接postgres库
#!/usr/local/bin/bash
export PGUSER=postgres
export PGPASSWORD='your_actual_password' # ⚠️ 生产环境请改用.pgpass文件或环境变量安全传递
export PGHOST=127.0.0.1
export PGPORT=5432
echo "=== Checking connection to 'postgres' DB ==="
psql -h "$PGHOST" -p "$PGPORT" -U "$PGUSER" -d postgres -c "\l" 2>/dev/null || {
echo "ERROR: Failed to connect to 'postgres' database. Check pg_hba.conf and password."
exit 1
}
echo "=== Dropping database ==="
psql -h "$PGHOST" -p "$PGPORT" -U "$PGUSER" -d postgres -c "DROP DATABASE IF EXISTS \"newDBFromBashPHP\";"
echo "=== Creating database ==="
psql -h "$PGHOST" -p "$PGPORT" -U "$PGUSER" -d postgres -c "CREATE DATABASE \"newDBFromBashPHP\";"✅ 关键点：所有psql命令均显式添加 -d postgres，确保连接始终指向一个已存在的、具备CREATEDB权限的系统数据库。
2. 验证并更新 pg_hba.conf
确保/var/lib/pgsql/*/data/pg_hba.conf（或MAMP对应路径）包含以下规则（位置靠前，避免被后续reject覆盖）：
# TYPE DATABASE USER ADDRESS METHOD host postgres postgres 127.0.0.1/32 md5 host all postgres 127.0.0.1/32 md5 # 可选：允许对任意库操作
然后重载配置：
sudo systemctl reload postgresql # 或使用 pg_ctl reload
3. PHP端安全优化建议
当前PHP代码存在严重安全隐患：
- escapeshellarg($contents) 仅转义字符串，但$contents是脚本内容，非用户输入，此处无意义；
- exec(... & echo $!) 后台执行导致输出不可控，且$!返回的是bash进程PID，非psql结果；
- 硬编码密码暴露风险极高。
✅ 推荐重构为：
<?php
// 使用PDO执行SQL（更安全、可读性高）
try {
$pdo = new PDO(
"pgsql:host=127.0.0.1;port=5432;dbname=postgres",
"postgres",
$_ENV['PG_PASSWORD'] ?? 'your_password',
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);
$pdo->exec("DROP DATABASE IF EXISTS \"newDBFromBashPHP\"");
$pdo->exec("CREATE DATABASE \"newDBFromBashPHP\"");
echo "✅ Database created successfully.";
} catch (PDOException $e) {
error_log("DB creation failed: " . $e->getMessage());
echo "❌ Error: " . htmlspecialchars($e->getMessage());
}
?>? 注意事项总结
- 永远不要依赖PGDATABASE创建新库：它仅用于连接，不能替代-d参数。
- .pgpass文件优于环境变量：在~/.pgpass中写入127.0.0.1:5432:postgres:postgres:your_pass，并设chmod 600 ~/.pgpass，可避免密码明文暴露。
- MAMP用户特别注意：其PostgreSQL可能独立安装（如Postgres.app），需确认psql路径及数据目录，pg_hba.conf通常位于/Applications/Postgres.app/Contents/Versions/*/data/。
- 错误日志是黄金线索：启用PostgreSQL日志（log_statement = 'all' + logging_collector = on），查看/usr/local/var/log/postgresql.log，可精准定位是no pg_hba.conf entry还是password authentication failed。
遵循以上步骤，即可彻底解决“数据库不存在”这一伪错误，实现PHP与bash对PostgreSQL的安全、可靠协同操作。
