本文介绍利用 postgresql 的 libpq 连接字符串原生支持多主机故障转移的机制，使 php 应用无需轮询或手动状态管理即可实现主库不可用时自动降级至从库，并在主库恢复后自动回切（依赖客户端重连策略）。
本文介绍利用 postgresql 的 libpq 连接字符串原生支持多主机故障转移的机制，使 php 应用无需轮询或手动状态管理即可实现主库不可用时自动降级至从库，并在主库恢复后自动回切（依赖客户端重连策略）。
PostgreSQL 自 10 版本起（实际自 9.6 起已初步支持，9.2+ 亦可通过 host 多值实现基础故障转移），其底层连接库 libpq 原生支持多主机连接字符串，可按顺序尝试多个服务器地址，一旦首个主机连接失败（如超时、拒绝连接、认证失败等），将自动尝试后续主机——这正是解决您“夜间主库关机、应用需无缝切换至从库”问题的最轻量、最可靠方案。
✅ 正确配置方式（PHP 中直接使用）
在 PHP 的 PDO 或 pg_connect() 中，直接传入符合 libpq 规范的连接字符串即可：
// 使用 PDO（推荐）
$dsn = 'pgsql:host=master.example.com,slave.example.com;port=5432,5432;dbname=myapp_institution;user=appuser;password=secret';
$pdo = new PDO($dsn, '', '', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_TIMEOUT => 5, // 可选：设置单次连接超时（秒）
]);
// 或使用 pg_connect（传统方式）
$conn_str = "host=master.example.com,slave.example.com port=5432,5432 dbname=myapp_institution user=appuser password=secret";
$connection = pg_connect($conn_str);
? 关键语法说明：
- host=a,b,c 表示按顺序尝试 a → b → c；
- port=x,y,z 必须与 host 数量一致（一一对应），若端口相同，可简写为 port=5432,5432；
- 其他参数（如 dbname, user）为全局共享，无需重复。
⚠️ 重要注意事项
- 不支持“自动回切”：libpq 仅在建立新连接时执行主机选择。已建立的连接不会主动切换；若主库在运行中恢复，后续新请求（如新页面加载、API 调用）将自动优先连接主库——这恰好符合您“夜间切从、白天回主”的业务场景，且无需轮询或状态持久化。
-
连接超时由 libpq 控制：建议显式设置 connect_timeout（单位：秒），避免默认 30 秒等待过长。可在连接字符串中添加：
host=master,slave connect_timeout=3
- 只适用于读写分离场景中的“读操作”？不完全是：该机制适用于所有连接请求。但请注意——若应用向从库执行写操作（如 INSERT/UPDATE），将因从库只读而报错。因此，强烈建议仅对纯查询类数据源（如您所述的“institution-wise data”）启用此配置，并确保业务逻辑不向该连接发起写操作；核心业务库（如“application details”）仍应使用独立、稳定的单点连接。
- PHP 驱动兼容性：确认您的 pgsql 扩展基于较新 libpq（PHP 7.4+ / PostgreSQL 10+ 环境通常满足）。可通过 pg_version() 或 phpinfo() 查看 libpq version。
? 进阶建议（可选）
- 若需更精细控制（如读写分离 + 故障转移），可结合 pgbouncer（连接池）或 Patroni（高可用编排），但对当前需求属于过度设计。
- 在应用层添加简易健康日志（如记录每次连接所选主机），便于监控切换行为：
$host_used = pg_parameter_status($connection, 'host'); error_log("[DB] Connected to {$host_used}");
综上，摒弃轮询与状态标记的复杂逻辑，直接采用 libpq 原生多主机连接字符串，是实现 PostgreSQL 主从自动故障转移最简洁、稳定、符合标准的方案——零额外依赖，零运行时开销，一次配置，长期生效。
