前面兩篇把 PHP 的 MongoDB 擴充裝好之後,總算可以動手寫點真東西了。這篇把日常最常用到的操作一次跑過:建連線、選库、選集合,然後 insert / update / remove / find,最後補上 in 查詢與 group 分組這兩個稍微進階但很實用的題目。
try {
$mongo = new Mongo("mongodb://username:password@127.0.0.1:27017/db1");
} catch (MongoConnectionException $e) {
print $e->getMessage();
exit;
}
連線字串裡可以帶帳號密碼與預設資料庫。強烈建議用 try/catch 包住——MongoDB 沒起來、port 被防火牆擋住、帳密錯誤,都會在 new 的當下丟物件,不接就會是個 500。
$db = $mongo->blog; // 選擇 blog 資料庫 $collection = $db->users; // 選擇 users 集合 $conn->close(); // 關閉連線
這裡有個容易誤會的點:$mongo->blog 這種「用屬性存取」的語法只是魔法方法包裝,真正的連線要到第一次下查詢時才發生。所以就算 blog 這個庫還不存在也不會報錯。
$user = array('name' => 'caleng', 'city' => 'beijing');
$collection->insert($user);
注意 insert 是「by reference」的:成功之後,$user 本身會被補上一個 _id 欄位,你可以直接拿它當新文件的主鍵使用。
$newdata = array('$set' => array("city" => "shanghai"));
$collection->update(array("name" => "caleng"), $newdata);
$set 一定要寫。少了它,MongoDB 會把整個符合條件的文件「取代」成你傳的內容,其他欄位全部消失——這是新手最常犯的資料意外。
$collection->remove(array('name' => 'caleng'), array("justOne" => true));
第二個參數的 justOne 決定只刪一筆還是全刪。預設是 false(全刪),條件又寫得太空的時候後果請自行想像。
$result = $collection->findOne(array("name" => "caleng"));
// 找出建立時間大於某個時間戳的資料
$start = 1;
$condition = array("ctime" => array('$gt' => 1337184000));
$list_data = $this->game_handle->find($condition);
$total = $this->game_handle->count($condition);
$list_data->limit($count); // 取幾筆
$list_data->skip($start); // 跳過幾筆
var_dump($list_data);
$gt、$lt、$gte、$ne 這些運算子寫在欄位對應的陣列裡,語感跟 SQL 差異不小,但習慣之後表達能力其實更強。分頁則靠 skip + limit 組合,只是資料量一大,深分頁(skip 很大)效能會明顯下滑,那時該換成「以排序欄位做游標」的寫法。
$cursor = $collection->find(array(
'name' => array('$in' => array('Joe', 'Wendy'))
));
等同 SQL 的 WHERE name IN ('Joe','Wendy')。相對應的還有 $nin、$all、$exists,組合起來幾乎能覆蓋所有常見條件。
$collection->insert(array("category" => "fruit", "name" => "apple"));
$collection->insert(array("category" => "fruit", "name" => "peach"));
$collection->insert(array("category" => "fruit", "name" => "banana"));
$collection->insert(array("category" => "veggie", "name" => "corn"));
$collection->insert(array("category" => "veggie", "name" => "broccoli"));
$keys = array("category" => 1);
$initial = array("items" => array());
$reduce = "function (obj, prev) { prev.items.push(obj.name); }";
$g = $collection->group($keys, $initial, $reduce);
echo json_encode($g['retval']);
輸出:
[{"category":"fruit","items":["apple","peach","banana"]},
{"category":"veggie","items":["corn","broccoli"]}]
可以看到結果是個二維結構,還原成 PHP 陣列就是:
array(
0 => array("category" => "fruit", "items" => array("apple","peach","banana")),
1 => array("category" => "veggie", "items" => array("corn","broccoli"))
)
$initial 是每組的起始累加值,$reduce 是收到每一筆時怎麼合併,兩者搭配就能做出 group by + 聚合的效果。
上面示範的是舊版 mongo 擴充(Mongo 類別)的寫法,在 PHP 5.x 時代很常見。目前官方維護的是 mongodb/mongodb 這套 composer 套件,類別改成 MongoDB\Client,group 也已由 aggregate 的 $group 階段取代,findOne 回傳的是物件而非陣列。觀念完全相通,但如果是新專案,請直接查 PHP 手冊上的 MongoDB 章節選用新版 API,別照抄這裡的類別名稱。觀念懂了,換 API 只是查文件的事。