Search for document

- « Collection::existsInDatabase

- Collection::getName »

- PHP Manual
- mysql_xdevapi\Collection
- Search for document

# Collection::find

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

Collection::find — Search for document

### Description

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

Search a database collection for a document or set of documents. The found documents are returned as a CollectionFind object is to further modify or fetch results from.

### Parameters

`search_condition`

  Although optional, normally a condition is defined to limit the results to a subset of documents.

  Multiple elements might build the condition and the syntax supports parameter binding. The expression used as search condition must be a valid SQL expression. If no search condition is provided (field empty) then find('true') is assumed.

### Return Values

A CollectionFind object to verify the operation, or fetch the found documents.

### Examples

Example #1 mysql_xdevapi\Collection::find() example

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

The above example will output:

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