Fatal error: Class Colectie must implement interface Traversable as part of either Iterator or IteratorAggregate in Unknown on line 0
Ai scris class Colectie implements Traversable. Traversable nu se implementează direct: e doar „eticheta” obiectelor care pot fi parcurse cu foreach. Implementează IteratorAggregate (cu metoda getIterator()) sau Iterator (cu current, key, next, rewind, valid).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Traversable e interfața comună a tot ce se poate parcurge cu foreach. PHP o folosește pentru verificări ($x instanceof Traversable, tipul iterable), dar nu te lasă s-o implementezi direct, pentru că nu are metode: PHP n-ar ști cum să-ți parcurgă obiectul.
Ai la dispoziție două interfețe concrete care o extind:
IteratorAggregate: scrii o singură metodă,getIterator(): Iterator, care întoarce de obiceinew ArrayIterator($this->elemente)sau un generator (yield). E alegerea simplă pentru colecții.Iterator: scrii singur cele cinci metode (current,key,next,rewind,valid). Util când parcurgerea are logică proprie.
Mesajul arată in Unknown on line 0 pentru că verificarea se face când clasa e înregistrată, nu la o linie anume. Caută în proiect implements Traversable.
De ce apare: cauzele frecvente
1Traversable implementat direct
<?php
class Colectie implements Traversable {
private array $elemente = [];
}<?php
class Colectie implements IteratorAggregate {
private array $elemente = [];
public function getIterator(): Iterator {
return new ArrayIterator($this->elemente);
}
}IteratorAggregate extinde Traversable, deci obiectul poate fi parcurs cu foreach.
2Cu un generator
<?php
class Raport implements Traversable {
public function __construct(private array $randuri) {}
}<?php
class Raport implements IteratorAggregate {
public function __construct(private array $randuri) {}
public function getIterator(): Generator {
foreach ($this->randuri as $i => $r) {
yield $i + 1 => $r;
}
}
}Un generator e un Iterator, deci poate fi întors direct de getIterator().
3Interfață proprie care extinde Traversable
<?php
interface Colectie extends Traversable {}
class Lista implements Colectie {}<?php
interface Colectie extends IteratorAggregate {}
class Lista implements Colectie {
public function getIterator(): Iterator { return new ArrayIterator([]); }
}O interfață poate extinde Traversable, dar clasa care o implementează trebuie să implementeze și Iterator sau IteratorAggregate.
Repară eroarea, direct în pagină
Clasa Cos trebuie să poată fi parcursă cu foreach, dar fișierul dă Fatal error: Class Cos must implement interface Traversable as part of either Iterator or IteratorAggregate. Folosește IteratorAggregate și metoda getIterator(): Iterator (cu ArrayIterator), ca programul să afișeze Pix: 4.5 și Cană: 29.9.
<?php
class Cos implements Traversable
{
private array $produse = [];
public function adauga(string $nume, float $pret): void
{
$this->produse[$nume] = $pret;
}
}
$cos = new Cos();
$cos->adauga('Pix', 4.5);
$cos->adauga('Cană', 29.9);
foreach ($cos as $nume => $pret) {
echo "$nume: $pret\n";
}Pix: 4.5 Cană: 29.9
Indiciu
Schimbă implements Traversable în implements IteratorAggregate și adaugă getIterator().
Reparația
<?php
class Cos implements IteratorAggregate
{
private array $produse = [];
public function adauga(string $nume, float $pret): void
{
$this->produse[$nume] = $pret;
}
public function getIterator(): Iterator
{
return new ArrayIterator($this->produse);
}
}
$cos = new Cos();
$cos->adauga('Pix', 4.5);
$cos->adauga('Cană', 29.9);
foreach ($cos as $nume => $pret) {
echo "$nume: $pret\n";
}De ce merge
Traversable nu are metode, deci PHP n-ar avea cum să știe ce să dea la fiecare pas din foreach. De aceea nu poate fi implementată direct.
IteratorAggregate cere o singură metodă, getIterator(). foreach o apelează și parcurge iteratorul primit: ArrayIterator peste tabloul privat de produse dă cheile (numele) și valorile (prețurile), în ordinea adăugării.
Alte forme ale mesajului
Fatal error: Class Lista must implement interface Traversable as part of either Iterator or IteratorAggregate in Unknown on line 0
Cum o eviți pe viitor
- Pentru colecții, pornește cu
IteratorAggregateșiArrayIterator: e varianta cea mai scurtă. - Pune tipul de retur exact (
getIterator(): IteratorsauTraversable), altfel primești Deprecated la compatibilitatea cu interfața. - Folosește
Traversablesauiterabledoar ca tip al parametrilor (function afiseaza(iterable $x)), nu înimplements. - Dacă vrei și
count($colectie), implementează în plusCountable.
Întrebări frecvente
Iterator sau IteratorAggregate?
IteratorAggregate când ai deja datele într-un tablou sau le poți da cu yield: o metodă și gata. Iterator când vrei control total asupra fiecărui pas, de exemplu citire pe bucăți dintr-o sursă externă.
De ce on line 0?
Verificarea se face la înregistrarea clasei, într-un loc din motorul PHP care nu ține de o linie din codul tău. Numele clasei din mesaj e indiciul de căutare.
Erori înrudite
Deprecated: Return type of Colectie::getIterator() should either be compatible with IteratorAggregate::getIterator(): Traversable, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in index.php on line 9 Clasa ta implementează o interfață din PHP (IteratorAggregate, Countable, ArrayAccess, JsonSerializable, Iterator), dar metoda nu are tipul de retur cerut din PHP 8.1. Adaugă tipul din mesaj: public function getIterator(): Traversable, count(): int, jsonSerialize(): mixed. Atributul #[\ReturnTypeWillChange] doar ascunde mesajul. Fatal error: Class Cerc contains 1 abstract method and must therefore be declared abstract or implement the remaining methods (Forma::arie) in index.php on line 7 Clasa moștenește o clasă abstractă sau implementează o interfață, dar nu scrie una dintre metodele cerute (cea din paranteză, de exemplu Forma::arie). Implementează metoda, cu aceeași semnătură, în clasă. Warning: foreach() argument must be of type array|object, null given in index.php on line 4 Dai lui foreach o valoare care nu e tablou sau obiect, de obicei null (o cheie lipsă sau o funcție care n-a întors nimic). Asigură-te că variabila e un tablou, de exemplu cu foreach ($x ?? [] as ...). Învață PHP de la zero, cu exerciții la fiecare lecție
Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
