Recherche de document

# Collection::find

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

Collection::find — Recherche de document

### Description

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

Recherche une collection de base de données pour un document ou un ensemble de documents. Les documents trouvés sont retournés sous forme d'un objet CollectionFind pour les modifier ou récupérer des résultats supplémentaires.

### Liste de paramètres

`search_condition`

  Bien que facultative, normalement une condition est définie pour limiter les résultats à un sous-ensemble de documents.

  Plusieurs éléments peuvent construire la condition et la syntaxe supporte la liaison de paramètres. L'expression utilisée comme condition de recherche doit être une expression SQL valide. Si aucune condition de recherche n'est fournie (champ vide) alors find('true') est supposé.

### Valeurs de retour

Un objet CollectionFind pour vérifier l'opération, ou récupérer les documents trouvés.

### Exemples

Exemple #1 Exemple de mysql_xdevapi\Collection::find()

    <?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());
    ?>

L'exemple ci-dessus va afficher :

    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