OpenXE/classes/Components/Database/docs/yield_results.md

Datensätze abrufen mit Generatoren

Um den Arbeitsspeicherverbrauch gering zu halten bieten sich zum Iterieren von großen Datenmengen Generatoren an: https://www.php.net/manual/de/language.generators.overview.php

Die Database-Komponente stellt für diesen Zweck yield-Methoden zur Verfügung.

yieldAll()

Wie fetchAll(); jede Zeile ist ein assoziatives Array.

$statement = 'SELECT a.id, a.typ, a.name_de FROM artikel AS a WHERE a.typ = :typ LIMIT 2';
$bindValues = ['typ' => 'produkt'];

foreach ($db->yieldAll($statement, $bindValues) as $row) {
    var_dump($row);
}

array (size=3)
  'id' => int 2
  'typ' => string 'produkt' (length=7)
  'name_de' => string 'Sechskant-Mutter M10' (length=20)
  
array (size=3)
  'id' => int 3
  'typ' => string 'produkt' (length=7)
  'name_de' => string 'Schalthebel 20x10' (length=17)

yieldAssoc()

Wie fetchAssoc(); jede Zeile ist ein assoziatives Array; der Key beinhaltet den Wert der ersten Spalte

$statement = 'SELECT a.id, a.typ, a.name_de FROM artikel AS a WHERE a.typ = :typ LIMIT 2';
$bindValues = ['typ' => 'produkt'];

foreach ($db->yieldAssoc($statement, $bindValues) as $key => $row) {
    var_dump($key);
    var_dump($row);
}

int 2
array (size=3)
  'id' => int 2
  'typ' => string 'produkt' (length=7)
  'name_de' => string 'Sechskant-Mutter M10' (length=20)

int 3
array (size=3)
  'id' => int 3
  'typ' => string 'produkt' (length=7)
  'name_de' => string 'Schalthebel 20x10' (length=17)

yieldPairs()

Wie fetchPairs(); jede Zeile besteht aus Key-Value-Paaren; der Key beinhaltet den Inhalt der ersten Spalte; der Wert den Inhalt der zweiten Spalte.

Erwartet werden genau zwei Spalten, andernfalls wird eine Exception geworfen.

$statement = 'SELECT a.id, a.name_de FROM artikel AS a WHERE a.typ = :typ LIMIT 2';
$bindValues = ['typ' => 'produkt'];

foreach ($db->yieldPairs($statement, $bindValues) as $key => $value) {
    var_dump($key);
    var_dump($value);
}

int 2
string 'Sechskant-Mutter M10' (length=20)

int 3
string 'Schalthebel 20x10' (length=17)

yieldCol()

Wie fetchCol(); jede Zeile beinhaltet nur den Wert der ersten Spalte.

$statement = 'SELECT a.name_de FROM artikel AS a WHERE a.typ = :typ LIMIT 2';
$bindValues = ['typ' => 'produkt'];

foreach ($db->yieldCol($statement, $bindValues) as $key => $value) {
    var_dump($key);
    var_dump($value);
}

int 0
string 'Sechskant-Mutter M10' (length=20)

int 1
string 'Schalthebel 20x10' (length=17)