(mongodb >=1.0.0)
MongoDB\Driver\BulkWrite::delete — 新增刪除操作到批次處理
將刪除操作添加到 MongoDB\Driver\BulkWrite。
filter (陣列|物件)» 查詢謂詞。空的謂詞將匹配集合中的所有文件。
注意：在評估查詢條件時，MongoDB 會根據其自身的 » BSON 類型比較規則 比較類型和值，這與 PHP 的 比較 和 類型轉換 規則不同。當匹配特殊的 BSON 類型時，查詢條件應使用相應的 BSON 類別（例如，使用 MongoDB\BSON\ObjectId 來匹配 » ObjectId）。
deleteOptions
| 選項 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| collation | 陣列|物件 |
» 排序規則 允許使用者指定字符串比較的語言特定規則，例如字母大小寫和重音符號的規則。指定排序規則時， 如果未指定排序規則但集合具有預設排序規則，則操作使用為集合指定的排序規則。如果未為集合或操作指定排序規則，則 MongoDB 使用先前版本中用於字符串比較的簡單二進制比較。 此選項在 MongoDB 3.4+ 中可用，如果為較舊的伺服器版本指定，則會在執行時導致異常。 |
|
| hint | 字串|陣列|物件 |
索引規範。指定索引名稱為字符串或索引鍵模式。如果指定，則查詢系統將只考慮使用提示索引的計劃。 此選項在 MongoDB 4.4+ 中可用，如果為較舊的伺服器版本指定，則會在執行時導致異常。 |
|
| limit | 布林值 | 刪除所有匹配的文件 (false)，或只刪除第一個匹配的文件 (true) |
false |
無返回值。
| 版本 | 說明 |
|---|---|
| PECL mongodb 1.8.0 | 新增了 "hint" 選項。 |
| PECL mongodb 1.2.0 | 新增了 "collation" 選項。 |
範例 #1 MongoDB\Driver\BulkWrite::delete() 範例
<?php
$bulk = new MongoDB\Driver\BulkWrite;
$bulk->delete(['x' => 1], ['limit' => 1]);
$bulk->delete(['x' => 2], ['limit' => 0]);
$manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1:27017');
$result = $manager->executeBulkWrite('db.collection', $bulk);
?>