list/list

A minimal set of functions for transforming lists using the PHP 8.5 pipe operator

v0.2.1 2026-03-27 10:26 UTC

Requires

• php: >=8.5

Requires (Dev)

• pestphp/pest: ^4.3
• phpstan/phpstan: ^2.1

MIT

• Christopher Kaster

Published on Packagist.org on 2026-03-27 10:23 UTC

README

A minimal set of functions for transforming lists using the PHP 8.5 pipe operator

<?php

use function List\filter;
use function List\map;
use function List\sort_list;
use function List\take;
use function List\unique;

$transactions = [
    ['id' => 1, 'user' => 'Alice', 'amount' => 600, 'cat' => 'Tech'],
    ['id' => 2, 'user' => 'Bob', 'amount' => 150, 'cat' => 'Tech'],
    ['id' => 3, 'user' => 'Alice', 'amount' => 700, 'cat' => 'Tech'],
    ['id' => 4, 'user' => 'Charlie', 'amount' => 800, 'cat' => 'Garden'],
    ['id' => 5, 'user' => 'Bob', 'amount' => 900, 'cat' => 'Tech'],
    ['id' => 6, 'user' => 'Alice', 'amount' => 50, 'cat' => 'Tech'],
];

$topTechUsers = $transactions
    |> filter(fn($t) => $t['cat'] === 'Tech')         // 1. Only Tech
    |> filter(fn($t) => $t['amount'] > 500)           // 2. High value only
    |> map(fn($t) => $t['user'])                      // 3. Just the names
    |> unique()                                       // 4. No duplicates
    |> sort_list(fn($a, $b) => strcmp($a, $b))        // 5. Alphabetical
    |> take(2);                                       // 6. Top 2

print_r($topTechUsers);

/* Output:
Array
(
    [0] => Alice
    [1] => Bob
)
*/

Install

$ composer require list/list

License

MIT