切换SQL驱动后PHP遗留应用出现ISO-8859-1编码异常问题

问题场景 #

遗留PHP应用将SQL Server从2012版本迁移至2017版本，同时把数据库驱动从SQL Server替换为ODBC Driver 17 for SQL Server后，出现问号乱码等编码异常。即使视图底层字段本身是varchar(x)类型，直接查询视图（如SELECT * FROM ExampleView）仍会乱码，但将字段显式转换为varchar(8000)后，文本能正常显示：

正常显示的查询语句示例：

SELECT 
      convert(varchar(8000), ExampleOne) as ExampleOne
     ,convert(varchar(8000),ExampleTwo) as ExampleTwo
     ,convert(varchar(8000),ExampleThree) as ExampleThree
FROM ExampleView

可能原因 #

1. ODBC Driver 17对字符类型的处理逻辑与旧驱动不同，对于长度小于8000的varchar字段，驱动可能默认按Unicode类型解析，导致编码不匹配。
2. SQL Server 2017的默认排序规则或字符集与2012存在差异，视图字段继承了新规则，引发应用端编码转换错误。
3. PHP数据库连接未明确指定字符集参数，驱动与应用之间的编码协商失败。

解决方案 #

1. 调整ODBC连接字符串，指定字符集 #

在PHP的ODBC连接串中添加CharacterSet=UTF-8参数，强制驱动使用UTF-8编码交互：

$dsn = "DRIVER={ODBC Driver 17 for SQL Server};SERVER=你的服务器地址;DATABASE=你的数据库名;UID=用户名;PWD=密码;CharacterSet=UTF-8";
$conn = odbc_connect($dsn, '', '');

部分环境下可能需要用ClientCharset=UTF-8替代，可根据实际情况测试。

2. 修改视图定义，统一字段长度 #

如果调整连接串无效，可以修改视图，将底层varchar(x)字段统一转换为varchar(8000)，避免驱动的特殊处理：

ALTER VIEW ExampleView
AS
SELECT 
    CAST(ExampleOne AS varchar(8000)) AS ExampleOne,
    CAST(ExampleTwo AS varchar(8000)) AS ExampleTwo,
    CAST(ExampleThree AS varchar(8000)) AS ExampleThree
FROM 原表;

3. 检查PHP编码配置 #

确保PHP应用的默认编码为UTF-8，可在代码开头添加：

mb_internal_encoding('UTF-8');
header('Content-Type: text/html; charset=UTF-8');

同时检查php.ini中的mbstring.default_charset、default_charset等参数是否设置为UTF-8。

4. 切换为sqlsrv扩展 #

如果ODBC驱动的兼容性问题无法解决，可尝试使用微软官方的sqlsrv扩展替代ODBC，该扩展对SQL Server的字符集支持更原生，能减少编码适配问题。

内容的提问来源于stack exchange，提问作者Kyle Eales