MSSQL存储过程在Yii2+PHP中无返回值问题求助

我碰到过不少Yii2调用SQL Server存储过程踩坑的情况，你这个返回-1的问题大概率是这几个原因之一，咱们一步步排查：

1. 存储过程返回值类型和Yii2调用方式不匹配 #

首先得明确你的存储过程是怎么返回值的：

• 如果是用RETURN @value这种方式返回，Yii2的createCommand()->execute()默认返回的是受影响行数，根本不是存储过程的RETURN值。这时候得换方式获取：

  // 先声明变量接收RETURN值，再查询出来
  $command = Yii::$app->db->createCommand("DECLARE @ret INT; EXEC @ret = YourProcName; SELECT @ret AS ret_val;");
  $result = $command->queryScalar();
  // 这里$result就是你要的0
  

• 如果是用输出参数返回，那得在调用时绑定参数：

  $outParam = 0;
  $command = Yii::$app->db->createCommand("EXEC YourProcName @outParam = :outParam OUTPUT;");
  // 绑定输出参数，指定类型和长度
  $command->bindParam(':outParam', $outParam, \PDO::PARAM_INT, 10);
  $command->execute();
  // 执行后$outParam就是存储过程输出的值
  

2. 数据库连接配置有问题 #

检查下Yii2的数据库组件配置：

• 驱动是不是用的sqlsrv？如果是dblib可能会有兼容性问题，建议换成官方的sqlsrv驱动（记得先装PHP的sqlsrv扩展）。
• 确认连接的数据库用户和你在SSMS里用的权限一致，有时候权限不足会导致存储过程执行异常，但表面只返回-1。

3. 存储过程执行时的隐性错误 #

虽然SSMS里跑正常，但PHP调用时的会话上下文可能不一样（比如SET选项、临时表作用域），导致内部出错。可以试试：

• 在存储过程开头加SET NOCOUNT ON;，默认情况下SQL Server会返回受影响行数的消息，Yii2可能把这个当成结果集的一部分，干扰返回值获取。
• 调用时捕获错误信息，看看是不是有隐性异常：

  try {
      $command = Yii::$app->db->createCommand("EXEC YourProcName;");
      $result = $command->execute();
      echo $result;
  } catch (\yii\db\Exception $e) {
      var_dump($e->getMessage());
  }
  

  这样能看到SQL级别的错误有没有被Yii2捕获。

4. 别搞混execute()的返回值定义 #

一定要记住：Yii2的Command::execute()返回的是受影响的行数，不是存储过程的返回值。如果你的存储过程没修改任何数据，返回-1（不同驱动可能有差异）是正常的，这时候绝对不能用execute()来拿存储过程的RETURN值，必须用queryScalar()或者queryOne()去查询返回的结果集。

举个实际例子，如果你的存储过程是这样的：

CREATE PROCEDURE CheckValidStatus
AS
BEGIN
    SET NOCOUNT ON;
    -- 你的业务逻辑
    RETURN 0;
END

那Yii2里正确的调用方式就是：

$retVal = Yii::$app->db->createCommand("DECLARE @ret INT; EXEC @ret = CheckValidStatus; SELECT @ret;")->queryScalar();
echo $retVal; // 这里会输出预期的0

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