本文旨在解决codeigniter 3框架中，使用sqlsrv数据库驱动时，查询数据库无法直接获取结果的问题。核心在于理解`$this->db->query()`方法返回的是一个结果对象，而非直接的数据数组。我们将详细演示如何通过调用结果对象的方法（如`result_array()`、`result()`）来正确地获取并处理查询数据，确保数据能够被成功显示和使用，并提供完整的代码示例和最佳实践。
在CodeIgniter 3 (CI3) 框架中进行数据库操作时，尤其是当使用如SQLSRV这样的特定数据库驱动时，开发者可能会遇到一个常见的问题：执行$this-youjiankuohaophpcndb->query()后，尝试直接访问返回的变量却发现它并非预期的数组数据。这通常是由于对CI3数据库抽象层的返回机制理解不足所致。本文将深入探讨这一问题，并提供一套完整的解决方案和最佳实践。
理解CodeIgniter的数据库查询结果对象
当你在CodeIgniter 3中使用$this->db->query($sql)方法执行SQL查询时，该方法并不会直接返回一个包含数据行的数组。相反，它返回的是一个数据库结果对象 (Database Result Object)。这个对象封装了查询执行后的所有相关信息，包括查询结果、行数、字段信息等。
对于SQL Server (通过sqlsrv驱动)，返回的通常是CI_DB_sqlsrv_result类的实例。如果你直接对这个对象进行var_dump()，你会看到一个复杂的对象结构，而不是你期望的数据数组，这正是许多新手感到困惑的原因。
正确获取查询结果数据
要从数据库结果对象中提取实际的数据，你需要调用其提供的方法。CI3提供了多种灵活的方法来获取不同格式的查询结果：
- result_array(): 返回一个包含所有结果行的关联数组。每一行本身也是一个关联数组，键为数据库列名。这是获取多行数据最常用的方法之一。
- result(): 返回一个包含所有结果行的对象数组。每一行都是一个标准PHP对象，其属性名为数据库列名。
- row_array(): 返回单行结果的关联数组。如果你确定查询只返回一行数据，或者只需要第一行数据，可以使用此方法。
- row(): 返回单行结果的标准PHP对象。
下面我们将通过一个具体的例子来演示如何在CI3模型中正确地使用这些方法。
示例代码：修正模型层数据获取
假设你有一个名为Mod_login的模型，其中包含一个Aplikasi()方法用于查询aplikasi表。
原始（不正确）的模型代码片段：
class Mod_login extends CI_Model {
function Aplikasi() {
$sql = "SELECT * FROM aplikasi";
$data = $this->db->query($sql);
var_dump($data); // 这里会显示一个结果对象
die();
// ... 后续逻辑无法正确处理 $data
}
}修正后的模型代码示例：
为了正确获取数据，我们需要在$this->db->query($sql)返回结果对象后，调用其相应的方法。
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Mod_login extends CI_Model {
/**
* 获取应用列表数据
*
* @return array|bool 返回应用数据的关联数组，如果查询失败则返回 FALSE
*/
public function Aplikasi() {
$sql = "SELECT * FROM aplikasi";
$query = $this->db->query($sql);
// 检查查询是否成功
// CI3的query()方法在执行失败时会返回 FALSE
if ($query === FALSE) {
// 可以在这里记录错误日志，例如：
// log_message('error', 'Database query failed: ' . $this->db->error()['message']);
return FALSE; // 查询失败，返回FALSE
}
// 根据需求选择获取结果的方式
// 方式一：获取所有结果行作为关联数组的数组
return $query->result_array();
// 方式二：获取所有结果行作为对象的数组
// return $query->result();
// 方式三：如果只期望获取一行数据，可以这样
// return $query->row_array(); // 获取单行关联数组
// return $query->row(); // 获取单行对象
}
}在上述修正后的代码中，我们调用了$query->result_array()来获取一个包含所有应用数据的关联数组。这样，控制器就可以直接使用这个数组。
控制器与视图层集成
修正模型后，控制器和视图层的处理将变得直观。
控制器代码示例：
<?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'); // 加载会话库
}
public function index() {
// 假设这里有登录状态检查
$logged_in = $this->session->userdata('logged_in');
if ($logged_in == TRUE) {
// 如果已登录，可以加载其他仪表盘数据
// ...
// $this->load->view('dashboard/main_view');
// 为演示，我们仍然调用Mod_login->Aplikasi()
$data['aplikasi_list'] = $this->Mod_login->Aplikasi();
// 检查数据是否成功获取
if ($data['aplikasi_list'] === FALSE) {
// 处理查询失败的情况，例如显示错误消息
$data['error_message'] = '无法加载应用数据，请稍后再试。';
}
$this->load->view('admin/login_data', $data); // 传递数据到视图
} else {
// 如果未登录，重定向到登录页或显示登录表单
redirect('auth/login'); // 假设有 auth/login 路由
}
}
}视图层 (admin/login_data.php) 代码示例：
在视图中，你可以像处理普通数组一样遍历和显示数据。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>应用列表</title>
</head>
<body>
<h1>应用列表</h1>
<?php if (isset($error_message)): ?>
<p style="color: red;"><?php echo $error_message; ?></p>
<?php elseif (!empty($aplikasi_list)): ?>
<ul>
<?php foreach ($aplikasi_list as $aplikasi): ?>
<li>
<!-- 假设应用表有 id 和 name 字段 -->
ID: <?php echo htmlspecialchars($aplikasi['id']); ?> -
名称: <?php echo htmlspecialchars($aplikasi['name']); ?>
</li>
<?php endforeach; ?>
</ul>
<?php else: ?>
<p>没有找到任何应用数据。</p>
<?php endif; ?>
</body>
</html>注意事项与最佳实践
- 错误处理: 始终检查$this->db->query()的返回值。如果查询失败，它会返回FALSE。在生产环境中，应记录错误日志而非直接die()，并向用户显示友好的错误信息。
- 数据为空检查: 在视图层，使用empty()或count()检查从模型返回的数据是否为空，以避免在没有数据时产生PHP错误。
-
安全性:
- SQL注入: 尽管本教程侧重于结果获取，但始终要警惕SQL注入。对于包含用户输入的查询，请务必使用CI3的查询绑定（$this->db->query("SELECT * FROM users WHERE id = ?", array($id))）或查询构造器（Query Builder）来自动转义数据。
- XSS攻击: 在视图中输出任何从数据库获取的数据时，使用htmlspecialchars()或CI3的xss_clean()函数来防止跨站脚本攻击。
- 数据库配置: 确保application/config/database.php中的sqlsrv配置正确，包括hostname、username、password和database。char_set和dbcollat也应与数据库编码保持一致。
-
调试:
- 使用log_message('debug', 'Your debug message here');将信息写入CI3的日志文件。
- 临时使用var_dump($variable); die();进行快速调试，但在生产代码中移除。
- 将db_debug设置为TRUE（在开发环境中）可以显示数据库错误信息，但在生产环境中应设为FALSE以避免泄露敏感信息。
- save_queries: 在database.php配置中，'save_queries' => FALSE可以减少内存使用，但这意味着你无法通过$this->db->queries获取已执行的查询列表。根据你的调试需求进行权衡。
总结
掌握CodeIgniter 3中数据库结果对象的概念是高效进行数据库操作的关键。通过正确调用result_array()、result()等方法，你可以轻松地从sqlsrv或其他数据库驱动获取并处理查询数据。结合良好的错误处理、安全性措施和调试技巧，你的CI3应用程序将更加健壮和可靠。
