数据库配置

CodeIgniter 有一个配置文件用来保存数据库配置（用户名、密码、数据库名等等），这个配置文件位于 application/config/database.php。You can also set database connection values for specific environments by placing database.phpin the respective environment config folder.

配置存放在一个多维数组里，原型如下:

  1. $db['default'] = array(
  2.     'dsn'   => '',
  3.     'hostname' => 'localhost',
  4.     'username' => 'root',
  5.     'password' => '',
  6.     'database' => 'database_name',
  7.     'dbdriver' => 'mysqli',
  8.     'dbprefix' => '',
  9.     'pconnect' => TRUE,
  10.     'db_debug' => TRUE,
  11.     'cache_on' => FALSE,
  12.     'cachedir' => '',
  13.     'char_set' => 'utf8',
  14.     'dbcollat' => 'utf8_general_ci',
  15.     'swap_pre' => '',
  16.     'encrypt' => FALSE,
  17.     'compress' => FALSE,
  18.     'stricton' => FALSE,
  19.     'failover' => array()
  20. );

有些数据库驱动（例如：PDO，PostgreSQL，Oracle，ODBC）可能需要提供完整的 DSN 字符串。在这种情况下，你需要使用 'dsn' 配置参数，就好像使用该驱动的 PHP 原生扩展一样。例如:

  1. // PDO
  2. $db['default']['dsn'] = 'pgsql:host=localhost;port=5432;dbname=database_name';
  3.  
  4. // Oracle
  5. $db['default']['dsn'] = '//localhost/XE';

注解

如果你没有为需要 DSN 参数的驱动指定 DSN 字符串，CodeIgniter 将使用你提供的其他配置信息自动生成它。

注解

如果你提供了一个 DSN 字符串，但是缺少了某些配置（例如：数据库的字符集），如果该配置存在在其他的配置项中，CodeIgniter 将自动在 DSN 上附加上该配置。

当主数据库由于某些原因无法连接时，你还可以配置故障转移（failover）。可以像下面这样为一个连接配置故障转移:

  1. $db['default']['failover'] = array(
  2.         array(
  3.             'hostname' => 'localhost1',
  4.             'username' => '',
  5.             'password' => '',
  6.             'database' => '',
  7.             'dbdriver' => 'mysqli',
  8.             'dbprefix' => '',
  9.             'pconnect' => TRUE,
  10.             'db_debug' => TRUE,
  11.             'cache_on' => FALSE,
  12.             'cachedir' => '',
  13.             'char_set' => 'utf8',
  14.             'dbcollat' => 'utf8_general_ci',
  15.             'swap_pre' => '',
  16.             'encrypt' => FALSE,
  17.             'compress' => FALSE,
  18.             'stricton' => FALSE
  19.         ),
  20.         array(
  21.             'hostname' => 'localhost2',
  22.             'username' => '',
  23.             'password' => '',
  24.             'database' => '',
  25.             'dbdriver' => 'mysqli',
  26.             'dbprefix' => '',
  27.             'pconnect' => TRUE,
  28.             'db_debug' => TRUE,
  29.             'cache_on' => FALSE,
  30.             'cachedir' => '',
  31.             'char_set' => 'utf8',
  32.             'dbcollat' => 'utf8_general_ci',
  33.             'swap_pre' => '',
  34.             'encrypt' => FALSE,
  35.             'compress' => FALSE,
  36.             'stricton' => FALSE
  37.         )
  38.     );

你可以指定任意多个故障转移。

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

  1. $db['test'] = array(
  2.     'dsn'   => '',
  3.     'hostname' => 'localhost',
  4.     'username' => 'root',
  5.     'password' => '',
  6.     'database' => 'database_name',
  7.     'dbdriver' => 'mysqli',
  8.     'dbprefix' => '',
  9.     'pconnect' => TRUE,
  10.     'db_debug' => TRUE,
  11.     'cache_on' => FALSE,
  12.     'cachedir' => '',
  13.     'char_set' => 'utf8',
  14.     'dbcollat' => 'utf8_general_ci',
  15.     'swap_pre' => '',
  16.     'compress' => FALSE,
  17.     'encrypt' => FALSE,
  18.     'stricton' => FALSE,
  19.     'failover' => array()
  20. );

然后，设置位于配置文件中的 $active_group 变量，告诉系统要使用“test”组:

  1. $active_group = 'test';

注解

分组的名称“test”是任意的，你可以取任意的名字。默认情况下，主连接使用“default”这个名称。当然，您可以基于您的项目为它起一个更有意义的名字。

查询构造器

可以通过数据库配置文件里的 $querybuilder 变量对 [查询构造器类_]($7efe791ffc020ea9.md) 进行全局的设定（启用设成 TRUE，禁用设成 FALSE，默认是 TRUE）。如果你不用这个类，那么你可以通过将这个变量值设置成 FALSE 来减少在数据库类初始化时对电脑资源的消耗。

  1. $query_builder = TRUE;

注解

一些 CodeIgniter 的类，例如 Sessions，在执行一些函数的时候需要查询构造器的支持。

参数解释：

配置名描述
dsnDSN 连接字符串（该字符串包含了所有的数据库配置信息）
hostname数据库的主机名，通常位于本机，可以表示为 "localhost"
username需要连接到数据库的用户名
password登录数据库的密码
database你需要连接的数据库名
dbdriver数据库类型。如：mysql、postgres、odbc 等。必须为小写字母。
dbprefix当使用 查询构造器 查询时，可以选择性的为表加个前缀，它允许在一个数据库上安装多个 CodeIgniter 程序。
pconnectTRUE/FALSE (boolean) - 是否使用持续连接
db_debugTRUE/FALSE (boolean) - 是否显示数据库错误信息
cache_onTRUE/FALSE (boolean) - 是否开启数据库查询缓存，详情请见 数据库缓存类。
cachedir数据库查询缓存目录所在的服务器绝对路径
char_set与数据库通信时所使用的字符集
dbcollat与数据库通信时所使用的字符规则注解只使用于 'mysql' 和 'mysqli' 数据库驱动
swap_pre替换默认的 dbprefix 表前缀，该项设置对于分布式应用是非常有用的，你可以在查询中使用由最终用户定制的表前缀。
schema数据库模式，默认为 'public'，用于 PostgreSQL 和 ODBC 驱动
encrypt是否使用加密连接。- 'mysql' (deprecated), 'sqlsrv' and 'pdo/sqlsrv' drivers accept TRUE/FALSE- 'mysqli' and 'pdo/mysql' drivers accept an array with the following options:- 'sslkey' - Path to the private key file- 'ssl_cert' - Path to the public key certificate file- 'ssl_ca' - Path to the certificate authority file- 'ssl_capath' - Path to a directory containing trusted CA certificats in PEM format- 'ssl_cipher' - List of _allowed ciphers to be used for the encryption, separated by colons (':')- 'ssl_verify' - TRUE/FALSE; Whether to verify the server certificate or not ('mysqli' only)
compressTRUE/FALSE (boolean) - 是否使用客户端压缩协议（只用于MySQL）
strictonTRUE/FALSE (boolean) - 是否强制使用 "Strict Mode" 连接,在开发程序时，使用 strict SQL 是一个好习惯。
port数据库端口号，要使用这个值，你应该添加一行代码到数据库配置数组。
  1. $db['default']['port'] = 5432;

注解

根据你使用的数据库平台（MySQL, PostgreSQL 等），并不是所有的参数都是必须的。例如，当你使用 SQLite 时，你无需指定用户名和密码，数据库名称直接是你的数据库文件的路径。以上内容假设你使用的是 MySQL 数据库。