webman连接oracle需手动配置oci8扩展、instant client及字符集，禁用pdo-oci和oci_pconnect，改用oci_connect+连接池并显式释放。
Webman 用 oci_connect 连 Oracle 会直接报错
Webman 默认不带 Oracle 支持，oci_connect 函数根本不存在——不是写法错，是扩展没装、环境缺依赖。强行调用会触发 Fatal error: Uncaught Error: Call to undefined function oci_connect()。
必须先确认三点：PHP 已启用 oci8 扩展、Oracle Instant Client 已安装且路径被系统识别、tnsnames.ora 配置正确指向目标库（比如 SERVICE_NAME=orcl 或 SID=ORCL）。
常见卡点：
-
oci8.so加载失败，通常因 Instant Client 版本与 PHP 架构不匹配（如 PHP 是 x86_64，却装了 32 位 client） - Linux 下未设置
LD_LIBRARY_PATH指向 Instant Client 的lib目录 - Windows 下把
oci.dll所在目录加进系统PATH，但没重启 Webman 进程（php start.php stop && php start.php start才生效）
不能直接套用 Laravel/ThinkPHP 的 PDO 配置
Webman 原生不支持 PDO_OCI 驱动的自动注册，即使你写了 'driver' => 'oci8' 或 'driver' => 'oracle'，illuminate/database 也大概率无法初始化连接——它依赖 PDO 的底层支持，而 Webman 的 Db 组件（support\Db）默认只适配 MySQL/PostgreSQL/SQLite。
真实可行路径只有两条：
- 手动封装：用
oci_connect建立连接句柄，再传给自定义查询类，绕过 Db 组件的驱动抽象 - 改用原生 OCI8 函数链：
oci_parse→oci_bind_by_name→oci_execute→oci_fetch_assoc，不走 ORM 层
试图通过 composer require laravel/framework 引入完整 Laravel 来“补全” Oracle 支持，只会引发 autoloader 冲突和容器绑定混乱，不推荐。
oci_pconnect 在 Webman 长连接场景下极易泄漏
Webman 是常驻内存的 Swoole 应用，oci_pconnect 创建的“持久连接”不会随请求结束释放，而是长期挂在进程里。多个 worker 进程各自维护一份连接池，若未显式控制最大连接数或空闲超时，Oracle 数据库侧很快会报 ORA-00020: maximum number of processes (xxx) exceeded。
必须做硬性约束：
- 在
oci_pconnect第五个参数传OCI_CPOOL，并用oci_new_pool显式创建带min/max/incr的连接池 - 每个 worker 初始化时只建一个池，全局复用，禁止每次请求都新建池
- 务必在进程退出前调用
oci_close_pool，否则 Swoole reload 时旧池残留
别信“Swoole 自动回收资源”的说法——OCI8 的连接池是 Oracle 客户端层管理的，PHP 层无权强制销毁，漏掉 oci_close_pool 就等于永久占用数据库连接。
字符集与 NLS_LANG 不一致导致中文乱码
Oracle 对中文支持高度依赖客户端字符集声明。即使 PHP 文件本身是 UTF-8，若环境变量 NLS_LANG 设为 AMERICAN_AMERICA.ZHS16GBK，而数据库实际是 AL32UTF8，oci_connect 返回的字段值就会是乱码，且无法用 mb_convert_encoding 修复。
解决方案分两层：
- 服务端统一：确保数据库字符集是
AL32UTF8（查SELECT * FROM NLS_DATABASE_PARAMETERS WHERE PARAMETER = 'NLS_CHARACTERSET';） - 客户端强制：在
oci_connect第四个参数明确传'AL32UTF8'，例如：oci_connect($user, $pass, $conn_str, 'AL32UTF8') - 环境变量兜底：Linux 下启动 Webman 前执行
export NLS_LANG=AMERICAN_AMERICA.AL32UTF8；Windows 下在start.php开头加putenv('NLS_LANG=AMERICAN_AMERICA.AL32UTF8');
最容易忽略的是：Swoole worker 进程继承的是主进程启动时的环境变量，如果用 systemd 或 supervisor 管理 Webman，必须在 service 文件里显式配置 Environment=NLS_LANG=...，否则改了 shell 的环境变量也没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
