连接数据库 · 文档规范示例

# 连接数据库 [上一页](# "上一页")[下一页](# "下一页") ThinkPHP内置了抽象数据库访问层，把不同的数据库操作封装起来，我们只需要使用公共的Db类进行操作，而无需针对不同的数据库写不同的代码和底层实现，Db类会自动调用相应的数据库驱动来处理。目前的数据库包括Mysql、SqlServer、PgSQL、Sqlite、Oracle、Ibase、Mongo，也包括对PDO的支持。如果应用需要使用数据库，必须配置数据库连接信息，数据库的配置文件有多种定义方式。 ### 一、全局配置定义常用的配置方式是在应用配置文件或者模块配置文件中添加下面的配置参数： ~~~ //数据库配置信息 'DB_TYPE' => 'mysql', // 数据库类型 'DB_HOST' => 'localhost', // 服务器地址 'DB_NAME' => 'thinkphp', // 数据库名 'DB_USER' => 'root', // 用户名 'DB_PWD' => '123456', // 密码 'DB_PORT' => 3306, // 端口 'DB_PREFIX' => 'think_', // 数据库表前缀 'DB_CHARSET'=> 'utf8', // 字符集 ~~~ 数据库的类型由**DB_TYPE**参数设置。下面是目前支持的数据库设置： | DB_TYPE设置 | 支持的数据库类型 | |-----|-----| | mysql或mysqli | mysql | | pgsql | pgsql | | sqlite | sqlite | | mssql 或sqlsrv | sqlserver | | oracle | oracle | | ibase | ibase | | mongo | mongo | | PDO | PDO支持的所有数据库 | > 如果**DB_TYPE**使用`PDO`类型的话，数据库类型则由**DB_DSN**配置决定。或者采用如下配置 ~~~ 'DB_DSN' => 'mysql://root:123456@localhost:3306/thinkphp#utf8' ~~~ 使用DB_DSN方式定义可以简化配置参数，DSN参数格式为： ##### 数据库类型://用户名:密码@数据库地址:数据库端口/数据库名#字符集 > 字符集设置需要3.2.1版本以上有效，字符集如果没有设置的话，默认为utf8。如果两种配置参数同时存在的话，`DB_DSN`配置参数优先。 > 注意：如果要设置分布式数据库，暂时不支持DB_DSN方式配置。如果采用PDO驱动的话，则必须首先配置**DB_TYPE **为`pdo`，然后还需要单独配置其他参数，例如： ~~~ //PDO连接方式 'DB_TYPE' => 'pdo', // 数据库类型 'DB_USER' => 'root', // 用户名 'DB_PWD' => '', // 密码 'DB_PREFIX' => 'think_', // 数据库表前缀 'DB_DSN' => 'mysql:host=localhost;dbname=thinkphp;charset=UTF-8' ~~~ > 注意：PDO方式的DB_DSN配置格式有所区别，根据不同的数据库类型设置有所不同，具体可以参考PHP手册。配置文件定义的数据库连接信息一般是系统默认采用的，因为一般一个应用的数据库访问配置是相同的。该方法系统在连接数据库的时候会自动获取，无需手动连接。可以对每个模块定义不同的数据库连接信息，如果开启了调试模式的话，还可以在不同的应用状态的配置文件里面定义独立的数据库配置信息。 ### 二、模型类定义如果在某个模型类里面定义了`connection`属性的话，则实例化该自定义模型的时候会采用定义的数据库连接信息，而不是配置文件中设置的默认连接信息，通常用于某些数据表位于当前数据库连接之外的其它数据库，例如： ~~~ //在模型里单独设置数据库连接信息 namespace Home\Model; use Think\Model; class UserModel extends Model{ protected $connection = array( 'db_type' => 'mysql', 'db_user' => 'root', 'db_pwd' => '1234', 'db_host' => 'localhost', 'db_port' => '3306', 'db_name' => 'thinkphp', 'db_charset' => 'utf8', ); } ~~~ 也可以采用DSN方式定义，例如： ~~~ //在模型里单独设置数据库连接信息 namespace Home\Model; use Think\Model; class UserModel extends Model{ //或者使用DSN定义 protected $connection = 'mysql://root:1234@localhost:3306/thinkphp#utf8'; } ~~~ 如果我们已经在配置文件中配置了额外的数据库连接信息，例如： ~~~ //数据库配置1 'DB_CONFIG1' => array( 'db_type' => 'mysql', 'db_user' => 'root', 'db_pwd' => '1234', 'db_host' => 'localhost', 'db_port' => '3306', 'db_name' => 'thinkphp', 'db_charset'=> 'utf8', ), //数据库配置2 'DB_CONFIG2' => 'mysql://root:1234@localhost:3306/thinkphp#utf8'; ~~~ 那么，我们可以把模型类的属性定义改为： ~~~ //在模型里单独设置数据库连接信息 namespace Home\Model; use Think\Model; class UserModel extends Model{ //调用配置文件中的数据库配置1 protected $connection = 'DB_CONFIG1'; } ~~~ ~~~ //在模型里单独设置数据库连接信息 namespace Home\Model; use Think\Model; class InfoModel extends Model{ //调用配置文件中的数据库配置1 protected $connection = 'DB_CONFIG2'; } ~~~ ### 三、实例化定义除了在模型定义的时候指定数据库连接信息外，我们还可以在实例化的时候指定数据库连接信息，例如：如果采用的是M方法实例化模型的话，也可以支持传入不同的数据库连接信息，例如： ~~~ $User = M('User','other_','mysql://root:1234@localhost/demo#utf8'); ~~~ 表示实例化User模型，连接的是demo数据库的other_user表，采用的连接信息是第三个参数配置的。如果我们在项目配置文件中已经配置了`DB_CONFIG2`的话，也可以采用： ~~~ $User = M('User','other_','DB_CONFIG2'); ~~~ > 需要注意的是，ThinkPHP的数据库连接的惰性的，所以并不是在实例化的时候就连接数据库，而是在有实际的数据操作的时候才会去连接数据库（额外的情况是，在系统第一次实例化模型的时候，会自动连接数据库获取相关模型类对应的数据表的字段信息）。 [上一页](# "上一页")[下一页](# "下一页")