PHP7连接外部SQL Server失败排查及无需修改php.ini的实现方案

现有3种连接代码的问题定位 #

• ODBC连接方案格式错误：连接串中端口的书写不符合SQL Server ODBC驱动规范，驱动要求服务器地址需用逗号拼接端口，直接写IP;1433会导致参数解析失败，无法正常建立连接
• PDO sqlsrv、原生sqlsrv_connect方案与需求不匹配：这两种实现都依赖PHP官方提供的pdo_sqlsrv、sqlsrv扩展，PHP7的Apache环境默认不会预装上述扩展，必须修改php.ini加载扩展、重启Web服务才能生效，和「不修改所有服务器php.ini、不引入外部库」的要求存在本质冲突；同时第三份代码里"Database" => IDD参数缺失字符串引号，存在直接触发语法错误的问题

符合部署要求的可落地实现 #

PHP7环境下，唯一能满足零全局配置、零外部库引入要求的连接方式，是基于SQL Server公开的Tabular Data Stream (TDS) 协议，用PHP核心内置函数实现的socket直连：

• 核心逻辑：全程不依赖任何系统驱动、PHP扩展，仅调用PHP核心自带的fsockopen、哈希计算、字符串编码类函数，按照TDS 7.2及以上版本的协议规则，完成TCP建连、账号鉴权、SQL请求封装、结果集解析的全流程
• 实现步骤：
  • 先通过fsockopen直接和目标SQL Server的IP:1433端口建立TCP连接，前期需提前测试端口连通性，排除安全组、防火墙拦截规则导致的连接失败
  • 按照TDS协议规范组装登录请求报文，密码哈希、Unicode格式的账号/密码/数据库名字段，全部用PHP内置的hash、mb_convert_encoding函数完成编码，不需要调用外部工具
  • 逐字节解析服务端返回的登录响应报文，确认鉴权通过、目标数据库上下文切换成功后，即可按照协议格式封装SQL查询请求，完成数据读写操作

实用调试技巧 #

• 排查连接故障时优先在待部署的服务器上做端口连通性测试，确认1433端口可达，避免在代码层面做无意义调试
• 该TDS原生socket实现的代码可跨所有PHP7及以上版本直接部署，因为用到的函数均为PHP核心内置组件，不需要在每台服务器上调整全局配置
• 若后续可统一调整服务器全局配置，可优先修正现有代码的格式问题：ODBC连接串需将端口与IP的分隔符从分号改为逗号，sqlsrv系列连接需补全Database参数的字符串引号

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