PHP 在类 Unix 环境下使用 PDO 连接 SQL Server 的问题

概况

前几天帮一个兄弟重写了一整套系统，从 ASP 成功迁移到了 PHP。

不过呢，在填这种奇怪搭配坑的路上总能够碰到一些神坑，掉进去之后半天也爬不出来。

遇到的坑

刚开始是直接装的 FreeTDS 然后再安装 PHP 的 pdo-dblib 扩展实现的连接，配置完 FreeTDS 再连接 SQL Server 的时候，一开始看起来还是挺正常的，能够直接连上，然后也能正常写。

开发到一半发现了不对劲的情况，在 参数带中文 的情况下, pdo 绑定参数之后带入查询，竟然查不到任何的结果（实际是存在匹配的记录，且在不使用绑定，然后直接用原始 SQL 语句写的情况下，能够查出来），就连写入也是有问题的。

更蹊跷的是，假如查询的时候 pdo 绑定参数值只带英文，能查到结果，且结果又不会有乱码，这我整个人就不好了。

查了半天的资料，然后结合自己的情况进行分析，排查，最后发现是 pdo-dblib 和 SQL Server 的 nvarchar 字段结合查询时，多字节字符无法正常工作，Stackoverflow上也有踩坑的同行。

解决办法更是瞠目结舌，要先把字符转码成 UTF-16LE 然后再带入查询，这样就神奇的查出来了。

这个解决办法是我不能接受的，我总不能在每个 Model 对这些异类字段做标记，然后修改底层其他 composer 包里封装的处理方法吧，这样下来万一哪天又掉新坑里也不足为奇了。

最后没办法，只能转到用 pdo-odbc 去连接了。

正确的连接姿势

首先就是在类 Unix 环境（比如我用 OSX）下面怎么远程连接到 SQL Server 上呢？

要连接，首先你得有一个连接媒介，在类 Unix 环境下面有一个工具叫做 FreeTDS，提供一个桥梁让系统和远端 SQL Server 之间进行通信。

OSX 借助 Brew 需要以下一条命令进行安装

brew install freetds --with-unixodbc

最后一个 with 参数必须要带，要不然就不会产生 tds 的 so 文件，后面 unixodbc 设置 driver 的时候就无法下手了，安装完之后，先配置 ODBC：

编辑 ~/.odbc.ini (大家请根据自己的实际情况编辑对应的文件)，并在最后加上如下内容

[服务源名称,比如test]
Driver=/usr/local/lib/libtdsodbc.so
Description= #随便写
Trace=No
Servername=dataSourceName #和后面freetds.conf中的名称对应
Database= #数据库名

然后编辑 /usr/local/etc/freetds.conf 并在最后加上如下内容

[dataSourceName]#和前面odbc.ini文件里的Servername保持一致
        host = #主机名
        port = #SQL Server 开放的端口号
        tds version = #这个根据你的 SQL Server 的版本号去填，比如我是 SQL Server 2005，就填7.2，其他情况自己 Google 吧。
        client charset = UTF-8 #设置对应的字符集，要不然查出来就要乱码啦。

保存之后，在确保 PHP 的 pdo-odbc 扩展是开启的状态下，直接用 pdo 的 odbc 方式去连 SQL Server 就好了。

PDO-ODBC 有坑么？

回答当然是，有！

无法多条同时批量插入（不知道是不是我姿势问题，反正我这边一次批量插入就出错，单条能够成功插入）

有时候查出来的部分结果的字段值是 null，而且不同的开发机器上相同的环境下，空的字段还不太一样，这就十分尴尬了。

究极解决方案

换 Windows 开发，然后用 pdo-sqlsrv 去连接（毕竟微软的数据库，得配套微软自己写的扩展去连才不会出事。。。）

不过你换 pdo-sqlsrv 的话，又得装其他库，也是蛮繁琐的。

如果服务器是 Windows Server 2003 的话，pdo-sqlsrv 最高还只能使用官方 2.0 的版本，2.0版本最高只支持 PHP 5.3。

民间有一个支持 Server 2003 的 3.0 版本。

假如你 SQL Server 是 2005 的话，pdo-sqlsrv也只支持到 3.0（最高支持到 PHP 5.4）。3.1 版本开始只有 SQL Server 2008+ 能享用了，所以 PHP 5.5+ 你就无望啦，于是 Laravel 你最高就只能用到 5.0 啦。

Laravel 5.0 的话自带的 DB 类支持的 sqlsrv 连接方式是没有 odbc 的，对于 odbc 连接 SQL Server 的支持也是在最近的 5.2.31 才加上的。

于是，想问各位客官，有没有一种想死的感觉？

要不是客户还有其他端的东西还得跑，我想整套给他转成 PHP + MySQL 了。

我的故事讲完啦。

总结

还是希望后面的兄弟可以少踩点坑，要不然我浪费的一下午时间就没有太大意义了。

以后少接这种奇怪搭配的活，要不然光搞定这些环境问题就要浪费你一大把时间。

最后，我还活着，打算开始写点 PHP 和 Laravel 入门教程了，希望可以让后人少走弯路 ：）