Files
putnamrec/vendor/tecnickcom/tc-lib-file/test/EmptyReadStreamWrapper.php
T
2026-08-20 11:41:17 +00:00

71 lines
1.9 KiB
PHP

<?php
/**
* EmptyReadStreamWrapper.php
*
* @since 2026-04-30
* @category Library
* @package File
* @author Nicola Asuni <info@tecnick.com>
* @copyright 2015-2026 Nicola Asuni - Tecnick.com LTD
* @license https://www.gnu.org/copyleft/lesser.html GNU-LGPL v3 (see LICENSE)
* @link https://github.com/tecnickcom/tc-lib-file
*
* This file is part of tc-lib-file software library.
*/
namespace Test;
/**
* A stream wrapper that returns initial data on the first read then returns
* empty strings on all subsequent reads while never signalling EOF via
* stream_eof(). This exercises the inner `break` in File::rfRead() that
* fires when fread() yields an empty string before the while-loop condition
* can detect EOF.
*/
class EmptyReadStreamWrapper
{
public mixed $context;
private string $initialData = 'ab';
private bool $initialRead = false;
// phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
public function stream_open(string $path, string $mode, int $options, ?string &$opened_path): bool
{
unset($path, $mode, $options, $opened_path);
return true;
}
// phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
public function stream_read(int $count): string
{
unset($count);
if (!$this->initialRead) {
$this->initialRead = true;
return $this->initialData;
}
// Return empty string while still claiming not at EOF so that the
// while-loop in rfRead() re-enters and hits the inner break.
return '';
}
// phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
public function stream_eof(): bool
{
// Never signal EOF — stream_read() will return '' instead.
return false;
}
/**
* @return array<string, mixed>
*/
// phpcs:ignore PSR1.Methods.CamelCapsMethodName.NotCamelCaps
public function stream_stat(): array
{
return [];
}
}