fast-forward/iterators

A robust and optimized library for advanced PHP Iterators.

v1.2.0 2026-03-31 14:55 UTC

Requires

• php: ^8.3

Requires (Dev)

• fast-forward/dev-tools: dev-main

MIT

• Felipe Sayão Lobato Abreu

• php
• iterators
• iterator utilities
• iterator aggregate
• iterator iterator
• fast-forward

README

A robust and optimized library for advanced PHP Iterators.

Enhance your PHP applications with high-performance iterators: lookahead, peeking, filtering, grouping, chunking, and more.

✨ Features

• 🔁 Advanced and composable iterator types
• 👀 Lookahead and peeking support
• 🧼 Filtering and mapping
• 🧩 Grouping, chunking, and flattening
• 🧪 Fully tested, mutation safe, and statically analyzed

📦 Installation

Install via Composer:

composer require php-fast-forward/iterators

Requirements: PHP 8.3 or higher

🚀 Quickstart

use FastForward\Iterator\ChunkedIteratorAggregate;

$data = range(1, 10);
$chunked = new ChunkedIteratorAggregate($data, 3);
foreach ($chunked as $chunk) {
	print_r($chunk);
}

Expected output:

Array
(
	[0] => 1
	[1] => 2
	[2] => 3
)
Array
(
	[0] => 4
	[1] => 5
	[2] => 6
)
Array
(
	[0] => 7
	[1] => 8
	[2] => 9
)
Array
(
	[0] => 10
)

🛠 Usage Patterns

All iterators and utilities are available under the FastForward\Iterator namespace. Simply require Composer's autoloader:

require_once 'vendor/autoload.php';
use FastForward\Iterator\ChunkedIteratorAggregate;
use FastForward\Iterator\SlidingWindowIteratorIterator;
// ...

You can chain, compose, and adapt iterators for a wide variety of data processing tasks.

📚 Documentation & Examples

• 📖 Full Documentation
• 🧑‍💻 Examples Directory
  • Each file demonstrates a specific iterator or pattern:
    • chunked-iterator-aggregate.php
    • sliding-window-iterator-iterator.php
    • unique-iterator-iterator.php
    • lookahead-iterator.php
    • ...and more!

🤝 Contributing

Contributions, bug reports and suggestions are welcome! Please open an issue or pull request on GitHub.

🧑‍💻 Author

Felipe Sayão Lobato Abreu
[e-mail]

📄 License

This project is licensed under the MIT License.