CollectionModify::bind

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

CollectionModify::bind — Bindet einen Wert an einen Platzhalter einer Abfrage

Beschreibung

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

Bindet einen Parameter an einen Platzhalter in der Suchbedingung einer Änderungsoperation.

Der Platzhalter hat die Form :NAME, wobei ":" ein gewöhnliches Präfix ist, das immer vor NAME, dem Namen des Platzhalters, stehen muss. Für den Fall, dass mehrere Entitäten in der Suchbedingung der Änderungsoperation ersetzt werden müssen, akzeptiert die bind-Methode auch eine Liste von Platzhaltern.

Parameter-Liste

placeholder_values: Die Werte der Platzhalter, die in der Suchbedingung ersetzt werden sollen. Es sind mehrere Werte erlaubt, die als Array von Zuordnungen der Form PLATZHALTER_NAME->PLATZHALTER_WERT übergeben werden müssen.

Rückgabewerte

Gibt ein CollectionModify-Objekt zurück, das verwendet werden kann, um den Befehl auszuführen oder um weitere Operationen hinzuzufügen.

Beispiele

Beispiel #1 mysql_xdevapi\CollectionModify::bind()-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");

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

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

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