本教程旨在指导开发者如何在 CodeIgniter 3 (CI3) 框架中使用 SQL Server 数据库驱动时，正确地从查询结果对象中提取数据。文章将详细解释 CI3 数据库查询结果对象的特性，提供 `result_array()` 等关键方法的用法，并通过完整的配置、模型和控制器示例，帮助您高效、准确地获取并处理 SQL Server 的查询结果。
在使用 CodeIgniter 3 (CI3) 框架与 SQL Server 数据库进行交互时，开发者可能会遇到执行数据库查询后，尽管连接成功，但无法直接从查询结果中提取数据的困惑。这通常不是连接或 SQL 语句本身的问题，而是对 CI3 数据库类返回的结果对象理解不足。本文将深入探讨如何在 CI3 中正确地从 SQL Server 查询结果对象中提取数据，并提供详细的配置、模型和控制器示例。
理解 CodeIgniter 数据库查询结果对象
当您在 CodeIgniter 3 中使用 $this->db->query($sql) 执行一条 SELECT 语句时，如果查询成功，CI3 不会直接返回一个包含数据的数组，而是返回一个 CI_DB_sqlsrv_result 类型的数据库结果对象。这个对象封装了查询的所有信息，包括查询到的行数、字段名以及实际的数据。要访问这些数据，您需要调用该结果对象上的特定方法。
关键结果获取方法
CI3 提供了多种方法来从结果对象中获取数据，最常用的是：
- result(): 返回一个对象数组。每个对象代表一行数据，其属性对应数据库表的字段名。
- result_array(): 返回一个关联数组的数组。每个内部关联数组代表一行数据，键名对应数据库表的字段名。
- row(): 返回一个对象，代表查询结果的第一行。
- row_array(): 返回一个关联数组，代表查询结果的第一行。
- num_rows(): 返回查询结果的行数。
数据库配置示例 (config/database.php)
首先，确保您的 CodeIgniter 数据库配置正确指向 SQL Server 驱动。以下是一个典型的配置示例：
'',
'hostname' => '10.xxx.xxx.x', // 您的 SQL Server IP 地址或主机名
'username' => 'your_username', // 数据库用户名
'password' => 'your_password', // 数据库密码
'database' => 'your_database_name', // 数据库名称
'dbdriver' => 'sqlsrv', // 关键：指定 SQL Server 驱动
'dbprefix' => '',
'pconnect' => FALSE,
'db_debug' => (ENVIRONMENT !== 'production'), // 生产环境建议关闭调试
'cache_on' => FALSE,
'cachedir' => '',
'char_set' => 'utf8', // 根据您的数据库编码设置
'dbcollat' => 'utf8_general_ci',
'swap_pre' => '',
'encrypt' => FALSE, // 如果需要加密连接，请设置为 TRUE
'compress' => FALSE,
'stricton' => FALSE,
'failover' => array(),
'save_queries' => TRUE // 建议在开发阶段设置为 TRUE 以便调试
);模型中的正确数据获取示例 (application/models/Mod_login.php)
在模型中，执行查询后，需要调用结果对象的方法来获取实际数据。
db->query($sql);
// 检查查询是否成功，query() 方法在执行失败时可能返回 FALSE
if ($query === FALSE) {
// 记录错误或进行其他错误处理
log_message('error', 'SQL Query Failed: ' . $this->db->error()['message']);
return false;
}
// 获取查询结果为关联数组的数组
// var_dump($query->result_array()); // 调试时可在此处查看结果
// die(); // 调试时可在此处终止执行
if ($query->num_rows() > 0) {
return $query->result_array(); // 返回所有结果行作为关联数组
} else {
return []; // 没有结果时返回空数组
}
}
/**
* 获取单个应用数据 (示例)
* @param int $id 应用ID
* @return array|false 返回单个应用数据关联数组，或在查询失败/无结果时返回 false
*/
public function getSingleAplikasi($id) {
$sql = "SELECT id, name, description FROM aplikasi WHERE id = ?";
// 使用占位符 '?' 进行查询绑定，防止 SQL 注入
$query = $this->db->query($sql, array($id));
if ($query === FALSE) {
log_message('error', 'SQL Query Failed: ' . $this->db->error()['message']);
return false;
}
if ($query->num_rows() > 0) {
return $query->row_array(); // 返回第一行结果作为关联数组
} else {
return false; // 没有结果时返回 false
}
}
}控制器中的调用示例 (application/controllers/Admin.php)
控制器负责调用模型方法，并将获取到的数据传递给视图。
load->model('Mod_login'); // 加载模型
$this->load->helper('url'); // 加载 URL 辅助函数
$this->load->library('session'); // 加载 session 库
}
public function index() {
$logged_in = $this->session->userdata('logged_in');
if ($logged_in === TRUE) {
redirect('dashboard'); // 如果已登录，重定向到仪表盘
} else {
$data['aplikasi'] = $this->Mod_login->getAplikasiData(); // 调用模型方法获取数据
// 检查模型返回的数据
if ($data['aplikasi'] === false) {
// 处理数据库查询失败的情况，例如显示错误消息
$data['error_message'] = '无法加载应用数据，请稍后再试。';
$this->load->view('admin/login_error_view', $data); // 加载错误视图
} else {
$this->load->view('admin/login_data', $data); // 将数据传递给视图
}
}
}
public function view_aplikasi($id) {
$aplikasi_item = $this->Mod_login->getSingleAplikasi($id);
if ($aplikasi_item === false) {
show_404(); // 或者显示错误页面
} else {
$data['aplikasi_detail'] = $aplikasi_item;
$this->load->view('admin/aplikasi_detail_view', $data);
}
}
}视图中的数据展示 (application/views/admin/login_data.php)
在视图中，您可以像处理普通数组一样遍历并展示 $aplikasi 数据。
登录页面
应用列表
