基於 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 惰性迭代。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 實例,避免重複建立連線池。