PHP_FPM与CLI环境下PDO_DBLIB返回UTF-8结果不一致问题
问题原因分析
根因:PDO_DBLIB 字符集判断依赖进程环境配置,不同SAPI的进程locale不一致导致转码异常
你使用的PDO_DBLIB底层依赖FreeTDS库处理SQL Server连接,未显式指定字符集时,FreeTDS会优先读取当前进程的系统locale配置判断编码规则,而CLI和FPM的进程启动环境默认有差异:
- CLI模式下执行时,进程继承当前登录用户的locale配置,通常为
zh_CN.UTF-8/en_US.UTF-8这类UTF-8编码,所以可以正常识别并返回完整的UTF-8不间断空格\xC2\xA0 - FPM进程由系统服务(systemd/init.d)启动,默认继承的locale为单字节编码的
C/POSIX,FreeTDS会将UTF-8多字节字符按单字节规则处理,直接丢弃了\xC2前导字节,仅保留\xA0,导致UTF-8编码断裂出现乱码。
注:locale属于进程级系统环境变量,不受PHP.INI配置控制,所以即便两个SAPI加载同一份ini,也会出现配置差异,可分别在CLI和FPM代码中执行var_dump(setlocale(LC_ALL, 0));验证两者的locale输出不同。
解决方案
方案1(优先推荐):在PDO连接DSN中显式指定字符集
直接在连接参数中加入charset=UTF-8,避免依赖环境变量判断编码:
<?php require('include/config.php'); // DSN新增charset=UTF-8参数 $handle = new PDO ("dblib:host={$cfg['cwdb']['address']};dbname={$cfg['cwdb']['database']};charset=UTF-8", $cfg['cwdb']['username'], $cfg['cwdb']['password']); $result=$handle->query("select SR_Detail_Notes from sr_detail where sr_service_recid=1402978 and sr_detail_notes like '%Computer:%'"); $row = $result->fetch(PDO::FETCH_ASSOC); echo "<pre>Running as " . PHP_SAPI . "\n\n"; echo "Line: {$row['SR_Detail_Notes']}\n"; echo "Hex: " . bin2hex($row['SR_Detail_Notes']) . "\n";
方案2:修改FPM进程启动的locale配置
如果你的FreeTDS版本过低不支持DSN指定charset,可修改FPM服务的启动配置,为进程设置UTF-8编码的locale:
- 若使用systemd管理FPM服务,在
php-fpm.service的[Service]段加入以下配置,重启FPM即可生效:
Environment=LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
内容的提问来源于stack exchange,提问作者localhost
相关产品推荐
相关产品推荐

