$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017"); 是 PHP MongoDB 扩展中的核心类，用于管理与 MongoDB 服务端的连接，并作为执行所有数据库操作的入口点。

一、作用

1. 建立连接

   • 解析连接字符串（如 mongodb://localhost:27017），初始化到 MongoDB 服务端的连接。
   • 支持多种配置（如认证、SSL、副本集、分片集群）。

2. 执行操作

   • 作为底层驱动接口，负责发送命令（如查询、写入、聚合）到 MongoDB 服务端。
   • 管理连接池、请求路由和错误处理。

3. 资源管理

   • 维护持久连接（Persistent Connections），减少重复握手开销。
   • 自动处理节点故障转移（如副本集主节点切换）。

二、使用场景

1. 直接操作底层驱动

• 场景：需要绕过高层抽象（如 MongoDB\Client），直接执行原生命令或自定义操作。
• 示例：

  $manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
  $command = new MongoDB\Driver\Command(["ping" => 1]);
  $cursor = $manager->executeCommand("admin", $command);
  

2. 高性能需求

• 场景：优化连接复用（如高并发场景），手动管理连接池行为。
• 配置示例：

  $manager = new MongoDB\Driver\Manager(
      "mongodb://localhost:27017/?maxPoolSize=200&retryWrites=true"
  );
  

3. 复杂拓扑适配

• 场景：连接到副本集或分片集群，自动发现节点并处理负载均衡。
• 连接字符串示例：

  $manager = new MongoDB\Driver\Manager(
      "mongodb://host1:27017,host2:27017/?replicaSet=myReplicaSet"
  );
  

4. 特殊配置需求

• 场景：启用 SSL 加密、自定义认证机制（如 LDAP）。
• 配置示例：

  $manager = new MongoDB\Driver\Manager(
      "mongodb://user:password@localhost:27017/?tls=true&authMechanism=SCRAM-SHA-256"
  );
  

三、底层原理

1. 连接建立流程

1. 解析连接字符串：

   • 提取主机列表、认证信息、选项（如 maxPoolSize）。
   • 若使用 mongodb+srv://，通过 DNS SRV 记录自动发现节点。

2. 连接池初始化：

   • 每个唯一连接配置对应一个连接池（由 maxPoolSize 控制并发连接数）。
   • 长连接（Persistent Connections）在脚本结束时保留，供后续请求复用。

3. 认证与握手：

   • 通过 SCRAM-SHA-1/256 或其他机制验证用户权限。
   • 协商协议版本（如 OP_MSG 用于 MongoDB 3.6+）。

2. 请求执行机制

• 命令封装：

  • 每个操作（如 find、insert）被封装为 OP_MSG 协议包。
  • 示例：查询命令的底层结构：

    struct OP_MSG {
        int32 flags;
        cstring command_name;  // 如 "find"
        document command_args; // 如 {"find": "collection", "filter": {}}
    };
    

• 负载均衡与路由：

  • 副本集：自动将写操作路由到主节点，读操作根据 readPreference 分发。
  • 分片集群：通过 Mongos 路由定位数据分片。

3. 错误与重试

• 自动重试：
  • 对于临时错误（如网络中断、主节点选举），驱动自动重试写操作（需 retryWrites=true）。
• 异常处理：
  • 抛出 MongoDB\Driver\Exception 子类（如 ConnectionTimeoutException）。

四、与高层封装的对比

五、代码示例：底层操作

// 1. 创建 Manager 实例
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");

// 2. 插入数据
$bulk = new MongoDB\Driver\BulkWrite;
$bulk->insert(['name' => 'Alice', 'age' => 30]);
$manager->executeBulkWrite('mydb.users', $bulk);

// 3. 查询数据
$query = new MongoDB\Driver\Query(['age' => ['$gt' => 25]]);
$cursor = $manager->executeQuery('mydb.users', $query);
foreach ($cursor as $document) {
    var_dump($document);
}

// 4. 执行管理命令（如创建索引）
$command = new MongoDB\Driver\Command([
    'createIndexes' => 'users',
    'indexes' => [
        [
            'key' => ['email' => 1],
            'name' => 'email_1',
            'unique' => true
        ]
    ]
]);
$manager->executeCommand('mydb', $command);

总结

MongoDB\Driver\Manager 是 PHP 操作 MongoDB 的底层核心类，负责连接管理和协议通信。它适用于需要高性能、细粒度控制或特殊配置的场景，但日常开发更推荐使用高层封装（如 mongodb/mongodb 库）。