array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'mongodb-driver-bulkwritecommand.deleteone.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::deleteOne', 2 => 'Add a deleteOne operation', ), 'up' => array ( 0 => 'class.mongodb-driver-bulkwritecommand.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand', ), 'prev' => array ( 0 => 'mongodb-driver-bulkwritecommand.deletemany.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::deleteMany', ), 'next' => array ( 0 => 'mongodb-driver-bulkwritecommand.insertone.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::insertOne', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/mongodb/mongodb/driver/bulkwritecommand/deleteone.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\Driver\BulkWriteCommand::deleteOne

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommand::deleteOne — Add a deleteOne operation

Опис

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

Add a deleteOne operation to the MongoDB\Driver\BulkWriteCommand. The first document matching filter in the collection identified by namespace will be deleted.

Параметри

namespace (string)

Повна назва простору імен (напр. "databaseName.collectionName").

filter (array|object)

» Предикат запиту. Порожній предикат відповідає всім документам у колекції.

Зауваження: Під час виконання критеріїв запиту MongoDB порівнює типи та значення за власними » правилами порівняння BSON-типів, що відрізняється від правил порівняння і перетворення типів в PHP. Для вибірки даних спеціальних BSON-типів, критерії запиту повинні використовувати відповідний клас BSON (напр. MongoDB\BSON\ObjectId для вибірки » ObjectId).

options

options
Option Type Description Default
collation array|object

» Зіставлення дозволяє вказувати специфічні для мови правила порівняння рядків, як от правила регістру та знаків наголосу. Під час визначення зіставлень поле "locale" є обов'язковим, а всі інші поля — ні. Опис полів є на сторінці » Документ зіставлення.

Якщо зіставлення не вказано, то використовується стандартне зіставлення для колекції, якщо воно вказано. Якщо ж ні, MongoDB використовує просте двійкове порівняння, яке використовувалося в попередніх версіях для порівняння рядків.

Цей параметр доступний у MongoDB 3.4+, тож його застосування у старіших версіях викине виключення під час виконання.

hint string|array|object

Index specification. Specify either the index name as a string or the index key pattern. If specified, then the query system will only consider plans using the hinted index.

Значення, що повертаються

Не повертає значень.

Помилки/виключення

Приклади

Приклад #1 MongoDB\Driver\BulkWriteCommand::deleteOne() example

<?php

$manager = new MongoDB\Driver\Manager;

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

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

?>

Прогляньте також