php连mongodb需确保mongodb扩展正确加载、composer包选对（tp8用topthink/think-mongo）、database.php中type必须为'mongo'，三者缺一不可。
PHP 连 MongoDB 不是改个 host 和 port 就能通——底层扩展没装对、驱动包选错、配置字段写错，三者任一出问题，Class 'MongoDB\Client' not found 或 Class 'think\mongo\Connection' not found 就直接报给你看。
确认 mongodb 扩展已正确加载
这是所有后续操作的前提。TP8、原生 PHP、Laravel 用 MongoDB 都绕不开它。
- 运行
php -m | grep mongodb，有输出才表示扩展已加载；没有就别往下走 - Windows 用户必须核对三件事：
PHP Version（如 8.2）、Thread Safety（enabled对应ts，disabled对应nts）、Compiler（MSVC15是 PHP 8 系列标配） - Linux/macOS 推荐用
pecl install mongodb，装完检查php.ini是否有extension=mongodb.so，且路径正确 - 改完
php.ini必须重启 PHP-FPM 或 Apache/Nginx，否则phpinfo()里也看不到
composer require 的包不能选错
不是所有叫 “mongodb” 的包都能用，尤其在 ThinkPHP 8 场景下。
- TP8 必须用
composer require topthink/think-mongo，不是mongodb/mongodb - 误装
mongodb/mongodb会导致模型找不到\think\mongo\Connection，报Class not found - 装完检查
vendor/topthink/think-mongo/src/Connection.php是否存在，这是 TP8 能识别的驱动入口 - 原生 PHP 项目（非框架）可直接用
mongodb/mongodb，但前提是mongodb扩展已就位
database.php 中 type 字段必须为 'mongo'
TP8 的数据库连接工厂靠这个字段决定实例化哪个类，写错就等于没配。
-
'type' => 'mongo'是唯一有效的值，写成'type' => '\MongoDB\Client'或'type' => 'mongodb'（小写带 s）都会跳过驱动层 - hostname、hostport、database、username、password 这些字段名是
topthink/think-mongo约定的，不能套用原生 Client 的参数名（如uri） - options 数组里的键要小写，比如
'connectTimeoutMS'有效，'connecttimeoutms'会被忽略 - 不要在模型里手动 new
MongoDB\Client再赋给属性——这样绕过了 TP8 的查询构造器，where()、save()全部失效
连接字符串和选项容易漏掉关键项
原生使用 MongoDB\Client 时，URI 和选项配合不对，超时、重试、读偏好全白搭。
- 基础 URI 格式：
mongodb://[username:password@]host1[:port1][,host2[:port2],...][/defaultauthdb][?options] - 如果用了副本集，必须加
replicaSet=rs0参数，否则连不上 secondary 节点 - 生产环境至少设三个超时：
connectTimeoutMS（建连上限）、socketTimeoutMS（单次操作上限）、serverSelectionTimeoutMS（选节点上限） -
readPreference设为'secondaryPreferred'可分担读压力，但要注意数据延迟；设为'primary'才能保证强一致性
最常被跳过的其实是扩展加载验证这一步——很多人看到 composer install 成功就以为万事大吉，结果卡在 Class 'MongoDB\Client' not found 上两小时。先跑通 php -m，再动代码，省掉八成排查时间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
