本教程旨在解决 codeigniter 3 框架中通过 sqlsrv 驱动连接 sql server 数据库时，无法直接获取查询结果数据的问题。我们将详细介绍 codeigniter 数据库抽象层的特性，阐明 `query()` 方法返回的是结果对象而非直接数据数组，并提供正确的模型层代码示例，指导开发者如何利用 `result_array()` 等方法从结果对象中高效提取并处理数据库查询数据。
在使用 CodeIgniter 3 (CI3) 框架连接 SQL Server 数据库时，开发者常常会遇到一个常见问题：执行 query() 方法后，直接 var_dump() 返回的并非预期的数组数据，而是一个数据库结果对象。这导致新手开发者难以获取并使用实际的查询结果。本文将深入探讨这一现象，并提供在 CI3 中正确配置 SQLSRV 驱动、执行查询并提取数据的方法。
1. CodeIgniter 3 数据库配置
首先，确保您的 CodeIgniter 3 应用程序已正确配置 SQLSRV 数据库驱动。在 application/config/database.php 文件中，您需要设置相应的数据库连接参数。以下是一个典型的 SQLSRV 配置示例：
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
$active_group = 'default';
$query_builder = TRUE;
$db['default'] = array(
'dsn' => '',
'hostname' => '10.***.***.*', // 替换为您的 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 // 确保在需要调试时查询被保存
);配置要点：
- dbdriver：必须设置为 sqlsrv。
- hostname：SQL Server 的 IP 地址或主机名。
- username 和 password：用于连接数据库的凭据。
- database：要连接的数据库名称。
- db_debug：在开发环境中设置为 TRUE 有助于发现连接或查询错误。
- char_set 和 dbcollat：根据您的数据库和应用程序需求进行设置，确保字符编码兼容性。
2. 模型层：执行查询与正确获取数据
在 CodeIgniter 中，数据库操作通常在模型（Model）层进行。当您使用 $this->db->query() 方法执行 SQL 查询时，CodeIgniter 的数据库抽象层会返回一个数据库结果对象（例如 CI_DB_sqlsrv_result 对象），而不是直接的数据数组。要获取实际的查询结果数据，您需要调用该结果对象上的特定方法。
以下是修正后的模型层代码示例：
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Mod_login extends CI_Model {
public function __construct() {
parent::__construct();
// 可以在构造函数中加载数据库库，如果未在 autoload.php 中加载
// $this->load->database();
}
/**
* 获取应用列表数据
* @return array|false 返回应用数据数组，如果查询失败则返回 false
*/
public function Aplikasi() {
$sql = "SELECT * FROM aplikasi";
$query = $this->db->query($sql);
// 调试：var_dump($query); 会显示一个结果对象
// 要获取实际数据，需要调用结果对象的方法
// 检查查询是否成功，并且是否有结果
if ($query && $query->num_rows() > 0) {
// 获取所有结果行作为关联数组的数组
// $data = $query->result_array();
// 调试：输出结果数组
// var_dump($data);
// die(); // 调试完成后移除此行
return $query->result_array();
} else {
// 如果查询失败或没有结果
return false;
}
}
}关键修正点：
- $query = $this->db->query($sql);：此行返回的是一个数据库结果对象。
- $query->result_array()：这是从结果对象中提取所有结果行并以关联数组形式返回的关键方法。
- result_array()：返回一个包含所有结果行的关联数组。
- result()：返回一个包含所有结果行的对象数组。
- row_array()：返回单个结果行作为关联数组。
- row()：返回单个结果行作为对象。
- $query->num_rows()：用于获取查询返回的行数，可以用来判断是否有结果。
3. 控制器层：调用模型并传递数据
控制器负责调用模型方法，获取数据，并将其传递给视图。
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Home 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'); // 如果已登录，重定向到仪表盘
} else {
// 调用模型方法获取应用数据
$aplikasi_data = $this->Mod_login->Aplikasi();
// 将数据传递给视图
$data['aplikasi'] = $aplikasi_data;
$this->load->view('admin/login_data', $data);
}
}
}4. 视图层：展示查询结果
在视图文件中，您可以遍历传递过来的数据数组并展示内容。
<!DOCTYPE html>
<html>
<head>
<title>应用列表</title>
</head>
<body>
<h1>可用应用</h1>
<?php if (!empty($aplikasi) && is_array($aplikasi)): ?>
<ul>
<?php foreach ($aplikasi as $app): ?>
<li>ID: <?php echo $app['id']; ?>, 名称: <?php echo $app['nama']; ?></li>
<!-- 假设 'id' 和 'nama' 是数据库表中的列名 -->
<?php endforeach; ?>
</ul>
<?php else: ?>
<p>没有找到任何应用数据。</p>
<?php endif; ?>
</body>
</html>5. 注意事项与最佳实践
- PHP SQLSRV 扩展安装：确保您的 PHP 环境已正确安装并配置了适用于当前 PHP 版本的 SQLSRV 扩展。这是连接 SQL Server 的前提。您可以查看 phpinfo() 输出，确认 sqlsrv 模块已加载。
-
错误处理：
- 在模型中，$this->db->query() 如果执行失败（例如 SQL 语法错误），会返回 FALSE。因此，检查 $query 是否为 FALSE 是必要的。
- 如果需要获取数据库的具体错误信息，可以使用 $this->db->error() 方法。
- 在生产环境中，应避免直接输出错误信息，而是记录到日志文件。
-
CodeIgniter Active Record：对于更复杂的查询或为了提高代码的可读性和安全性，强烈建议使用 CodeIgniter 的 Active Record 类。它提供了一种更面向对象的方式来构建查询，并自动处理 SQL 注入防护。
// 使用 Active Record 获取数据 public function AplikasiActiveRecord() { $query = $this->db->get('aplikasi'); // 相当于 SELECT * FROM aplikasi if ($query->num_rows() > 0) { return $query->result_array(); } return false; } -
调试技巧：
- 使用 var_dump() 配合 die() 在关键点检查变量内容。
- 开启 db_debug 可以让 CodeIgniter 在发生数据库错误时显示详细信息。
- 检查 PHP 错误日志和 CodeIgniter 的日志文件 (application/logs/)。
总结
在 CodeIgniter 3 中使用 SQLSRV 驱动连接 SQL Server 并获取查询结果的核心在于理解 $this->db->query() 方法返回的是一个数据库结果对象。要获取实际的数据数组，您必须调用该结果对象上的方法，如 result_array()、result()、row_array() 或 row()。遵循本教程中的配置和代码实践，将帮助您有效地在 CI3 应用程序中处理 SQL Server 数据库交互。同时，利用 Active Record 和完善的错误处理机制，可以进一步提升代码的健壮性和可维护性。
