本教程旨在解决 CodeIgniter 3 (CI3) 使用 SQLSRV 数据库驱动时，无法正确获取查询结果的常见问题。文章将详细指导如何配置数据库连接、在模型中执行 SQL 查询，并重点介绍如何通过 CI3 提供的 `result()` 或 `result_array()` 方法有效提取数据，确保应用程序能够成功与 SQL Server 交互并展示数据。

在 CodeIgniter 3 (CI3) 框架中与 SQL Server 数据库交互时，开发者常会遇到查询执行成功但无法正确获取数据的问题。这通常不是连接失败，而是对 CI3 数据库结果对象处理不当所致。本文将提供一个详细的教程，指导如何正确配置 SQLSRV 驱动，并在模型中有效获取查询结果。

1. CodeIgniter 3 SQLSRV 数据库配置要点

首先，确保您的 CodeIgniter 3 应用程序已正确配置 SQLSRV 数据库驱动。在 application/config/database.php 文件中，您需要设置相应的数据库参数。

配置示例：

 '',
    'hostname' => '10.xxx.xxx.x', // 替换为您的 SQL Server IP 地址或主机名
    'username' => 'username',     // 替换为您的数据库用户名
    'password' => 'password',     // 替换为您的数据库密码
    'database' => 'mydb',         // 替换为您的数据库名称
    'dbdriver' => 'sqlsrv',       // 指定使用 SQLSRV 驱动
    'dbprefix' => '',
    'pconnect' => FALSE,
    'db_debug' => (ENVIRONMENT !== 'production'), // 生产环境建议关闭
    'cache_on' => FALSE,
    'cachedir' => '',
    'char_set' => 'utf8',         // 确保字符集兼容
    'dbcollat' => 'utf8_general_ci',
    'swap_pre' => '',
    'encrypt'  => FALSE,
    'compress' => FALSE,
    'stricton' => FALSE,
    'failover' => array(),
    'save_queries' => TRUE // 建议在开发环境开启，方便调试
);

注意事项：

• PHP SQLSRV 扩展： 确保您的 PHP 环境已正确安装并启用了适用于您 PHP 版本的 php_sqlsrv.dll 和 php_pdo_sqlsrv.dll 扩展。这些扩展通常需要从 Microsoft 官方下载。
• 连接参数： hostname、username、password 和 database 必须与您的 SQL Server 实例和凭据完全匹配。
• db_debug： 在开发阶段将其设置为 TRUE (或基于 ENVIRONMENT) 可以帮助您捕获数据库错误信息。在生产环境，出于安全考虑应设置为 FALSE。

2. 在模型中执行查询与获取结果

在 CodeIgniter 中，所有的数据库操作通常都在模型（Model）中完成。当您执行一个查询时，$this->db->query() 方法会返回一个数据库结果对象，而不是直接的数据数组。要获取实际的数据行，您需要使用该结果对象提供的方法。

错误示例分析：

初学者常犯的错误是直接 var_dump() 数据库查询返回的结果对象，例如：

// 错误的示例
class Mod_login extends CI_Model {
    function Aplikasi() {
        $sql = "SELECT * FROM aplikasi";
        $data = $this->db->query($sql);
        var_dump($data); // 这里 $data 是一个对象，不是数据数组
        die();
        // ... 后续逻辑
    }
}

上述代码中，var_dump($data) 会输出一个 CI_DB_sqlsrv_result 类型的对象，其中包含了查询元数据、行数等信息，但不是您期望的包含数据行的数组。

正确获取查询结果的方法：

要从结果对象中提取数据，CodeIgniter 提供了多种方法：

• result_array()： 返回一个包含所有结果行的关联数组。每行是一个关联数组。
• result()： 返回一个包含所有结果行的对象数组。每行是一个标准对象。
• row_array()： 返回单行结果的关联数组。适用于预期只返回一行数据的情况。
• row()： 返回单行结果的标准对象。适用于预期只返回一行数据的情况。

优化后的模型代码示例：

class Mod_login extends CI_Model {
    function Aplikasi() {
        $sql = "SELECT * FROM aplikasi";
        $query = $this->db->query($sql); // 执行查询，返回结果对象

        // 检查查询是否成功且有结果
        if ($query && $query->num_rows() > 0) {
            // 获取所有结果行作为关联数组
            $data = $query->result_array();
            // 调试时可以使用 var_dump 检查数据内容
            // var_dump($data);
            // die();
            return $data;
        } else {
            // 查询失败或没有结果
            return array(); // 返回空数组或 false
        }
    }
}

在这个优化后的模型中，我们首先检查 $query 是否有效，然后使用 $query->result_array() 来获取包含实际数据行的关联数组。

3. 控制器与视图的数据传递

在控制器中，您调用模型方法获取数据，并将数据传递给视图进行展示。

控制器代码示例：

load->model('Mod_login'); // 加载模型
        $this->load->library('session'); // 加载 session 库
    }

    public function index() {
        $logged_in = $this->session->userdata('logged_in');

        if ($logged_in == TRUE) {
            // 用户已登录，重定向到仪表板主页
            redirect('dashboard/home');
        } else {
            // 用户未登录，加载登录页面并尝试获取应用数据
            $aplikasi_data = $this->Mod_login->Aplikasi(); // 从模型获取数据

            // 将数据传递给视图
            $data['aplikasi'] = $aplikasi_data;
            $this->load->view('admin/login_data', $data);
        }
    }

    // ... 其他方法
}

在视图文件 admin/login_data.php 中，您可以通过 $aplikasi 变量访问传递过来的数据，并使用循环进行展示：

    


    
应用列表
    
        

            
                
ID: , 名称: 
            
        
    
        
没有找到应用数据。
    

    

请注意，视图中的 $item['id'] 和 $item['nama'] 需要根据您数据库 aplikasi 表的实际列名进行调整。

4. 调试与故障排除

• db_debug： 确保在开发环境中 database.php 中的 'db_debug' 设置为 TRUE。这样，当数据库查询出错时，CodeIgniter 会显示详细的错误信息，帮助您定位问题。
• var_dump()： 在模型中，当您对 $this->db->query() 的返回结果不确定时，可以使用 var_dump($query) 来查看结果对象的结构。在获取数据后，使用 var_dump($data) 来确认是否成功提取了数组数据。
• SQL 查询测试： 建议将您的 SQL 查询语句直接在 SQL Server Management Studio (SSMS) 或其他数据库客户端中运行，以确保 SQL 语句本身是正确的，并且数据库用户有权限访问相关表。

总结

正确在 CodeIgniter 3 中使用 SQLSRV 驱动并获取查询结果的关键在于理解 db->query() 返回的是一个结果对象，而不是直接的数据。通过利用 result_array()、result() 等方法，您可以轻松地将查询结果转换为可用的数组或对象集合，从而在应用程序中进行处理和展示。遵循本文的指导，将有助于您避免常见的陷阱，并更高效地开发与 SQL Server 集成的 CI3 应用程序。