<p>Firebird/InterBase 扩展自 PHP 7.4.0 起已从核心移除，phpEnv 默认不集成且无编译支持；Windows 下需手动安装匹配的 Firebird 客户端与 php_interbase.dll 并配置 PATH，Linux/macOS 更推荐编译 pdofirebird；ibase* 函数因维护停滞、协议兼容性差及 ORM 不支持，应被 PDO Firebird 替代。</p>
phpEnv 无法直接启用 Firebird/InterBase 扩展 —— 因为该扩展自 PHP 7.4.0 起已从核心剥离，且 phpEnv 默认不集成、也不提供编译支持。
phpEnv 环境下 ibase_connect() 报错“未定义函数”
这是最常见现象：代码里调用 ibase_connect() 或 fbird_connect()，PHP 直接报 Fatal error: Uncaught Error: Call to undefined function ibase_connect()。根本原因不是配置错了，而是扩展压根没加载成功。
- phpEnv 的二进制包（尤其是 Windows 版）默认不含
php_interbase.dll或php_interbase.so，也未预编译 Firebird 客户端依赖（fbclient.dll或libfbclient.so） - 即使你手动复制
php_interbase.dll到ext/目录，若系统 PATH 中没有fbclient.dll，或版本不匹配（如 Firebird 4 客户端配 PHP 8.1），extension=php_interbase.dll仍会静默失败（php -m看不到，phpinfo()无 ibase 模块） - phpEnv 的
php.ini模板通常不包含ibase.*配置项，但即使补上（如ibase.default_user="SYSDBA"），也无法解决“扩展未加载”这个前置问题
Windows 下硬启用 php_interbase.dll 的实操路径
仅适用于 Firebird 2.5 / 3.0 + PHP 7.3 或 7.4（PHP 8.x 基本不可行）。关键不在 phpEnv 界面操作，而在底层文件与环境变量。
- 确认 Firebird 客户端已安装：从 firebirdsql.org 下载对应位数的 Firebird Client（如
Firebird-3.0.10.33660-0_x64.exe），**仅勾选 “Client-only installation”**，安装路径记为C:\Firebird\Client\ - 将
C:\Firebird\Client\加入系统 PATH（重启命令行生效），并验证：php -r "echo FFI::cdef('')->sizeof();"不报错说明 DLL 可见 - 从旧版 PHP（如 PHP 7.4.33 nts x64）提取
php_interbase.dll，放入 phpEnv 对应 PHP 版本的ext/目录（如phpenv\versions\7.4.33\ext\） - 在 phpEnv 管理界面中编辑该 PHP 版本的
php.ini，取消注释并修正路径：extension=php_interbase.dll（不要写绝对路径） - 重启 phpEnv 服务，运行
php -m | findstr interbase，有输出才表示加载成功
Linux/macOS 下用 phpEnv 编译 pdo_firebird 更现实
phpEnv 的 phpenv install 命令本身不支持传参给 ./configure，但你可以绕过它，手动触发编译流程。这比 Windows 下折腾 DLL 更可控，但要求系统已装 Firebird 开发包。
立即学习“PHP免费学习笔记（深入）”；
- Ubuntu/Debian：先执行
sudo apt-get install firebird-dev libfbclient2；CentOS/RHEL：sudo yum install firebird-devel - 进入 phpEnv 的源码缓存目录（如
~/.phpenv/cache/php-8.1.27/），运行：./configure --with-pdo-firebird=/usr（路径以pkg-config --variable=libdir firebird输出为准） - 接着执行
make && make install，完成后phpenv rehash - 检查结果：
php -r "print_r(PDO::getAvailableDrivers());"应含firebird；php -i | grep -i firebird应显示配置项 - 注意：PDO 方式连接用
new PDO('firebird:dbname=localhost:/path/to/db.fdb', 'SYSDBA', 'masterkey')，而非ibase_connect()
为什么 ibase_* 函数在新项目里应该避免直接使用
不是因为写法难，而是维护性断层已成事实。
- PHP 官方自 7.4 起移除该扩展，PECL 仓库
pecl-database-interbase最后一次提交是 2021 年，无人响应 CVE 和新版 Firebird（如 4.0+）的 wire protocol 变更 - Firebird 4 默认启用加密认证（Srp256），而
ibase_connect()无法指定 auth plugin，连接会卡在 handshake 阶段，错误信息仅为Unable to complete network request to host，排查极耗时 - 所有现代 PHP ORM（Doctrine、Laravel Octane 兼容层）只支持 PDO 驱动，
ibase_*是纯过程式 API，无法融入依赖注入或连接池体系 - 真正省事的做法：用
pdo_firebird+firebird-client4.x，哪怕多装一个包，也比后期调试字符集乱码、事务隔离异常、BLOB 流中断强得多
最易被忽略的一点：Firebird 数据库路径必须是服务端可读的绝对路径（Windows 下不能用 C:\data\test.fdb，得用 //localhost/C:/data/test.fdb 或 UNC 格式），而 phpEnv 本地开发常误用相对路径，导致 ibase_connect() 返回空资源却不报错 —— 这种静默失败比明确报错更难定位。
