# MySQL 数据库(旧版组件)

注意

此 MySQL 组件为旧版 MySQL 查询器组件,为了统一和提升对未来独立组件的兼容性,现转变为使用 doctrine/dbaldoctrine/orm 库来实现查询器,请转到 MySQL 查询器

# 配置

炸毛框架的数据库组件支持原生 SQL、查询构造器,去掉了复杂的对象模型关联,同时默认为数据库连接池,使开发变得简单。

数据库的配置位于 config/global.php 文件的 sql_config 段。

数据库操作的唯一核心工具类和功能类为 \ZM\DB\DB,使用前需要配置 host 和 use 此类。

# 查询构造器

在 炸毛框架 中,数据库查询构造器为创建和执行数据库查询提供了一个方便的接口,它可用于执行应用程序中大部分数据库操作。同时,查询构造器使用 prepare 预处理来保护程序免受 SQL 注入攻击,因此没有必要转义任何传入的字符串。

# 新增数据

DB::table("admin")->insert(['admin_name', 'admin_password'])->save();
// INSERT INTO admin VALUES ('admin_name', 'admin_password')
1
2

其中 insert 的参数是插入条目的数据列表。假设 admin 表有 namepassword 两列。

自增 ID 插入 0 即可。

# 删除数据

DB::table("admin")->delete()->where("name", "admin_name")->save();
// DELETE FROM admin WHERE name = 'admin_name'
1
2

其中 where 语句的第一个参数为列名,当只有两个参数时,第二个参数为值,效果等同于 SQL 语句:WHERE name = 'admin_name',当含有第三个参数且第二个参数为 =!=LIKE 的时候,效果就是 WHERE 第一个参数 第二个参数的操作符 第三个参数

# 更新数据

DB::table("admin")->update(["name" => "fake_admin"])->where("name", "admin_name")->save();
// UPDATE admin SET name = 'fake_admin' WHERE name = 'admin_name'
1
2

update() 方法中是要 SET 的内容的键值对,例如上面把 name 列的值改为 fake_admin

# 查询数据

$r = DB::table("admin")->select(["name"])->where("name", "fake_admin")->fetchFirst();
// SELECT name FROM admin WHERE name = 'fake_admin'
echo $r["name"];
echo DB::table("admin")->where("name", "fake_admin")->value("name");
// SELECT * FROM admin WHERE name = 'fake_admin'
1
2
3
4
5

select() 方法的参数是要查询的列,默认留空为 ["*"],也就是所有列都获取,也可以在 table 后直接 where 查询。

其中 fetchFirst() 获取第一行数据。

如果只需获取一行中的一个字段值,也可以通过上面所示的 value() 方法直接获取。

多列数据获取需要使用 fetchAll()

$r = DB::table("admin")->select()->fetchAll();
// SELECT * FROM admin WHERE 1
foreach($r as $k => $v) {
    echo $v["name"].PHP_EOL;
}
1
2
3
4
5

# 查询条数

DB::table("admin")->where("name", "fake_admin")->count();
//SELECT count(*) FROM admin WHERE name = 'fake_admin'
1
2

# 直接执行 SQL

在查询器外执行的 SQL 语句都不会被缓存,都是一定会请求数据库的。

# DB::rawQuery()

  • 用途:直接执行模板查询的裸 SQL 语句。
  • 参数:$line$params
  • 返回:查到的行的数组

$line 为请求的 SQL 语句,$params 为模板参数。

$r = DB::rawQuery("SELECT * FROM admin WHERE name = ?", ["fake_admin"]);
//SELECT * FROM admin WHERE name = 'fake_admin'
echo $r[0]["password"];
1
2
3

参数查询已经从根本上杜绝了 SQL 注入的问题。