# CodeIgniter 用户指南 版本 2.2.0

编辑文档、查看近期更改请 登录 或 注册 找回密码

搜索用户指南

查看原文

# 数据库配置

CodeIgniter 有一个配置文件让你存放数据库连接值（username:用户名，password:密码，database name:数据库名，等等..）. 该配置文件位于 `application/config/database.php`. 你也可以通过放置不同的database.php文件到特定的环境配置文件夹里来设置特定环境的数据库连接值.

配件文件存放在一个如下格式的一个多维数组里:

`$db['default']['hostname'] = "localhost";
$db['default']['username'] = "root";
$db['default']['password'] = "";
$db['default']['database'] = "database_name";
$db['default']['dbdriver'] = "mysql";
$db['default']['dbprefix'] = "";
$db['default']['pconnect'] = TRUE;
$db['default']['db_debug'] = FALSE;
$db['default']['cache_on'] = FALSE;
$db['default']['cachedir'] = "";
$db['default']['char_set'] = "utf8";
$db['default']['dbcollat'] = "utf8_general_ci";
$db['default']['swap_pre'] = "";
$db['default']['autoinit'] = TRUE;
$db['default']['stricton'] = FALSE;`

我们使用多维数组的原因是为了让你随意的存储多个连接值的设置。举例：如果你运行多个环境（development：开发、production：生产、test：测试 等等..），你能为每个环境建立独立的连接组，并在组直接进行切换。举例，设置一个"test"环境，你可以这样做：

`$db['test']['hostname'] = "localhost";
$db['test']['username'] = "root";
$db['test']['password'] = "";
$db['test']['database'] = "database_name";
$db['test']['dbdriver'] = "mysql";
$db['test']['dbprefix'] = "";
$db['test']['pconnect'] = TRUE;
$db['test']['db_debug'] = FALSE;
$db['test']['cache_on'] = FALSE;
$db['test']['cachedir'] = "";
$db['test']['char_set'] = "utf8";
$db['test']['dbcollat'] = "utf8_general_ci";
$db['test']['swap_pre'] = "";
$db['test']['autoinit'] = TRUE;
$db['test']['stricton'] = FALSE;`

那么，告诉系统使用"test"组，你可以设置位于配置文件中的变量：

`$active_group = "test";`

注意: "test"的名字是任意的，这可以让你自由设置，我们的主要连接默认使用"default"这个名字，当然，您可以基于您的项目为它起一个更有意义的名字。

### Active Record

Active Record 类 可以通过数据库配置文件里的$active_record变量进行全局的设定（允许/禁止 TRUE/FALSE (boolean)）. 如果你不用这个类，那么你可以通过将这个变量值设置成FALSE来减少在数据库类初始化时对电脑资源的消耗。

`$active_record = TRUE;`

注意： 一些CodeIgniter的类，例如Sessions，在执行一些函数的时候需要Active Records的支持。

### 参数解析:

- hostname - 数据库的主机名，通常位于本机，可以表示为 "localhost".
- username - 需要连接到数据库的用户名.
- password - 登陆数据库的密码.
- database - 你需要连接的数据库名.
- dbdriver - 数据库类型。如：mysql、postgres、odbc 等。必须为小写字母。
- dbprefix - 当运行Active Record查询时数据表的前缀,它允许在一个数据库上安装多个CodeIgniter程序.
- pconnect - TRUE/FALSE (boolean) - 使用持续连接.
- db_debug - TRUE/FALSE (boolean) - 显示数据库错误信息.
- cache_on - TRUE/FALSE (boolean) - 数据库查询缓存是否开启，详情请见数据库缓存类。
- cachedir - 数据库查询缓存目录所在的服务器绝对路径。
- char_set - 与数据库通信时所使用的字符集。
- dbcollat - 与数据库通信时所使用的字符规则。

  提示: 就MYSQL或MYSQLi数据库而言，如果服务器运行环境PHP版本小于5.2.3、MYSQL版本小于5.0.7，那么该项设置仅被用来备份（由数据库维护类DB Forge所创建查询）。如果使用多字节字符集并且使用低版本PHP环境中不兼容的mysql_real_escape_string()函数，它将使网站更容易受到SQL注入的危险。

- swap_pre - 替换默认的dbprefix表前缀，该项设置对于分布式应用是非常有用的，你可以在查询中使用由最终用户定制的表前缀。

曜日晨阳注: 如果设置了 $db['default']['dbprefix'] 的值 同时也设置了 $db['default']['swap_pre'] 的值，则会将查询代码中和$db['default']['swap_pre'] 的值一致的字符替换成 $db['default']['dbprefix'] 的值，如果没有设置 $db['default']['swap_pre'] 值，就直接在数据库表名前面加上 $db['default']['dbprefix'] 值。

- autoinit - 当数据库类库(database library)被载入的时候是否需要自动连接数据库，如果设置为FALSE，将在首次查询前进行连接。
- stricton - TRUE/FALSE (boolean) - 是否强制使用 "Strict Mode" 连接, 在开发程序时，使用 strict SQL 是一个好习惯。
- port - 数据库端口号. 要使用这个值，你应该添加一行代码到数据库配置数组。`$db['default']['port'] = 5432;`

提示: 并不是所有的值都是必须的,这取决与您所使用的数据库平台,如(MySQL, Postgres, 等.) 例如, 当你使用SQLite时,你不需要提供username 或 password, 数据库名字就是您数据库文件的路径. 以上内容假定您使用的是 MySQL 数据库.

翻译贡献者: amos, chenshenghan, Drice, Hex, pipi95, tanqimin, thankwsx, tinsn, yinzhili, zehee, 曜日晨阳
最后修改: 2013-03-19 05:07:44