# Collection::find

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

Collection::find — Sucht 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
            )
    )

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