CodeIgniter作为轻量级的PHP开发框架，内置了完善的数据库操作类，连接数据库的步骤十分简单，下面是完整的操作说明。
第一步：确认数据库驱动支持
CodeIgniter默认支持MySQLi、PDO、PostgreSQL等多种数据库驱动，常用的MySQL相关驱动为MySQLi和PDO，你可以根据自己服务器的环境选择合适的驱动，本文以PDO驱动为例进行说明。
第二步：修改数据库配置文件
CodeIgniter的数据库配置文件位于application/config/database.php，打开该文件后找到$db数组的配置项，按照你的数据库环境修改对应参数：
<?php
// 数据库配置数组
$db['default'] = array(
'dsn' => '',
'hostname' => 'localhost', // 数据库主机地址，本地一般为localhost
'username' => 'root', // 数据库用户名
'password' => '123456', // 数据库密码
'database' => 'test_db', // 要连接的数据库名称
'dbdriver' => 'pdo', // 数据库驱动，这里选择pdo
'dbprefix' => '', // 表前缀，没有则留空
'pconnect' => FALSE, // 是否使用持久连接
'db_debug' => TRUE, // 是否开启数据库调试模式
'cache_on' => FALSE, // 是否开启查询缓存
'cachedir' => '', // 缓存目录
'char_set' => 'utf8', // 字符集
'dbcollat' => 'utf8_general_ci', // 字符校对规则
'swap_pre' => '',
'encrypt' => FALSE,
'compress' => FALSE,
'stricton' => FALSE,
'failover' => array(),
'save_queries' => TRUE
);如果你的数据库不在本地，需要将hostname修改为对应的数据库服务器IP，比如192.168.0.1或者远程服务器地址，同时确认用户名、密码和数据库名填写正确。
第三步：加载数据库连接
CodeIgniter提供了两种加载数据库连接的方式，你可以根据需求选择：
方式一：自动加载数据库
如果需要全局使用数据库操作，可以修改application/config/autoload.php文件，找到$autoload['libraries']数组，添加database：
<?php
$autoload['libraries'] = array('database', 'session'); // 自动加载数据库和session类这样框架启动时会自动连接数据库，所有控制器中都可以直接使用数据库操作类。
方式二：手动加载数据库
如果只有部分控制器需要使用数据库，可以在对应的控制器构造函数或者方法中手动加载：
<?php
class User extends CI_Controller {
public function __construct() {
parent::__construct();
// 手动加载数据库类
$this->load->database();
}
}第四步：验证数据库连接是否成功
完成上述配置后，可以编写一个简单的查询代码验证连接是否正常，比如在控制器中添加如下方法：
<?php
public function test_db() {
// 执行简单查询，获取数据库版本
$query = $this->db->query('SELECT VERSION() as version');
$result = $query->row();
if ($result) {
echo '数据库连接成功，数据库版本为：' . $result->version;
} else {
echo '数据库连接失败，请检查配置参数';
}
}访问该方法对应的URL，如果输出数据库版本信息，说明连接已经成功，接下来就可以使用CodeIgniter提供的数据库操作方法进行增删改查等操作了。
常见问题说明
- 如果连接时报错，首先检查
database.php中的参数是否填写正确，尤其是密码和数据库名是否匹配 - 如果选择PDO驱动，需要确保PHP环境已经开启了PDO扩展
- 不要在生产环境开启
db_debug参数，避免暴露数据库敏感信息
CodeIgniter数据库配置数据库连接PDO驱动数据库操作修改时间：2026-06-02 04:20:18