Meedoo 是一个轻量级、高性能、面向对象的 PHP 数据库操作封装库。它的核心目标是简化数据库交互（主要针对 MySQL/MariaDB，但也支持其他适配了 PDO 的数据库），让开发者能够用更少的代码、更直观的方式执行高效的 SQL 操作，同时注重安全性和链式调用的便捷性。
它与类似Doctrine重量级 ORM不同，更接近数据库操作小助手，提供流畅的接口，让你能以几乎像写 SQL 一样自然的方式构建查询，同时又免除了手动拼接 SQL 字符串的繁琐和潜在的安全风险。
Meedoo 的核心特点：
- 极度轻量： 库本身非常小巧，只有一个核心文件，引入简单，对项目负担极小。
- 链式调用（Fluent Interface）： 这是 Meedoo 最突出的特点。你可以像链条一样将各个查询条件（SELECT, WHERE, JOIN, ORDER BY, LIMIT 等）连贯地写在一起，代码可读性非常高。
- 面向对象操作： 查询结果默认以对象（
stdClass实例）的形式返回，可以直接使用->操作符访问字段。 - SQL 注入防护： 通过参数绑定机制（使用
?占位符或命名占位符）自动处理输入数据，有效防止 SQL 注入攻击。 - 语法简洁接近 SQL： 方法命名尽量贴近 SQL 关键字（如
where,join,order,limit），学习曲线平缓。 - 支持事务： 提供简单的
beginTransaction(),commit(),rollBack()方法。 - 兼容 PDO： 底层基于 PHP 的 PDO 扩展，兼容支持 PDO 的各种数据库，配置连接方式也与 PDO 一致。
Meedoo 的基本用法：
1. 安装与引入
访问Meedoo官网将 Meedoo.php 文件下载到你的项目中，然后在需要使用数据库的脚本开头引入它：
require_once 'path/to/Meedoo.php'; // PHP>=5.4 PDO拓展2. 连接数据库
使用 Meedoo 构造方法创建连接实例：
// 使用 PDO DSN 字符串方式
$db = new Meedoo('mysql:host=localhost;dbname=your_database;charset=utf8mb4', 'username', 'password');
// 或者使用数组配置方式（更常用）
$db = new Meedoo([
'dsn' => 'mysql:host=localhost;dbname=your_database;charset=utf8mb4',
'username' => 'username',
'password' => 'password',
'option' => [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // 设置错误模式为抛出异常
]
]);3. 执行基础 CRUD 操作 (链式调用示例)
查询单条记录 (
get)$user = $db->from('users') // 指定表名 ->where('id = ?', 10) // 条件，自动绑定参数 10 ->get(); // 执行查询并获取单条结果（对象） if ($user) { echo $user->name; // 访问字段 }查询多条记录 (
select)$activeUsers = $db->from('users') ->where('status = ?', 'active') ->order('id DESC') ->limit(10) // 限定 10 条 ->select(); // 执行查询并获取所有结果（对象数组） foreach ($activeUsers as $user) { echo $user->email . "\n"; }插入记录 (
insert)$insertId = $db->from('users') ->insert([ 'name' => 'John Doe', 'email' => 'john@example.com', 'created_at' => date('Y-m-d H:i:s') ]); // 返回最后插入的自增ID更新记录 (
update)$rowsAffected = $db->from('users') ->where('id = ?', 25) ->update([ 'name' => 'Jane Doe Updated', 'status' => 'inactive' ]); // 返回受影响的行数删除记录 (
delete)$rowsAffected = $db->from('users') ->where('status = ?', 'banned') ->andWhere('last_login < ?', '2023-01-01') ->delete(); // 返回受影响的行数
4. 更复杂的查询
JOIN
$posts = $db->from('posts p') ->leftJoin('users u', 'u.id = p.author_id') ->select('p.*, u.name as author_name');聚合函数
$count = $db->from('orders') ->where('customer_id = ?', 42) ->count('id'); // COUNT(id) // 或 $totalPrice = $db->from('orders') ->where('customer_id = ?', 42) ->sum('total'); // SUM(total)分组 (
group)$salesByMonth = $db->from('orders') ->select('DATE_FORMAT(order_date, "%Y-%m") as month, SUM(total) as monthly_sales') ->group('month') ->order('month');原生 SQL 片段 (
expr)$db->from('products') ->where('price > ?', 100) ->andWhere(Meedoo::expr('name LIKE ? OR description LIKE ?', ['%phone%', '%phone%'])) ->select();
5. 事务处理
try {
$db->beginTransaction();
$db->from('account1')->update(['balance' => 'balance - ?', 100]);
$db->from('account2')->update(['balance' => 'balance + ?', 100]);
$db->commit(); // 提交事务
echo "Transaction successful!";
} catch (Exception $e) {
$db->rollBack(); // 回滚事务
echo "Transaction failed: " . $e->getMessage();
}更多用法访问官方中文文档
优势和适用场景：
- 小型项目或微服务： 不需要庞大 ORM 的复杂功能。
- API 开发： 快速构建数据访问层，代码简洁清晰。
- 原型开发与脚本： 快速搭建数据库交互逻辑。
- 性能敏感场景： 相比重量级 ORM，通常有更低的开销（虽然在小查询上差异不大）。
- 希望用接近 SQL 的直观方式操作数据库： 对熟悉 SQL 的开发人员非常友好。
与 ORM 的主要区别：
- 模型关系映射： Meedoo 没有复杂的对象关系映射（如自动加载关联对象）。
- 迁移和 Schema 管理： 通常不包括数据库迁移工具。
- 数据模型： 不需要定义复杂的 Model 类。
- 复杂查询生成： 虽然支持复杂查询，但对于极端复杂的嵌套查询，可能不如某些 ORM 的查询构造器直观或强大，或者需要更依赖
Meedoo::expr。
总结：
Meedoo 是一个简洁高效的 PHP 数据库操作工具库。它通过优雅的链式调用 API 屏蔽了直接使用 PDO 的复杂性，极大地提高了编写 SQL 查询代码的效率和可读性，同时确保了安全性（参数绑定）。如果你正在寻找一个轻量级的解决方案来简化 MySQL 或其他 PDO 支持的数据库操作，而不想引入庞大的 ORM 框架，Meedoo 是一个非常值得考虑的选项。