萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP MongoDB 操作類封裝:連線管理、CRUD、索引、聚合管道

基於 mongodb PHP 擴展(MongoDB\Driver\Manager)封裝的資料存取層,支援連線池、自動重連、文檔增刪改查、索引建立、聚合管道與事務。

類別架構概覽

class MongoDB {
    private Manager $manager;
    private string $database;
    private array $options;

    public function __construct(string $dsn, string $database, array $options = []) { ... }
    private function getCollection(string $collection): Collection { ... }

    // CRUD
    public function insertOne(string $col, array $doc, array $opts = []): string { ... }
    public function insertMany(string $col, array $docs, array $opts = []): array { ... }
    public function findOne(string $col, array $filter, array $opts = []): ?array { ... }
    public function find(string $col, array $filter, array $opts = []): Cursor { ... }
    public function updateOne(string $col, array $filter, array $update, array $opts = []): UpdateResult { ... }
    public function updateMany(string $col, array $filter, array $update, array $opts = []): UpdateResult { ... }
    public function deleteOne(string $col, array $filter, array $opts = []): DeleteResult { ... }
    public function deleteMany(string $col, array $filter, array $opts = []): DeleteResult { ... }

    // 索引
    public function createIndex(string $col, array $keys, array $opts = []): string { ... }
    public function dropIndex(string $col, string $name): void { ... }

    // 聚合
    public function aggregate(string $col, array $pipeline, array $opts = []): Cursor { ... }

    // 事務 (MongoDB 4.0+ 副本集)
    public function transaction(callable $callback): mixed { ... }
}

關鍵實作細節

  • 建構子建立 Manager(內建連線池),DSN 格式:mongodb://user:pass@host1:27017,host2:27017/?replicaSet=rs0。
  • 所有寫入操作預設 writeConcern: majority,讀取可指定 readPreference。
  • find 返回 Cursor,支援 toArray()、foreach 惰性迭代。
  • 聚合管道直接傳遞 BSON 陣列,驅動層自動編碼。
  • 事務使用 Session,回呼函數拋出例外自動回滾。

使用範例

$mongo = new MongoDB('mongodb://localhost:27017', 'myapp');
$id = $mongo->insertOne('users', ['name' => 'Alice', 'email' => 'alice@example.com']);
$user = $mongo->findOne('users', ['_id' => new MongoDB\BSON\ObjectId($id)]);
$mongo->updateOne('users', ['_id' => $user['_id']], ['$set' => ['last_login' => new MongoDB\BSON\UTCDateTime()]]);

// 聚合:每日註冊用戶數
$stats = $mongo->aggregate('users', [
    ['$group' => ['_id' => ['$dateToString' => ['format' => '%Y-%m-%d', 'date' => '$created_at']], 'count' => ['$sum' => 1]]],
    ['$sort' => ['_id' => 1]]
]);
foreach ($stats as $row) { print_r($row); }

效能優化提示

  • 適當建立複合索引覆蓋高頻查詢(createIndex)。
  • 投影(projection)僅取需要欄位,減少網路傳輸。
  • 大量寫入使用 insertMany/bulkWrite 批次提交。
  • 長連線複用 Manager 實例,避免重複建立連線池。
copyright © 萬盛學電腦網 all rights reserved