CollectionModify::bind

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

En esta página

Descripción#

Liga un valor a un parámetro de consulta

Descripción#

public mysql_xdevapi\CollectionModify::bind(array $placeholder_values): mysql_xdevapi\CollectionModify
```php

Liga un parámetro a un espacio reservado en la condición de búsqueda de la operación de modificación.

El espacio reservado tiene la forma de :NOMBRE donde ':' es un prefijo común que siempre debe existir antes de cualquier NOMBRE donde NOMBRE es el nombre del espacio reservado. El método bind acepta una lista de espacios reservados si varias entidades deben ser sustituidas en la condición de búsqueda de la operación de modificación.

## Parámetros

`placeholder_values`  
Los valores de espacio reservado a sustituir en la condición de búsqueda. Se permiten varios valores y deben ser pasados en forma de array de mapeos NOMBRE_ESPACIO_RESERVADO-\>VALOR_ESPACIO_RESERVADO.

## Valores devueltos

Un objeto CollectionModify que puede ser utilizado para ejecutar el comando, o para añadir operaciones adicionales.

## Ejemplos

Ejemplo de `mysql_xdevapi\CollectionModify::bind`

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": "Bernie", "traits": ["Friend", "Brother", "Human"]}') ->execute(); $collection ->modify("name = :name") ->bind(['name' => 'Bernie']) ->arrayAppend('traits', 'Happy') ->execute(); $result = $collection ->find() ->execute(); print_r($result->fetchAll()); ?>

```php

Resultado del ejemplo anterior es similar a:

Array
(
    [0] => Array
        (
            [_id] => 00005b6b53610000000000000110
            [name] => Bernie
            [traits] => Array
                (
                    [0] => Friend
                    [1] => Brother
                    [2] => Human
                    [3] => Happy
                )
        )
)