Добавляет операцию deleteOne

# MongoDB\Driver\BulkWriteCommand::deleteOne

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommand::deleteOne — Добавляет операцию deleteOne

### Описание

public function MongoDB\Driver\BulkWriteCommand::deleteOne(string `$namespace`, array|object `$filter`, ?array `$options` = `null`): void

Метод добавляет операцию deleteOne в объект MongoDB\Driver\BulkWriteCommand. Операция удалит из коллекции, которую определяет пространство имён `namespace`, первый документ, который соответствует фильтру `filter`.

### Список параметров

`namespace` (string)
  Полностью определённое имя (т. е. `"databaseName.collectionName"`).
`filter` (array|object)
  » Предикат запроса. Пустой предикат совпадёт со всеми элементами коллекции.

  > Замечание: СУБД MongoDB при оценке критериев запроса сравнивает типы и значения по внутренним » правилам сравнения BSON-типов, которые не совпадают с правилами сравнения и жонглирования типами в PHP. При сопоставлении специального BSON-типа в запросе требуется передать объект BSON-класса, который соответствует типу BSON-значения, поэтому для сопоставления с BSON-типом » ObjectId указывают объект класса MongoDB\BSON\ObjectId.

`options`

  Опции
  Опция | Тип | Описание | Стандартное значение
  --- | --- | --- | ---
  collation | array|object | » Сопоставление позволяет пользователям указывать специфичные для конкретного языка правила для сравнения строк, такие как реакцию на регистр букв и надстрочные знаки. Если задали сопоставление, то поле `"locale"` также обязательно. Описание полей смотрите в разделе » Сопоставление. Если сопоставление не задали явно, но у коллекции определили сопоставление по умолчанию, то будет выбрано оно. Если нет ни того ни того, то MongoDB будет использовать простое бинарное сравнение строк. Эта опция доступна в MongoDB 3.4+ и, если будет использована для более старых версий, вызовет исключение во время исполнения.
  hint | string|array|object | Спецификация индекса. Опция указывает либо название индекса в виде строки, либо шаблон ключа индекса. При установке значения система запросов ограничит поиск только теми планами, которые выполняют сканирование через заданный индекс.

### Возвращаемые значения

Функция не возвращает значения после выполнения.

### Ошибки

- При ошибке парсинга аргумента метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException.

### Примеры

Пример #1 Пример добавления операции удаления методом MongoDB\Driver\BulkWriteCommand::deleteOne()

    <?php

    $manager = new MongoDB\Driver\Manager();

    $bulk = new MongoDB\Driver\BulkWriteCommand();
    $bulk->deleteOne('db.coll', ['x' => 1]);

    $result = $manager->executeBulkWriteCommand($bulk);

    ?>

### Смотрите также

- MongoDB\Driver\BulkWriteCommand::deleteMany() - Добавляет операцию deleteMany
- MongoDB\Driver\Manager::executeBulkWriteCommand() - Выполняет операции записи через команду bulkWrite
- MongoDB\Driver\BulkWriteCommandResult

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open