PHP连不上MongoDB根本原因是扩展未安装、服务未运行或连接字符串错误；插入失败常因类型不支持或键名含特殊字符；查询为空多因条件类型不匹配或未调用toArray()；更新无效主因操作符缺失或格式错误。
PHP 连不上 MongoDB，MongoDB\Driver\Manager 报错“Failed to connect”
根本原因通常是扩展没装对、服务没起来，或连接字符串写错。PHP 8.1+ 默认不带 MongoDB 扩展，得手动装 mongodb（不是 mongo，后者已废弃多年）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
php -m | grep mongodb确认扩展已加载；没输出就先运行pecl install mongodb，再在php.ini加extension=mongodb - 检查 MongoDB 服务是否运行：
mongosh --eval "db.runCommand({ping:1})"能返回{ "ok" : 1 }才算通 - 连接字符串别漏端口，默认是
mongodb://127.0.0.1:27017；远程连接要确认防火墙放行、MongoDB 配置了bindIp（别只写127.0.0.1） - 如果用 Docker，宿主机 PHP 连容器里的 MongoDB，别用
localhost，改用host.docker.internal（Mac/Win）或宿主机真实 IP（Linux）
insertOne() 插入失败但没报错，数据却没进库
常见于文档里用了 PHP 不支持的类型，比如 DateTime 对象没转成 MongoDB\BSON\UTCDateTime，或数组键名含点号（.）、美元符（$）——MongoDB 会直接静默拒绝。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 插入前用
is_array($doc) && !empty($doc)做基础校验，避免空数组被当成合法文档 - 时间字段必须转：用
new MongoDB\BSON\UTCDateTime(strtotime('2024-01-01'))，别传date('c')字符串 - 检查键名：
array_keys($doc)里不能有.或$；有就得重命名，比如user.name→user_name - 调用后立刻检查结果：
if (!$result->getInsertedCount()) { /* 失败 */ }，别只靠无异常就认为成功
用 find() 查不到刚插的数据，toArray() 返回空数组
不是数据丢了，大概率是过滤条件写错了类型，或者集合名拼写不一致（区分大小写），又或者忘了加 toArray() 就直接当数组用了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 查之前先确认集合存在且有数据：
mongosh mydb --eval "db.my_collection.countDocuments({})" - 过滤条件里的值类型要匹配：数据库存的是
ObjectId，代码里就不能传字符串"60a1b2c3d4e5f67890123456"，得包一层new MongoDB\BSON\ObjectId("60a1b2c3d4e5f67890123456") -
find()返回的是MongoDB\Cursor对象，不是数组；必须调toArray()或遍历才能取值，直接echo $cursor[0]['name']会报错 - 如果查全部文档，过滤条件传空数组
[]，别传null或new stdClass()，后者可能被忽略
PHP 更新文档时 updateOne() 没生效，getModifiedCount() 总是 0
最常踩的坑是更新操作符用错：$set 写成 set（少 $），或把整个新文档当更新内容传进去，没包操作符。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 更新必须用标准操作符：
['$set' => ['status' => 'done']]，不能是['status' => 'done']—— 后者会删掉其他字段 - 匹配条件和更新内容要分开传：
$collection->updateOne(['_id' => $id], ['$set' => $data])，别混成一个数组 - 如果更新嵌套字段，用点号路径：
['$set' => ['profile.email' => 'a@b.com']]，确保父字段存在，否则不会自动创建 - 注意
getModifiedCount()和getMatchedCount()区别：前者只统计值真变了的文档，后者才反映“找到几个”，调试时两个都该看
真正麻烦的是 ObjectId 生成和比较——PHP 里它是个对象，不是字符串，== 判等会失效，得用 json_encode() 或 (string)$id 转成字符串再比。这点很容易被忽略，一查就卡半天。
