...
Eroare PHP · Clase și obiecte

Fatal error: Class Colectie must implement interface Traversable as part of either Iterator or IteratorAggregate in Unknown on line 0

Pe scurt

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 obicei new 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

Greșit
PHP
<?php
class Colectie implements Traversable {
    private array $elemente = [];
}
Corect
PHP
<?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

Greșit
PHP
<?php
class Raport implements Traversable {
    public function __construct(private array $randuri) {}
}
Corect
PHP
<?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

Greșit
PHP
<?php
interface Colectie extends Traversable {}
class Lista implements Colectie {}
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
}
După reparație, programul afișează
Pix: 4.5
Cană: 29.9
Indiciu

Schimbă implements Traversable în implements IteratorAggregate și adaugă getIterator().

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 și ArrayIterator: e varianta cea mai scurtă.
  • Pune tipul de retur exact (getIterator(): Iterator sau Traversable), altfel primești Deprecated la compatibilitatea cu interfața.
  • Folosește Traversable sau iterable doar ca tip al parametrilor (function afiseaza(iterable $x)), nu în implements.
  • Dacă vrei și count($colectie), implementează în plus Countable.

Î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

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.