Collection::getOne

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#

Collection::getOne

Devuelve un documento

Descripción#

public mysql_xdevapi\Collection::getOne(string $id): Document
```php

Recupera un documento de la colección.

Esto es un atajo para: `Collection.find("_id = :id").bind("id", id).execute().fetchOne();`

## Parámetros

`id`  
El \_id del documento en la colección.

## Valores devueltos

El objeto colección, o `null` si el \_id no corresponde a un documento.

## Ejemplos

Ejemplo de `mysql_xdevapi\Collection::getOne`

sql("DROP DATABASE IF EXISTS addressbook")->execute(); $session->sql("CREATE DATABASE addressbook")->execute(); $schema = $session->getSchema("addressbook"); $collection = $schema->createCollection("people"); $result = $collection->add('{"name": "Alfred", "age": 42, "job": "Butler"}')->execute(); // Un identificador único _id (por omisión, y recomendado) es generado por MySQL Server // Esto recupera los _id generados; uno solo en este ejemplo, por lo tanto $ids[0] $ids = $result->getGeneratedIds(); $alfreds_id = $ids[0]; // ... print_r($alfreds_id); print_r($collection->getOne($alfreds_id)); ?>

```php

Resultado del ejemplo anterior es similar a:

00005b6b536100000000000000b1

Array
(
    [_id] => 00005b6b536100000000000000b1
    [age] => 42
    [job] => Butler
    [name] => Alfred
)