error_handle.php

<?php

declare(strict_types=1);

namespace Psl\IO;

use Revolt\EventLoop;
use WeakMap;

use const PHP_SAPI;

/**
 * Return the output handle for the current request.
 *
 * This should generally be used for sending data to clients. In CLI mode, this
 * is usually the process STDOUT.
 *
 * @codeCoverageIgnore
 */
function error_handle(): null|CloseWriteStreamHandleInterface
{
    /** @var WeakMap|null $cache */
    static $cache = null;
    if (null === $cache) {
        $cache = new WeakMap();
    }

    $key = EventLoop::getDriver();
    if ($cache->offsetExists($key)) {
        /** @var CloseWriteStreamHandleInterface|null */
        return $cache->offsetGet($key);
    }

    $handle = null;
    if (PHP_SAPI === 'cli') {
        $handle = new CloseWriteStreamHandle(Internal\open_resource('php://stderr', 'wb'));
    }

    $cache->offsetSet($key, $handle);

    return $handle;
}