Упрощаем тесты с участием файлов

Представим, что мы написали функцию parseCSVFile, которая принимает путь до CSV-файла и возвращает распарсенные данные в удобном нам формате. Как её протестировать?

Первая мысль — написать несколько CSV-файликов, положить их рядом с тестом, а в самом тесте сравнить результат их парсинга с ожидаемыми значениями. Очень просто, но неудобно: тест разбросан по нескольким файлам, сложно читать и вносить изменения.

Вторая мысль — mikey179/vfsstream. Это пакет, который позволяет налету в памяти создавать файловую систему и взаимодействовать с ней как с реальной. Круто, но для тестирования нашей простенькой функции слишком мощно.

А теперь третий вариант, оптимальный. В PHP есть data stream wrapper (а-ля RFC 2397), который позволяет инлайнить содержимое файла прямо в "путь". Формула проста: data://{MIME-тип},{Содержимое}. В итоге тест будет выглядеть так:

$csv = <<<'CSV'
    data://text/csv,PHP Version,2022-01,2022-07,2023-01,2023-07
    8.0,23.9%,20.6%,16.2%,12.3%
    8.1,9.1%,24.5%,38.8%,39.3%
    8.2,0.0%,0.0%,4.7%,17.2%
    CSV;
$expected = [...];

$parsed = parseCSVFile($csv);

self::assertSame($expected, $parsed);

https://www.php.net/manual/ru/wrappers.data.php