PHP7 - MongoDB Driver 使用心得

php7 只能使用Mongodb driver來驅動mongodb。

使用Mongodb Driver鏈接數據庫

剛開始使用Mongodb Driver的時候我是拒絕的。查看官方文檔只看到一排的類和不知所云的成員方法，翻了半天也找不到 find, update, delete等等關鍵詞，更甚至稍微複雜一點的好比副本集，用戶認證都不知道怎麼鏈接數據庫。
幸虧文檔不是徹底沒有，點開Mongodb\Driver\Manger::constructor 看到有幾個構造參數

• $uri 形如 mongo://[host:port,host:port,host:port]/[dbname]?[username=aa&password=bb&replicaSet=cc]
• $uriOptions 就是上面?後面的那一串參數，能夠寫在這裏
• $driverOptions 其餘選項好比默認的讀寫參數

MongodbDriver CURD操做

這就是是我一開始以爲這個驅動反人類的地方，文檔裏沒有任何的find,update,delete等字眼，只有一個Command類和一個Query類。
Query 類稍微好一些，提供了部分查詢選項。
實際上，對Mongo數據庫的全部操做，均可以經過Command類進行。而php的驅動文檔對具體的 commandOptions 是不作介紹的。
正由於我是mongodb萌新，因此纔會以爲這個驅動無比奇葩反人類，根本就無從下手。
咱們使用這個驅動的關鍵，是用Command類構造一個commandOption
而這個commandOption須要咱們從mongodb的官方文檔中去了解
MONGODB MANUAL - Database Commands
全部的操做，數據增刪改查，聚合排序，數據庫狀態，用戶認證等等，均可以經過這些命令搞定。下面隨便舉幾個例子

• 鏈接數據庫

$this->_conn = new MongoDB\Driver\Manager('mongodb://localhost:27017/test');
$this->_db = 'test';
// execute command.
function exec($opts) {
    $cmd = new MongoDB\Driver\Command($opts);
    $res =  $this->_conn->executeCommand($this->_db, $cmd);
    return $res->toArray();
}

• 條件查詢，按需返回

$cmd = [
    'find' => 'table', // collection表名
    'filter' => ['_id' => ['$gte' => 10, '$lt' => 20]],
    'projection' => ['name' => 1, 'email' => 1]
];
$res = $this-exec($cmd);

• 修改記錄

$cmd = [
    'update' => 'table', // collection 表名
    'updates' => [
        ['q' => [_id => ['$lt' => 10]], 'u' => ['status' => 0], 'upsert'=>0,'multi'=>1],
        ['q' => [_id => ['$gte' => 10]], 'u' => ['status' => 1], 'upsert'=>0,'multi'=>1],
    ],
    'ordered' => 1, // 是否依次執行updates語句，true表示執行失敗後繼續後面的語句，false 表示一旦失敗當即返回
]

• 刪除記錄，limit只能是1或0！

$cmd = [
    'delete' => 'table', // collection 表名
    'deletes' => [
        ['q' => [_id => ['$lt' => 5]], 'limit' => 0], // 0表示全部，1表示刪除1行
    ]
]

• 插入數據

$cmd = [
    'delete' => 'table', // collection 表名
    'deletes' => [
        ['q' => [_id => ['$lt' => 5]], 'limit' => 0], // 0表示全部，1表示刪除1行
    ]
]

• 分組，排序

$cmd = [
    'aggregate' => 'table', // collection 表名
    'pipeline' => [
        '$group' => 'class',
        '$sort' => 'score'
    ]
]

• 讀取數據庫狀態

$cmd = [
    'replSetGetStatus' => 1,
]

輔助類 BSON

最有用的固然是 MongoDB\BSON\Javascript 和 MongoDB\BSON\ObjectId ，分別是傳入 javascript 腳本函數，和使用 mongodb 的ojectid。

異常 Exception

全部MongoDBDriver 產生的異常均可以用 MongoDB\Driver\Exception\Exception 捕獲