连接数据库


MiniFramework 目前只支持 MySQL 数据库,有手动和自动两种连接方式。

手动连接(工厂模式)

  1. // 如果未在页面顶部用 use 引入 Db,按照下面的写法,在 Db 前加上 \Mini\Db\
  2. $db = \Mini\Db\Db::factory ('Mysql',
  3. array (
  4. 'host' => 'localhost', // 主机地址
  5. 'port' => 3306, // 端口
  6. 'dbname' => 'mydbname', // 库名
  7. 'username' => 'myuser', // 用户名
  8. 'passwd' => '123456', // 密码
  9. 'charset' => 'utf8', // 字符编码
  10. 'persistent' => false // 是否启用持久连接 ( true | false )
  11. )
  12. );
  13. // 还可以通过 Config 中的 load() 方法先读取数据库配置,再创建对象
  14. $dbConfig = \Mini\Base\Config::getInstance()->load('database');
  15. $db2 = Db::factory ('Mysql', $dbConfig['default']);

提示:Config::getInstance()->load('database') 这个方法还可以传入 database:default 来直接获取 default 中的数据(从 1.0.0 版开始支持)

直接调用 MySQL 类

  1. use Mini\Base\Config;
  2. use Mini\Db\Mysql; // 引入 MySQL 类
  3. $dbParams = Config::getInstance()->load('database:default');
  4. $db = new Mysql($dbParams);
  1. MiniFramework 2.0 开始支持直接调用 MySQL 类,这样做的好处是便于让 IDE 对类的方法进行提示,为开发者编码提供便利。

自动连接方法

MiniFramework 自动连接数据库功能默认是关闭的,如需使用,请在你的应用入口文件 Public/index.php 中定义常量 DB_AUTO_CONNECT 的值为 true,来开启这个功能,例如:

  1. define('DB_AUTO_CONNECT', true);

同时,还需要在 Config/database.php 中对数据库连接进行配置,例如:

  1. $database['default'] = array (
  2. 'host' => 'localhost', // 主机地址
  3. 'port' => 3306, // 端口
  4. 'dbname' => 'test', // 库名
  5. 'username' => 'root', // 用户名
  6. 'passwd' => '', // 密码
  7. 'charset' => 'utf8', // 字符编码
  8. 'persistent' => false // 是否启用持久连接 ( true | false )
  9. );

接下来,就可以在模型中通过 $this->loadDb() 方法直接加载数据库对象了,例如:

  1. namespace App\Model;
  2. use Mini\Base\Model;
  3. class Info extends Model // 自动连接数据库,必须继承核心类 Model
  4. {
  5. public function getInfo()
  6. {
  7. // 加载 key 为 default 的数据库
  8. $db = $this->loadDb('default');
  9. // do something...
  10. }
  11. }

提示:MiniFramework 的数据库自动连接功能,采用的是惰性连接机制,只会在下达了执行 SQL 语句命令时,才真正开始与数据库通讯建立连接,因此,你不必为开启自动连接功能而担心应用的性能问题。

连贯操作查询数据

MiniFramwork 从 1.2.0 版本开始,支持在 Model 模型类中,通过“连贯操作”方式查询数据,例如:

  1. namespace App\Model;
  2. use Mini\Base\Model;
  3. class User extends Model // 继承 Model 模型类
  4. {
  5. public function getUser()
  6. {
  7. // 设置当前使用的数据库(这里的 default 是数据库连接对象的名称)
  8. $this->useDb('default');
  9. // 连贯操作方式查询 id=1 的记录
  10. $res = $this->where('id=1')->select();
  11. // 输出查询结果
  12. dump($res);
  13. }
  14. }