test_iterator.php

<?php
/**
 * Результат:
 * Тестовый текст с тегом 1,
 * Итак, счётчик 2, 3 - 4
 * И ещё 5
 * 6
 */

$text = <<<TEXT
Тестовый текст с тегом [iterator],
Итак, счётчик [iterator], [iterator] - [iterator]
И ещё [iterator]
[iterator]
TEXT;

$generator = (function () {
    $i = 0;
    while (true) {
        $i++;

        yield $i;
    }
})();

$text = preg_replace_callback(
    '/\[iterator\]/i',
    function ($matches) use ($generator) {
        $cnt = $generator->current();
        $generator->next();

        return $cnt;
    },
    $text
);

echo $text . PHP_EOL;