连接数据库

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

手动连接（工厂模式）

  1. // 如果未在页面顶部用 use 引入 Db，按照下面的写法，在 Db 前加上 \Mini\Db\
  2. $db = \Mini\Db\Db::factory ('Mysql',
  3.     [
  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. );
  14. // 还可以通过 Config 中的 load() 方法先读取数据库配置，再创建对象
  15. $dbConfig = \Mini\Base\Config::getInstance()->load('database');
  16. $db2 = Db::factory ('Mysql', $dbConfig['default']);

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

直接调用 MySQL 类

MiniFramework 从 2.0 开始支持直接调用 MySQL 类，这样做的好处是便于让 IDE 对类的方法进行提示，为开发者编码提供便利。

  1. use Mini\Base\Config;
  2. use Mini\Db\Mysql; // 引入 MySQL 类
  4. $dbParams = Config::getInstance()->load('database:default');
  5. $db = new Mysql($dbParams);

自动连接方法

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

  1. define('DB_AUTO_CONNECT', true);

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

  1. $database['default'] = [
  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;
  3. use Mini\Base\Model;
  5. class Info extends Model // 自动连接数据库，必须继承核心类 Model
  6. {
  7.     public function getInfo()
  8.     {
  9.         // 加载 key 为 default 的数据库
  10.         $db = $this->loadDb('default');
  12.         // do something...
  13.     }
  14. }

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

连贯操作增/删/改/查数据

MiniFramwork 从 1.2.0 版本开始，支持在 Model 模型类中，通过“连贯操作”方式增/删/改/查数据，例如：

  1. namespace App\Model;
  3. use Mini\Base\Model;
  5. class User extends Model // 继承 Model 模型类
  6. {
  7.     public function getUser()
  8.     {
  9.         // 设置当前使用的数据库（这里的 default 是数据库连接对象的名称）
  10.         $this->useDb('default');
  12.         // 示例1：连贯操作方式向名为 user 的表中插入一条数据纪录
  13.         $data1 = array('id' => 1, 'name' => '张三');
  14.         dump($this->table('user')->data($data1)->add());
  16.         // 示例2：向 user 表中一次插入多条纪录
  17.         $data2 = array(
  18.             array('id' => 2, 'name' => '李四'),
  19.             array('id' => 3, 'name' => '王五')
  20.         );
  21.         dump($this->table('user')->data($data2)->add());
  23.         // 示例3：删除 user 表中 id 为 2 的纪录
  24.         dump($this->table('user')->where('id=2')->delete());
  26.         // 示例4：修改 user 表中 id 为 3 的记录
  27.         dump($this->table('user')->data(array('name' => '赵六'))->where('id=3')->save());
  29.         // 示例5：查询 user 表中的全部纪录
  30.         dump($this->table('user')->select());
  32.         // 示例6：查询 user 表中的全部纪录，但只返回前 2 条纪录
  33.         dump($this->table('user')->limit(2)->select());
  34.         // 上方示例6中，limit(2) 等价于 limit(0, 2)，用法与 SQL 中的 LIMIT 语法一致
  36.         // 示例7：查询 user 表中的全部纪录，按 id 字段倒序排列结果
  37.         dump($this->table('user')->order(array('id' => 'DESC'))->select());
  38.         // 上方示例7中的 order() 方法也可直接传入字符串，例如 order('id DESC')
  40.         // 示例8：查询 user 表中 id 为 1 的记录
  41.         $res = $this->table('user')->where('id=1')->select('Row');
  42.         // 上方示例8中，select() 方法传入 Row 参数时返回的结果为键值对形式的一维数组
  44.         // 输出查询结果
  45.         dump($res);
  47.         // 关于 where 方法，还支持通过参数来构造查询条件，例如下面的示例：
  49.         // 示例9：查询 id 等于 1 或 2 的记录
  50.         $res = $this->table('user')->where('id', [1, 2])->select();
  51.         // 上边的查询参数，最终会构造为 id=1 OR id=2，逻辑运算符默认为“OR”
  53.         // 示例10：查询 id 不等于 1 且 不等于 2 的记录
  54.         $res = $this->table('user')->where('id', '<>', [1, 2], 'AND')->select();
  55.         // 上边的查询参数，最终会构造为 id<>1 AND id<>2
  57.         // 关于联表查询的示例
  59.         // 示例11：INNER JOIN
  60.         $res = $this->from('user')->innerjoin('user_address', 'user.id=user_address.id')->select();
  62.         // 示例12：LEFT JOIN
  63.         $res = $this->from('user')->leftjoin('user_address', 'user.id=user_address.id')->select();
  65.         // 示例13：RIGHT JOIN
  66.         $res = $this->from('user')->rightjoin('user_address', 'user.id=user_address.id')->select();
  68.         // 示例14：统一封装的 JOIN 方法，下边的代码相当于调用 rightjoin 方法
  69.         $res = $this->from('user')->join('user_address', 'user.id=user_address.id', 'RIGHT')->select();
  70.         // join 方法的第三方参数默认值为"INNER"
  72.     }
  73. }

提示1：MiniFramework 在 2.1.0 开始支持 add、save、delete 和 data 四个连贯操作的方法，并对原有的 order、limit、group 和 select 方法进行了改进和完善。

提示2：MiniFramework 2.5.0 中针对 where 方法新增了通过参数构造查询条件的特性。

提示3：MiniFramework 2.7.0 中，新增了更符合习惯的 from 方法，与原 table 方法的用法完全一致。