PHP: полный мануал с примерами, функциями и ООП

<?php
final class OrderLines implements IteratorAggregate, Countable
{
    public function __construct(private array $lines) {}

    public function getIterator(): Traversable
    {
        return new ArrayIterator($this->lines);
    }

    public function count(): int
    {
        return count($this->lines);
    }
}

$lines = new OrderLines(['Чай', 'Кофе']);
echo count($lines), " позиции\n";
foreach ($lines as $line) {
    echo '- ', $line, "\n";
}

2 позиции
- Чай
- Кофе

IteratorAggregate обещает getIterator(), а Countable — count(). PHP проверяет наличие совместимых методов. Интерфейс не хранит строки за объект: он задаёт контракт, который реализует класс.

<?php
final class ApiResult implements JsonSerializable
{
    public function __construct(
        private int $status,
        private array $data,
        private string $internalTraceId,
    ) {}

    public function jsonSerialize(): array
    {
        return ['status' => $this->status, 'data' => $this->data];
    }
}

$result = new ApiResult(200, ['orderId' => 17], 'trace-secret-42');
echo json_encode($result, JSON_THROW_ON_ERROR), "\n";

{"status":200,"data":{"orderId":17}}

json_encode() узнаёт договор JsonSerializable и вызывает jsonSerialize(). Класс сам определяет публичную форму ответа: обязательные данные выходят, а внутренний trace ID не раскрывается. Это практическая польза интерфейса — готовая функция PHP работает с вашим объектом через известный контракт.