jakubboucek/php-tail-stream

PHP implementation of linux tail command, optimized for read huge size archives, effective memory usage.

v0.9.0 2024-10-17 03:32 UTC

Requires

• php: ^8.3

Requires (Dev)

• nette/tester: ^2.5

MIT

• Jakub Bouček

README

PHP implementation of the Linux tail command (display the last part of a file), optimized for reading huge size files with effective memory usage.

Installation

You can install the package via Composer:

composer require jakubboucek/php-tail-stream

and declare namespace:

use JakubBoucek\Tail\Tail;

Usage

Tail::lines(10)->fromFile('path/to/your/file.txt')->toOutput();

// Output the last 10 lines of the file

You can also read data from your stream:

$f = fopen('path/to/your/file.txt', 'rb');
Tail::lines(10)->fromStream($f)->toOutput();

// Output the last 10 lines from the stream

Note

Source stream MUST allow seeking! You can't use some stream types, like HTTP stream for example.

You can write result to file or another stream, use methods:

 ->toFile('path/to/your/output.txt'); // Write to file
 ->toStream($stream);                 // Write to stream 

License

The MIT License (MIT). Please see License File for more information.