PHP连接Firebird必须使用PDO_FIREBIRD扩展，依赖fbclient库而非TCP/IP，默认需绝对路径DSN，且对PHP与Firebird客户端ABI版本严格匹配；须启用扩展、规避CVE-2025-14179漏洞，禁用模拟预处理并避免动态构造数据库路径。
PHP 连接 Firebird 数据库必须用 PDO_Firebird 扩展，不是 mysqli 或 pgsql 那套逻辑。它不走 TCP/IP 默认端口，而是依赖本地客户端库（fbclient.dll 或 libfbclient.so），且对 PHP 版本和 Firebird 客户端 ABI 兼容性极其敏感。
确认 PDO_Firebird 扩展已启用
运行 php -m | grep firebird 或 phpinfo() 查看是否加载了 pdo_firebird 模块。常见失败点：
- 扩展未编译进 PHP（Linux 源码编译需加
--with-pdo-firebird=/path/to/firebird） - Windows 下未在
php.ini中取消注释extension=php_pdo_firebird.dll - 扩展依赖的
fbclient.dll不在系统 PATH 或 PHP 的extension_dir目录下
连接字符串格式与路径写法
Firebird 的 DSN 不含主机名或端口字段（除非用别名或服务名），典型格式是：
firebird:dbname=/var/lib/firebird/4.0/data/mydb.fdb
注意：
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS 必须用绝对路径；相对路径会解析为当前工作目录，极易报
Unable to complete network request to host "localhost" - Windows 可用盘符路径（如
C:\data\mydb.fdb），但建议统一用正斜杠避免转义问题 - 若使用服务器别名（如
firebird:dbname=myserver:/data/db.fdb），需确保aliases.conf已配置且 Firebird 服务重启过
绕过 CVE-2025-14179 的安全写法
PHP 8.2.31 之前版本存在 PDO Firebird SQL 注入（CVE-2025-14179），触发条件是用户输入含 NUL 字节（\0）时未被过滤。修复后仍建议：
- 永远用
prepare()+bindValue()，禁用exec()直接拼接 SQL - 连接时显式关闭模拟预处理：
$pdo = new PDO($dsn, $user, $pass, [PDO::ATTR_EMULATE_PREPARES => false]); - 避免从用户输入构造数据库路径 —— 路径应来自白名单或配置项，而非 GET/POST 参数
Windows 下 fbclient.dll 版本错配问题
PHP 的 PDO_Firebird 扩展绑定的是特定 ABI 版本的客户端库。常见报错 Entry-point fb_interpret not found 表明：
- 你正在用 PHP 8.x（依赖 Firebird 2.5+ ABI）去连 Firebird 1.0.3 服务 —— 这不行，得换旧版 PHP（如 5.6）或升级服务端
- 混用了不同 Firebird 版本的
fbclient.dll（比如把 Firebird 4.0 的 dll 放进 PHP 7.4 环境） - 64 位 PHP 加载了 32 位
fbclient.dll（或反之）
最稳妥的做法：从与你的 Firebird 服务端同版本的官方安装包中提取 fbclient.dll，并确保位数一致。
