本教程旨在解决 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 文件中，您需要设置相应的数据库参数。
配置示例：
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
$active_group = 'default';
$query_builder = TRUE;
$db['default'] = array(
'dsn' => '',
'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. 控制器与视图的数据传递
在控制器中，您调用模型方法获取数据，并将数据传递给视图进行展示。
控制器代码示例：
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Dashboard extends CI_Controller {
public function __construct() {
parent::__construct();
$this->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 变量访问传递过来的数据，并使用循环进行展示：
<!DOCTYPE html>
<html>
<head>
<title>Login</title>
</head>
<body>
<h1>应用列表</h1>
<?php if (!empty($aplikasi)): ?>
<ul>
<?php foreach ($aplikasi as $item): ?>
<li>ID: <?php echo $item['id']; ?>, 名称: <?php echo $item['nama']; ?></li>
<?php endforeach; ?>
</ul>
<?php else: ?>
<p>没有找到应用数据。</p>
<?php endif; ?>
<!-- 登录表单等其他内容 -->
</body>
</html>请注意，视图中的 $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 应用程序。
