Generatoriai suteikia atminties efektyvų būdą iteruoti didelius duomenų rinkinius, gamindami reikšmes po vieną iš karto (lenivu būdu) naudojant yield raktažodį, vietoje to, kad iš karto sudarytumėte visą masyvą atmintyje. Jie yra idealūs didelems arba srautiniams duomenims.
{
= [];
( = ; < ; ++) { [] = ; }
;
}
{
( = ; < ; ++) {
;
}
}
(() ) {
();
}
yield daro funkciją generatoriumi: jis gamina reikšmes lenivu būdu, po vieną iteracijoje, išlaikydamas jos būseną tarp jų — todėl atmintis lieka pastovi, nepriklausomai nuo to, kiek reikšmių jis gamina.
function readLines(string $file): Generator {
$handle = fopen($file, 'r');
while (($line = fgets($handle)) !== false) {
yield $line; // yield one line at a time — never load the whole file
}
fclose($handle);
}
foreach (readLines('huge-10gb.csv') as $line) { // processes a 10GB file with tiny memory
process($line);
}
Skaitant didžiulį failą eilutę po eilutę su generatoriumi, naudojama pastovi atmintis — neįmanoma su file() (kuri įkelia visą failą į masyvą).
function fetchRows(PDOStatement $stmt): Generator {
while ($row = $stmt->fetch()) {
yield $row['id'] => $row; // yield key => value, streaming DB rows
}
}
Generatoriai yra puikūs duomenų bazės rezultatų srautinimui — apdoroti eilutes po vieną vietoje to, kad įkeltumėte didžiulį rezultatų rinkinį į atmintį.
Generatoriai yra svarbi PHP funkcija dėl atminties efektyvaus didelių duomenų rinkinių apdorojimo — ir juos suprasti yra brangus naudojant programas, kurios tvarko duomenis didelės apimties be atminties išsekimo.
Pagrindinė problema, kurią jie sprendžia, yra ta, kad sukuriant pilną didelių duomenų masyvą (milijonai įrašų, didžiulio failo eilutės, didelis duomenų bazės rezultatų rinkinys) gali suvartoti didžiulę atmintį ir nutraukti programą, tuo tarpu generatoriai gamina reikšmes lenivu būdu, po vieną iš karto, išlaikydami atmintį pastovią, nepriklausomai nuo duomenų rinkinio dydžio.
Praktiniausi ir dažniausi panaudojimo atvejai yra: didelių failų skaitymas eilutę po eilutę (apdorojant daugelio gigabaitų CSV arba žurnalo failą mažą atmintimi, neįmanoma su funkcijomis, kurios įkelia viską), duomenų bazės rezultatų srautinimas (apdoroti didelius užklausos rezultatus eilute po eilute) ir didžiulių arba begalinių sekų apdorojimas.
Suprasdami yield, lenivy vertinimą ir kada siekti generatorių (bet kada norėtumėte iš karto sukurti didelį masyvą atmintyje), galite rašyti masteliojamiausį duomenų apdorojimo kodą, kuris grakščiai tvarko didelius tūrius — dažnas realaus pasaulio poreikis paketo užduotyse, importuose/eksportuose, ataskaitų generavime ir duomenų srautovose.
Nors nereikalingi mažiems duomenų rinkiniams, generatoriai yra esminės žinios atminties sąmonės PHP, apdorojančios didelius kiekius duomenų, skiriančios kūrėjus, kurie gali sukurti masteliojamiausią duomenų tvarkymą, nuo tų, kurių programos žlunga arba sulėtėja su didelėmis darbo apkrovomis, todėl tai yra brangus aukštesnio lygio žinios dėl našumo jautri, duomenimis intensyvūs PHP programas.