ZF2 TableGateway查询返回空结果集，Adapter查询却正常的问题

我之前在迁移ZF2应用到PHP7+SQL Server环境时，也碰到过一模一样的问题，结合你给出的排查信息，咱们来把这个问题彻底解决掉：

你把应用从Windows 2008 R2 + IIS 6.1 + PHP 5.4.11 + SQL Server 10 + ZF 2.4迁移到Windows 10 + PHP内置服务器 + PHP 7.2.5 + SQL Server 14 + ZF 2.4后，出现了以下矛盾现象：

• 使用TableGateway::selectWith()执行查询时，返回空结果集
• 但用Adapter->query()执行完全相同的$select语句，却能正常获取结果
• 直接拼接字符串的WHERE条件可以正常运行，且原服务器无此问题

你的推测完全准确——问题出在两个层面的兼容冲突：

1. ZF2.4的TableGateway占位符绑定逻辑：它在构建预编译语句时，传递的参数可能是临时值而非变量引用
2. PHP 5.x到7.x的sqlsrv扩展变化：PHP7+的sqlsrv_prepare()严格要求参数是实际的变量引用，而PHP5.x版本对传引用的处理比较宽松；这就导致sqlsrv_execute()无法正确绑定参数，最终返回空结果

• 而Adapter->query()是直接把拼接好的完整SQL发送给sqlsrv_query()，绕开了预编译的参数引用问题，所以能正常执行

方案1：修改ZF2底层代码（临时修复） #

找到ZF2库中的Zend\Db\Adapter\Driver\Sqlsrv\Statement.php文件，修改prepare()方法里的参数绑定逻辑：
原代码（类似）：

foreach ($this->parameterContainer as $name => $value) {
    $params[] = &$value;
}

替换为：

$paramValues = $this->parameterContainer->getNamedArray();
foreach ($paramValues as $name => &$value) {
    $params[] = &$value;
}
unset($value); // 释放引用，避免后续变量污染

这段修改确保传递给sqlsrv_prepare()的是实际的变量引用，而非临时值，解决绑定失效问题。

方案2：升级ZF2到兼容版本 #

ZF2.4属于较旧的版本，官方后续发布的ZF2稳定版（比如2.4.11及以后）已经修复了PHP7和SQL Server的兼容问题。如果业务允许，建议直接升级到ZF2的最新稳定版，从底层彻底解决该问题。

方案3：业务代码临时替换（应急方案） #

如果暂时无法修改框架源码或升级，可以在业务代码中绕开TableGateway的预编译绑定：
比如原来的代码：

$select = new Select('your_table');
$select->where(['id' => $id]);
$resultSet = $this->tableGateway->selectWith($select);

替换为：

$select = new Select('your_table');
$select->where(['id' => $id]);
// 生成完整SQL语句
$sql = $select->getSqlString($this->tableGateway->getAdapter()->getPlatform());
// 用Adapter直接执行
$resultSet = $this->tableGateway->getAdapter()->query($sql, \Zend\Db\Adapter\Adapter::QUERY_MODE_EXECUTE);

这种方式和你测试有效的Adapter->query()逻辑一致，绕开了参数引用的问题，同时也能保证SQL的正确性（ZF会帮你处理转义）。

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