Composer安装Medoo失败是因为包名错误且未指定兼容版本，正确命令是composer require catfan/medoo:^1.7；其初始化需小写database_type、显式charset、用127.0.0.1替代localhost；WHERE条件须用关联数组，返回值需手动校验，错误需调用error()获取。
Composer 安装 Medoo 时为什么 composer require 报错或装不上？
Medoo 不是官方 Packagist 上的主流库，它的包名是 catfan/medoo，但自 v2 起已停止维护，v1.7.x 是最后一个稳定版。直接运行 composer require medoo/medoo 会失败——因为这个命名空间根本不存在。
正确命令是：
composer require catfan/medoo:^1.7
注意两点：
- 必须用 catfan/medoo，不是 medoo/medoo
- 显式指定 ^1.7，否则 Composer 可能尝试安装不兼容的 dev 分支或报版本冲突
Medoo 初始化连接 MySQL 时常见连接失败原因
初始化 Medoo 实例后查不到数据或报 SQLSTATE[HY000] [1045] Access denied，往往不是密码错，而是配置细节没对齐：
-
database_type必须小写，写成MySQL或mysqli都会静默失败（实际只认mysql） -
charset建议显式设为utf8mb4，否则中文插入可能乱码或截断 - 如果用 localhost，部分环境（如 Docker）会走 socket 连接，改用
127.0.0.1更可靠
示例配置：
$database = new Medoo([
'database_type' => 'mysql',
'database_name' => 'test_db',
'server' => '127.0.0.1',
'username' => 'root',
'password' => '123456',
'charset' => 'utf8mb4'
]);
CRUD 操作中 WHERE 条件写法容易踩的坑
Medoo 的 select()、update()、delete() 都依赖数组形式的 WHERE，但结构稍有偏差就查不到或删错：
- 单条件：直接写
['id' => 123]—— 这是等值匹配，没问题 - 多条件 AND：必须用关联数组，
['status' => 'active', 'type' => 'user']，不是['AND' => [...]] - 范围查询：要用
['>=' => '2023-01-01']这种键值对，不能写成['created_at >= ?' => '2023-01-01']（那是 PDO 原生写法） - IN 查询：
['id' => [1,2,3]]自动转为IN (1,2,3)，但数组不能为空，否则生成无效 SQL
安全提示：所有值都会被自动参数化，但字段名（如 ORDER 中的列名）不会，动态字段需白名单校验。
Medoo 返回结果和错误处理怎么拿才稳？
Medoo 默认出错不抛异常，select() 查不到返回空数组，insert() 失败返回 false，很容易忽略失败：
- 执行写操作后，务必检查返回值：
if ($database->insert('users', $data) === false) { /* 处理错误 */ } - 读操作想区分“无数据”和“查询失败”，可用
$database->error()获取最后错误，例如['HY000', 1146, "Table 'xxx.users' doesn't exist"] -
select()返回二维数组，哪怕只查一行一列，也是[['name' => 'Alice']]，别直接取$result['name']
它不支持原生 SQL 执行（如 query()），真要执行复杂语句，得绕道 $database->pdo()->query(...)，但那就脱离 Medoo 抽象层了。
Medoo 的轻量是真轻量，但也意味着你得自己兜住连接管理、事务控制、字段注入防护这些事——它不拦你，也不帮你。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
