Temporary

use Innmind\IO\IO;
use Innmind\Immutable\{
    Sequence,
    Str,
};

$temporary = IO::fromAmbientAuthority()
    ->files()
    ->temporary(Sequence::of(
        Str::of('chunk 1'),
        Str::of("new line \n"),
        Str::of('chunk 2'),
        Str::of('etc...'),
    ))
    ->unwrap();

This creates a temporary file without having to think about where to store it.

You can then use it in 2 ways:

Like a normal fileChunk by chunk

$temporary
    ->read()
    ->chunks(8192);
// or
$temporary
    ->read()
    ->lines();

$pull = $temporary->pull();

do {
    $chunk = $pull
        ->chunk(512)
        ->unwrap();
    doSomething($chunk);
} while (!$chunk->empty());

The call to ->chunk() is stateful as it remembers the position in the file. This means that you can only read forward, and only once.

Once you're down working with the file you can close it like this:

$temporary->close()->unwrap();

Incremental file creation

When bridging this library with a more imperative API, using the Sequence to declare the chunks of the temporary file may not be possible.

Info

This is the case with the curl extension for example.

In this case you need to use the push strategy:

use Innmind\IO\IO;
use Innmind\Immutable\{
    Sequence,
    Str,
    SideEffect,
};

$temporary = IO::fromAmbientAuthority()
    ->files()
    ->temporary(Sequence::of())
    ->unwrap();

someImperativeAPI(
    static fn(Str $chunk): SideEffect => $temporary
        ->push()
        ->chunk($chunk)
        ->unwrap(),
);