PHP 8.4.2 Released!

Collection::find

(No version information available, might only be in Git)

Collection::findSucht nach Dokumenten

Beschreibung

public mysql_xdevapi\Collection::find(string $search_condition = ?): mysql_xdevapi\CollectionFind

Durchsucht eine Sammlung in einer Datenbank nach einem Dokument oder einer Gruppe von Dokumenten. Die gefundenen Dokumente werden als CollectionFind-Objekt zurückgegeben, das weiter bearbeitet werden kann oder aus dem Ergebnisse abgerufen werden können.

Parameter-Liste

search_condition

Obwohl optional, wird normalerweise eine Bedingung definiert, um die Ergebnisse auf eine Teilmenge von Dokumenten zu beschränken.

Die Bedingung kann aus mehreren Elementen zusammengesetzt sein, und die Syntax unterstützt die Parameterbindung. Der als Suchbedingung verwendete Ausdruck muss ein gültiger SQL-Ausdruck sein. Wird keine Suchbedingung angegeben (leeres Feld), wird find('true') angenommen.

Rückgabewerte

Ein CollectionFind-Objekt, um die Operation zu überprüfen, oder um die gefundenen Dokumente abzurufen.

Beispiele

Beispiel #1 mysql_xdevapi\Collection::find()-Beispiel

<?php
$session
= mysql_xdevapi\getSession("mysqlx://user:password@localhost");

$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();

$schema = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");

$collection->add('{"name": "Alfred", "age": 18, "job": "Butler"}')->execute();
$collection->add('{"name": "Bob", "age": 19, "job": "Swimmer"}')->execute();
$collection->add('{"name": "Fred", "age": 20, "job": "Construction"}')->execute();
$collection->add('{"name": "Wilma", "age": 21, "job": "Teacher"}')->execute();
$collection->add('{"name": "Suki", "age": 22, "job": "Teacher"}')->execute();

$find = $collection->find('job LIKE :job AND age > :age');
$result = $find
->bind(['job' => 'Teacher', 'age' => 20])
->
sort('age DESC')
->
limit(2)
->
execute();

print_r($result->fetchAll());
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [0] => Array
        (
            [_id] => 00005b6b536100000000000000a8
            [age] => 22
            [job] => Teacher
            [name] => Suki
        )
    [1] => Array
        (
            [_id] => 00005b6b536100000000000000a7
            [age] => 21
            [job] => Teacher
            [name] => Wilma
        )
)
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top