Code Coverage for /workspace/celema/core/src/Emitter/Fallback.php

1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celema\Core\Emitter;
6
7	use Psr\Http\Message\ResponseInterface as Response;
8	use Throwable;
9
10	/**
11	* Last resort for a request that failed outside the error handler.
12	*
13	* @internal
14	*/
15	final class Fallback
16	{
17	/**
18	* Emits the response if nothing was sent yet. Output buffers the request
19	* opened are discarded first. If the emitter still fails, for example
20	* because the request wrote output into a buffer it did not open or one
21	* that cannot be cleaned, the status is set to 500 when possible and
22	* that output becomes the body.
23	*/
24	public static function emit(
25	Emitter $emitter,
26	Response $response,
27	int $bufferLevel,
28	bool $withoutBody = false,
29	): void {
30	self::discardBuffers($bufferLevel);
31
32	try {
33	$emitter->emit($response, $withoutBody);
34	} catch (Throwable) {
35	if (!headers_sent()) {
36	http_response_code($response->getStatusCode());
37	}
38	}
39	}
40
41	/**
42	* A buffer opened without the removable flag cannot be ended:
43	* ob_end_clean() fails and leaves it in place. The cleanup stops there,
44	* after discarding its output if allowed, and the response goes into
45	* that buffer, which PHP sends when the request ends.
46	*/
47	private static function discardBuffers(int $bufferLevel): void
48	{
49	while (ob_get_level() > $bufferLevel) {
50	$flags = (int) (ob_get_status()['flags'] ?? 0);
51
52	if (($flags & PHP_OUTPUT_HANDLER_REMOVABLE) === 0) {
53	if (($flags & PHP_OUTPUT_HANDLER_CLEANABLE) !== 0) {
54	ob_clean();
55	}
56
57	return;
58	}
59
60	ob_end_clean();
61	}
62	}
63	}